Skip to content

🚧 urbanization mdim: test adding a stacked area chart #5713

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
veronikasamborska1994 merged 4 commits into from
Feb 25, 2026
Merged

🚧 urbanization mdim: test adding a stacked area chart #5713

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a508a22
urbanization mdim: test adding a stacked area chart
veronikasamborska1994 Feb 25, 2026
816f622
revert back to master
veronikasamborska1994 Feb 25, 2026
89e8fed
add stacked area option
veronikasamborska1994 Feb 25, 2026
7c6c848
improve titles
veronikasamborska1994 Feb 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions etl/steps/export/multidim/urbanization/latest/cities_towns_rural_areas.config.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,11 @@ dimensions:
name: "Urban areas (cities and towns)"
description: "Population in cities and towns combined."
- slug: "location_type_stacked"
name: "All settlement types"
description: "Cities, towns, and rural areas shown on one chart."
name: "All settlement types (line chart)"
description: "Cities, towns, and rural areas shown on one line chart."
- slug: "location_type_area"
name: "All settlement types (stacked area chart)"
description: "Cities, towns, and rural areas shown on one stacked area chart."
- slug: "urban_vs_rural"
name: "Urban (cities, towns and suburbs) and rural areas"
description: "Urban areas (cities, towns and suburbs combined) and rural areas shown on one chart."
Expand Down
85 changes: 60 additions & 25 deletions etl/steps/export/multidim/urbanization/latest/cities_towns_rural_areas.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,11 +56,25 @@ def run() -> None:
# Add grouped views for location types (only for population and popshare)
c1.group_views(
groups=[
# Stacked area chart: cities, towns, rural
# Stacked line chart: cities, towns, rural
{
"dimension": "location_type",
"choice_new_slug": "location_type_stacked",
"choices": ["urban_centre", "urban_cluster", "rural_total"],
"view_config": {
"hasMapTab": False,
"tab": "chart",
"chartTypes": ["LineChart"],
"hideAnnotationFieldsInTitle": {"time": True},
"addCountryMode": "add-country",
"selectedFacetStrategy": "entity",
},
},
# Stacked area chart: cities, towns, rural
{
"dimension": "location_type",
"choice_new_slug": "location_type_area",
"choices": ["urban_centre", "urban_cluster", "rural_total"],
"view_config": {
"hasMapTab": False,
"tab": "chart",
Expand Down Expand Up @@ -102,8 +116,16 @@ def run() -> None:
collection_name=paths.short_name,
config=paths.load_collection_config(),
)
# Rename data_type for location_type_area views BEFORE grouping
# This prevents them from being included in the grouping operation below
for view in c.views:
if view.dimensions.get("location_type") == "location_type_area":
if view.dimensions.get("data_type") == "estimates":
view.dimensions["data_type"] = "estimates_and_projections"
else:
view.dimensions["data_type"] = "drop_projections"

# Group estimates and projections together for all views
# Group estimates and projections together for all views (except location_type_area which was already renamed)
c.group_views(
groups=[
{
Expand All @@ -120,7 +142,7 @@ def run() -> None:
"hideAnnotationFieldsInTitle": {"time": True},
},
}
]
],
)

# Update view configurations and add colors
Expand All @@ -133,7 +155,7 @@ def run() -> None:
# These views inherit metadata from the indicator but need updated description_key
if data_type == "estimates_and_projections" and not view.metadata:
# Skip grouped location views (handled separately below)
if location_type not in ["location_type_stacked", "urban_vs_rural"]:
if location_type not in ["location_type_stacked", "location_type_area", "urban_vs_rural"]:
metadata = create_individual_view_metadata(location_type, metric, data_type)
if metadata:
view.metadata = metadata
Expand All @@ -142,7 +164,7 @@ def run() -> None:
view.config["subtitle"] = metadata.get("description_short", "")

# Set config for grouped location views (stacked and urban vs rural)
if location_type in ["location_type_stacked", "urban_vs_rural"]:
if location_type in ["location_type_stacked", "location_type_area", "urban_vs_rural"]:
view.config = view.config.copy() if view.config else {}

# Disable map tab for grouped location views
Expand All @@ -152,8 +174,9 @@ def run() -> None:
del view.config["map"]

# Add metadata based on location type
if location_type == "location_type_stacked":
metadata = create_stacked_metadata(metric, data_type)
if location_type in ["location_type_stacked", "location_type_area"]:
metadata = create_stacked_metadata(metric, data_type, location_type)

else: # urban_vs_rural
metadata = create_urban_vs_rural_metadata(metric, data_type)
# Special config for popshare (0-100%)
Expand All @@ -177,15 +200,15 @@ def run() -> None:
# (these metrics don't make sense in stacked area or grouped views)
c.drop_views(
dimensions={
"location_type": ["location_type_stacked", "urban_vs_rural"],
"location_type": ["location_type_stacked", "location_type_area", "urban_vs_rural"],
"metric": ["popshare_change", "density"],
}
)

# Uncomment if we want to include both estimates and projections in separate views
c.drop_views(
dimensions={
"data_type": ["estimates", "projections"],
"data_type": ["estimates", "projections", "drop_projections"],
}
)
#
Expand Down Expand Up @@ -222,16 +245,22 @@ def _individual_title(location_type: str, metric: str, data_type: str) -> str:
return f"{metric.replace('_', ' ').title()} in {base}"


def create_stacked_metadata(metric, data_type):
def create_stacked_metadata(metric, data_type, location_type=None):
"""Create metadata for stacked location_type views."""
# Define titles
titles = {
("population", "estimates"): "Population in cities, towns and suburbs, and rural areas",
("population", "projections"): "Projected population in cities, towns and suburbs, and rural areas",
("population", "estimates_and_projections"): "Population in cities, towns and suburbs, and rural areas",
("popshare", "estimates"): "Share of population in cities, towns and suburbs, and rural areas",
("popshare", "projections"): "Projected share of population in cities, towns and suburbs, and rural areas",
("popshare", "estimates_and_projections"): "Share of population in cities, towns and suburbs, and rural areas",
("population", "estimates"): "Population living in cities, towns and suburbs, and rural areas",
("population", "projections"): "Projected population living in cities, towns and suburbs, and rural areas",
("population", "estimates_and_projections"): "Population living in cities, towns and suburbs, and rural areas",
("popshare", "estimates"): "Share of population living in cities, towns and suburbs, and rural areas",
(
"popshare",
"projections",
): "Projected share of population living in cities, towns and suburbs, and rural areas",
(
"popshare",
"estimates_and_projections",
): "Share of population living in cities, towns and suburbs, and rural areas",
}

# Define description_short
Expand Down Expand Up @@ -281,9 +310,15 @@ def create_stacked_metadata(metric, data_type):
"From 2020 onwards, population distribution and built-up areas are projected at 1 km² resolution using the [Cities and Rural Integrated Spatial Projections spatial model](https://www.researchgate.net/publication/384062691_Calibration_of_the_CRISP_model_A_global_assessment_of_local_built-up_area_presence). The projections follow the UN World Population Prospects 2024 medium scenario, and country totals are aligned with UN projections."
)
elif data_type == "estimates_and_projections":
description_key.append(
"For the years 1950–1975, there are no detailed maps showing where people lived within countries. So instead of using grid-level or satellite data, the estimates are reconstructed using national statistics from the UN. From 1975 onwards, population is mapped to 1 km² grid cells by combining census data with satellite imagery of built-up areas from the [Global Human Settlement Layer](https://human-settlement.emergency.copernicus.eu/). From 2020 onwards, population distribution and built-up areas are projected at 1 km² resolution using the [Cities and Rural Integrated Spatial Projections spatial model](https://www.researchgate.net/publication/384062691_Calibration_of_the_CRISP_model_A_global_assessment_of_local_built-up_area_presence). The projections follow the UN World Population Prospects 2024 medium scenario, and country totals are aligned with UN projections."
)
# For location_type_area, only show estimates description (no projections)
if location_type == "location_type_area":
description_key.append(
"For the years 1950–1975, there are no detailed maps showing where people lived within countries. So instead of using grid-level or satellite data, the estimates are reconstructed using national statistics from the UN. From 1975 onwards, population is mapped to 1 km² grid cells by combining census data with satellite imagery of built-up areas from the [Global Human Settlement Layer](https://human-settlement.emergency.copernicus.eu/)."
)
else:
description_key.append(
"For the years 1950–1975, there are no detailed maps showing where people lived within countries. So instead of using grid-level or satellite data, the estimates are reconstructed using national statistics from the UN. From 1975 onwards, population is mapped to 1 km² grid cells by combining census data with satellite imagery of built-up areas from the [Global Human Settlement Layer](https://human-settlement.emergency.copernicus.eu/). From 2020 onwards, population distribution and built-up areas are projected at 1 km² resolution using the [Cities and Rural Integrated Spatial Projections spatial model](https://www.researchgate.net/publication/384062691_Calibration_of_the_CRISP_model_A_global_assessment_of_local_built-up_area_presence). The projections follow the UN World Population Prospects 2024 medium scenario, and country totals are aligned with UN projections."
)

description_key.extend(
[
Expand All @@ -303,12 +338,12 @@ def create_urban_vs_rural_metadata(metric, data_type):
"""Create metadata for urban vs rural views."""
# Define titles
titles = {
("population", "estimates"): "Population in urban and rural areas",
("population", "projections"): "Projected population in urban and rural areas",
("population", "estimates_and_projections"): "Population in urban and rural areas",
("popshare", "estimates"): "Share of population in urban and rural areas",
("popshare", "projections"): "Projected share of population in urban and rural areas",
("popshare", "estimates_and_projections"): "Share of population in urban and rural areas",
("population", "estimates"): "Population living in urban and rural areas",
("population", "projections"): "Projected population living in urban and rural areas",
("population", "estimates_and_projections"): "Population living in urban and rural areas",
("popshare", "estimates"): "Share of population living in urban and rural areas",
("popshare", "projections"): "Projected share of population living in urban and rural areas",
("popshare", "estimates_and_projections"): "Share of population living in urban and rural areas",
}

# Define description_short
Expand Down