Skip to content

Reference standards

pyfies.standards

Reference standards for equating country FIES scales to a common metric.

The FAO 2014-2016 global standard is the canonical reference scale for SDG indicator 2.1.2. Item severities below are taken from the values hardcoded in RM.weights::equating.fun (Cafiero, Viviani, Nord, 2018), which were estimated from pooled Gallup World Poll data over 2014-2016.

FAO_2014_2016 module-attribute 

FAO_2014_2016 = ReferenceStandard(name='FAO 2014-2016 global standard', items=DEFAULT_FIES_ITEMS, severities=_FAO_2014_2016_SEVERITIES, moderate_or_severe_threshold=float(_FAO_2014_2016_SEVERITIES[4]), severe_threshold=float(_FAO_2014_2016_SEVERITIES[7]))

FAO's 2014-2016 global FIES standard (the SDG 2.1.2 reference metric).

ReferenceStandard dataclass

A reference scale of item severities used as the target for equating.

Attributes:

Name Type Description
name str

Human-readable identifier for the standard.
items tuple[str, ...]

Names of the items, in the order matching severities.
severities ndarray

Item severity parameters on the standard's latent metric.
moderate_or_severe_threshold float

Latent-trait threshold (item severity) above which respondents are classified as moderately-or-severely food insecure. Defaults to the severity of item 5.
severe_threshold float

Latent-trait threshold for severe food insecurity. Defaults to the severity of item 8.
Source code in src/pyfies/standards.py 
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
@dataclass(frozen=True)
class ReferenceStandard:
    """A reference scale of item severities used as the target for equating.

    Attributes:
        name: Human-readable identifier for the standard.
        items: Names of the items, in the order matching ``severities``.
        severities: Item severity parameters on the standard's latent metric.
        moderate_or_severe_threshold: Latent-trait threshold (item severity)
            above which respondents are classified as moderately-or-severely
            food insecure. Defaults to the severity of item 5.
        severe_threshold: Latent-trait threshold for severe food insecurity.
            Defaults to the severity of item 8.
    """

    name: str
    items: tuple[str, ...]
    severities: np.ndarray
    moderate_or_severe_threshold: float
    severe_threshold: float

pyfies.items

Canonical FIES item names and short descriptions.

DEFAULT_FIES_ITEMS module-attribute 

DEFAULT_FIES_ITEMS: tuple[str, ...] = ('WORRIED', 'HEALTHY', 'FEWFOOD', 'SKIPPED', 'ATELESS', 'RUNOUT', 'HUNGRY', 'WHLDAY')

The eight FIES questions, in the order used by FAO's global standard.

Each item asks whether, during the past 12 months, the respondent (or their household) experienced the condition described, because of lack of money or other resources. Responses are dichotomized: Never -> 0, otherwise -> 1.