reference_years

reference_years(dataset, variable=None, scale=None, ref=None)

The actual years behind each stored year, one row per variable and stored year.

Some panels store values at nominal years: the SDG Atlas, for example, stores its initial values at 2012 and its final values at 2024, while an indicator may come from a survey of 2008 and 2023.

Parameters

Name Type Description Default
dataset str Dataset id required
variable str | None One variable (default: all) None
scale str | None The resource’s scale (default: the dataset’s native scale) None

Returns

Name Type Description
pandas.DataFrame Columns variable, label, year (as stored) and reference (the actual years; the stored year when they are the same).

Example

!pip install -q geo4bolivia
import geo4bolivia as geo
import plotly.express as px

ry = geo.reference_years("sdg03")          # stored year -> actual years
ry[ry["year"] == 2024]
variable label year reference
1 index_sdg3 Good health and well-being index (0-100) 2024 ~2024
3 sdg3_1_cpp Births attended by skilled health personnel (%) 2024 2024
5 sdg3_2_tmi Infant mortality (per 1,000 live births) 2024 2023
7 sdg3_2_tmn Under-5 mortality (per 1,000 live births) 2024 2023
9 sdg3_3_vih HIV incidence (per million people) 2024 average 2022–2024
11 sdg3_3_tub Tuberculosis incidence (per 100,000 people) 2024 average 2022–2024
13 sdg3_3_vec Vector-borne disease index (0-1) 2024 average 2022–2024
15 sdg3_7_tfa Mean parity of adolescent women 15-19 (childre... 2024 2024