Changelog • humind

humind 2024.1.4

This release covers bug fixes, documentation updates, changes to parameters, and additional enhancements:

Documentation updates to better describe function purpose, outputs, and prerequisite functions.
Functions no lover use _levels but instead use separate parameters. (#547)
add_comp_wash() per the MSNI framework, the function was updated for the urban categorization “basic which should be score 1 instead of score 2 (#558)
add_comp_edu() updates to show comp_edu_score_disrupted as 3 if displaced_n is greater than 0, instead of greater than 1.(#556)
add_comp_health() updated so that households with at least one person with a disability have the value 3 for comp_health_score (#550)
add_loop_edu_ind_age_corrected() updated to allow custom starting age for education analysis based on country-specific requirements (#549)
add_comp_snfi() now correctly categorizes “other”” for snfi_shelter_issue_cat (#545)
add_loop_edu_ind_age_corrected() function error message added for date formats not in the ISO 8601 format (#513)

This release covers bug fixes.

comp_edu_score_attendance() now categorizes households correctly when children are not attending school and no protection issue was faced. (#532)
add_shelter_issue_cat() do not add -999 or -998 when the shelter issue is Don’t know or Prefer not to answer (it keeps NAs) and “Other” is categorized as others and not undefined. (#534)
add_comp_snfi() default values were fixed in documentation. (#535)
add_drinking_water_time_threshold_cat(): corrected input parameters “under_30min” and “above_30min”. (#539)
add_comp_wash(): corrected assigned severities for comp_wash_score_sanitation among HHs in camps. (#536)

This release covers a hot patch, a new function, and enhancements.

add_sanitation_facility_jmp_cat() now correctly handles the cases when the sanitation facility is improved and not shared (#522)
A marvelous new function add_quantile_interval() now allows to add (weighted) quantile intervals columns for any numeric variables (#516), for instance for adding income quantiles.
Some bug fixes for add_loop_healthcare_needed_cat_to_main() and add_loop_edu_disrupted_d_to_main when datasets do not name UUI columns “uuid” (#517).
add_age_cat() has more intuitive breaks due to a fix and improvement of num_cat(). To be able to get the following thresholds: 0-17, 18-59, 60-119, 120+, you can write add_age_cat("resp_age", breaks = c(0, 18, 60, 120)) (#504). Default breaks also changed to the aforementioned ones.
If occupation by armed groups was not added in country due to relevancy, add_loop_edu_disrupted_d() and add_loop_edu_disrupted_d_to_main(), occupation can be set to NULL.

This release covers mostly hot patches on a few bugs.

For perceived protection risks, add_comp_prot() assigns the score of 1 to a severity level. (#514)
add_msni() now correctly handles metrics 3 and 4, adding a missing value when the household is not in need (#509, #510)
add_comp_wash has some minor refinements. (#507)
For total income, loans to friends and from assistance should not be considered. Function add_income_source_prop() now has these two parameters as NULL by default. It is still possible to include them. (#506)

Provides functions to compose usual humanitarian composite indicators related to IMPACT Multi-Sector Needs Assessments (MSNAs). Such as:

The package follows the ‘Step-Composition’ approach of IMPACT R framework.

Expect many breaking changes as we are moving towards a more consistent and coherent package for 2024 MSNAs
Food security indicators will be imported from impactR4PHU, potentially all Public Health functions.

Breaking change: drinking_water_quantity() now recodes the frequencies of days without drinking water, while drinking_water_quantity_score() assigns a score on a 5-point scale.
Added: time_to_fetch_water_int_char() and time_to_fetch_water_combine() to recode and combine both variables for the time to fetch water.

Bug fix and breaking change: handwashing_facility() now recodes the types of handwashing facility.
Added: handwashing_facility_score() which calculates a score on a 2-point scale based on handwashing_facility()

Breaking changes: revamp of all water sources and sanitation facilities fonctions with the same approach as the food security functions.
Added: drinking_water_source() recodes the types of water sources, time_to_fetch_water() the time to fetch water according to a chosen threshold, and drinking_water_source_score() classify each household/individual on a 5-point scale.
Added: sanitation_facility() recodes the types of sanitation facilities, sharing_sanitation_facility() recodes the number of people sharing the sanitation facility, and sanitation_facility_score() classify each household on a 5-point scale.