Skip to content

Latest commit

 

History

History
177 lines (131 loc) · 7.86 KB

affected_people.md

File metadata and controls

177 lines (131 loc) · 7.86 KB

Affected People


Internally-Displaced Persons

The data for this sub-category is taken from the International Organization for Migration (IOM)'s displacement tracking matrix (DTM), which collects and analyzes data on population movements, displacements, and mobility patterns to provide timely information for humanitarian response efforts. The DTM data used in HAPI is taken from their publicly accessible API, however we note that there are many country-specific DTM datasets available on HDX, which contain more detail and disaggregation.

Summary

{{ read_yaml('data_usage_guides/subcategory_details/idps_details.yaml') }}

Parameters Returned

The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.

{{ read_yaml('data_usage_guides/endpoint_parameters/idps_parameters.yaml') }}

Transformations applied

None

Usage notes

  • To obtain the number of IDPs per year in a given location, only the most recent reporting round per operation should be aggregated

Refugees & Persons of Concern

This sub-category is populated using data compiled by UNHCR, which offers annual age- and gender-disaggregated global statistics on forcibly displaced and stateless persons, categorised by their country of origin and country of asylum. The data are sourced primarily from governments hosting these populations, UNHCR's own registration data, and occasionally data published by non-governmental organizations.

Summary

{{ read_yaml('data_usage_guides/subcategory_details/refugees_and_returnees_details.yaml') }}

Parameters Returned

The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.

{{ read_yaml('data_usage_guides/endpoint_parameters/refugees_and_returnees_parameters.yaml') }}

Transformations applied

  • As this endpoint only concerns refugees and people of concern, and not IDPs or returnees, we only include statistics from the population groups "REF", "ROC", "ASY", "OIP", "IOC", "STA", "OOC", "HST", "RST", and "NAT"
  • The table has been reshaped from wide to long: demographic-specific columns have been cast to gender, age_range, and population
  • It is not possible to p-code based on the location information in the original data, therefore population numbers are aggregated to the national level
  • The reference period is constructed using the full range of the year presented in the “Year” column of the original data

Usage notes

  • Not all of the possible population groups are necessarily found in the UNHCR data
  • An “all” value in the gender and age_range columns indicates no disaggregation
  • age_range is expressed as "[min_age]-[max_age]", where max_age is inclusive, or "[min_age]+" for an age range starting at min_age or above

Returnees

This sub-category is populated using data compiled by UNHCR, which offers annual age- and gender-disaggregated global statistics on forcibly displaced and stateless persons, categorised by their country of origin and country of asylum. The data are sourced primarily from governments hosting these populations, UNHCR's own registration data, and occasionally data published by non-governmental organizations.

Summary

{{ read_yaml('data_usage_guides/subcategory_details/refugees_and_returnees_details.yaml') }}

Parameters Returned

The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.

{{ read_yaml('data_usage_guides/endpoint_parameters/refugees_and_returnees_parameters.yaml') }}

Transformations applied

  • As this endpoint only concerns returnees and not the other population groups available in the UNHCR data, we only include statistics from the "RET" and "RDP" population groups
  • The table has been reshaped from wide to long: demographic-specific columns have been cast to gender, age_range, and population
  • It is not possible to p-code based on the location information in the original data, therefore population numbers are aggregated to the national level
  • The reference period is constructed using the full range of the year presented in the “Year” column of the original data

Usage notes

  • UNHCR is the only source for returnees in some countries and is therefore included in HDX HAPI, but if data is available from IOM, that data is preferable
  • An “all” value in the gender and age_range columns indicates no disaggregation
  • age_range is expressed as "[min_age]-[max_age]", where max_age is inclusive, or "[min_age]+" for an age range starting at min_age or above

Humanitarian Needs

This Humanitarian Needs Overview (HNO) represents the shared understanding of OCHA Humanitarian Country Teams of people's widespread emergency needs during crises. It includes an estimate of the number of people by sector who require assistance, often referred to as People in Need (PIN), which is derived using the Joint Intersectoral Analysis Framework (JIAF).

While the HNO data is directly available on HDX, it comes from different OCHA offices and is currently not standardised. Thus, HDX HAPI obtains the PIN numbers from the HPC Tools API-based datasets on HDX.

Summary

{{ read_yaml('data_usage_guides/subcategory_details/humanitarian_needs_details.yaml') }}

Parameters Returned

The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.

{{ read_yaml('data_usage_guides/endpoint_parameters/humanitarian_needs_parameters.yaml') }}

Transformations applied

  • The table has been reshaped from wide to long: the columns in the original data of "population", "in-need", "targeted", "affected", "reached", and "population" have been cast to a single population_status field, and renamed to "all", "INN", "TGT", "AFF", and "REA", respectively
  • Sector values of “ALL” have been converted to “intersectoral”, as these represent the intersectoral PIN and not the disaggregated population
  • Gender and disabled values of “a” have been converted to “all”
  • The methodology in Yemen leads to negative population values in some admin 2 level areas. Where negative values appear they have been omitted from the API.
  • The reference period is obtained from the HDX dataset

Usage notes

  • The PIN should not be summed across sectors or population statuses, as the same people can be present across multiple groups
  • For the number of people affected across all sectors, please use the PIN value where sector=intersectoral.
  • An “all” value in the gender, age_range, disable_marker, and population_group columns indicates no disaggregation