R
This has to be run in order to compile this notebook while the R package is still under development.
In [1]:
Copied!
devtools::load_all()
devtools::load_all()
ℹ Loading scenariovettingcriteria
Installation¶
While the R package has not been released yet, you have to install it from GitHub source using:
devtools::install_github('PhilippVerpoort/scenario-vetting-criteria')
Raw file paths¶
The package contains definition files for the criteria. The paths to those files are contained in file_paths.
In [2]:
Copied!
library(scenariovettingcriteria)
for (component_id in names(file_paths)) {
component_path <- file_paths[[component_id]]
print(paste0(component_id, ": ...", substr(as.character(component_path), nchar(as.character(component_path)) - 39, nchar(as.character(component_path)))))
}
library(scenariovettingcriteria)
for (component_id in names(file_paths)) {
component_path <- file_paths[[component_id]]
print(paste0(component_id, ": ...", substr(as.character(component_path), nchar(as.character(component_path)) - 39, nchar(as.character(component_path)))))
}
[1] "criteria-metadata: ...eria/inst/extdata/criteria-metadata.yaml" [1] "criteria-thresholds: ...ria/inst/extdata/criteria-thresholds.csv" [1] "criteria-types: ...riteria/inst/extdata/criteria-types.yaml" [1] "operations: ...ng-criteria/inst/extdata/operations.yaml" [1] "reference-data: ...ing-criteria/inst/extdata/reference-data" [1] "sources: ...etting-criteria/inst/extdata/sources.bib"
Load functions¶
Instead of loading the data from these files manually, it is recommended to use the built-in load functions from the package via load_criteria. For instance, the following will load the definition of the thresholds values.
In [3]:
Copied!
load_criteria('criteria-thresholds')
load_criteria('criteria-thresholds')
| hist_pop | All.Countries | X2010..2015..2020..2025 | Population | range.WDI.2025..WDI.2025.extrapol25..WDI.2025.COVIDaveraged. | dimensionless | level_of_concern.strong | lower.0.75 | upper.1.25 |
|---|---|---|---|---|---|---|---|---|
| <chr> | <chr> | <chr> | <chr> | <chr> | <chr> | <chr> | <chr> | <chr> |
| hist_gdp | World | 2010, 2015, 2020, 2025 | GDP|PPP | range(WDI-2025, WDI-2025-extrapol25, WDI-2025-COVIDaveraged) | dimensionless | strong | 0.75 | 1.25 |
| hist_gdp | All Countries | 2010, 2015, 2020, 2025 | GDP|PPP | range(WDI-2025, WDI-2025-extrapol25, WDI-2025-COVIDaveraged) | dimensionless | strong | 0.65 | 1.35 |
| hist_emi_afolu | World | 2010, 2015, 2020 | Emissions|CO2|AFOLU | range(EDGAR-2024, FAO-2025, PRIMAP-2020-HISTCR, PRIMAP-2020-HISTTP, OSCAR-GCB-2023, Gasser-2020, GCB-2023) | dimensionless | strong | 0.8 | 1.2 |
| hist_emi_afolu | World | 2025 | Emissions|CO2|AFOLU | range(EDGAR-2024-extrapol25, FAO-2025-extrapol25, PRIMAP-2020-HISTCR-extrapol25, PRIMAP-2020-HISTTP-extrapol25, OSCAR-GCB-2023-extrapol25, Gasser-2020-extrapol25, GCB-2023-extrapol25) | dimensionless | strong | 0.7 | 1.3 |
| hist_emi_afolu | World, All Countries | 2010, 2015, 2020 | Emissions|CH4|AFOLU|Agriculture, Emissions|N2O|AFOLU|Agriculture | range(EDGAR-2024, FAO-2025, PRIMAP-2020-HISTCR, PRIMAP-2020-HISTTP) | dimensionless | strong | 0.8 | 1.2 |
| hist_emi_afolu | World, All Countries | 2025 | Emissions|CH4|AFOLU|Agriculture, Emissions|N2O|AFOLU|Agriculture | range(EDGAR-2024-extrapol25, FAO-2025-extrapol25, PRIMAP-2020-HISTCR-extrapol25, PRIMAP-2020-HISTTP-extrapol25) | dimensionless | strong | 0.7 | 1.3 |
| hist_emi_energy_industry | World | 2010, 2015, 2020, 2025 | Emissions|CO2|Energy and Industrial Processes | range(CEDS-2025, CEDS-2025-extrapol25,CEDS-2025-COVIDaveraged) | dimensionless | strong | 0.75 | 1.25 |
| hist_emi_energy_industry | All Countries | 2010, 2015, 2020, 2025 | Emissions|CO2|Energy and Industrial Processes | range(CEDS-2025, CEDS-2025-extrapol25,CEDS-2025-COVIDaveraged) | dimensionless | strong | 0.65 | 1.35 |
| hist_cropland_yield | World, All Countries | 2010, 2015, 2020 | Yield|Cropland|Cereals | range(FAO-2025, FAO-2025-extrapol25) | dimensionless | strong | 0.8 | 1.2 |
| hist_cropland_yield | World, All Countries | 2025 | Yield|Cropland|Cereals | range(FAO-2025, FAO-2025-extrapol25) | dimensionless | strong | 0.7 | 1.3 |
| hist_food_availability | World, All Countries | 2010, 2015, 2020 | Food Availability [per capita] | range(FAO-2025, FAO-2025-extrapol25) | dimensionless | strong | 0.8 | 1.2 |
| hist_food_availability | World, All Countries | 2025 | Food Availability [per capita] | range(FAO-2025, FAO-2025-extrapol25) | dimensionless | strong | 0.7 | 1.3 |
| hist_land_cover | World, All Countries | 2010, 2015, 2020 | Land Cover | range(LUH2-2020, LUH2-GCB-2025, LUH3, FAO-2025) | dimensionless | strong | 0.9 | 1.1 |
| hist_land_cover | World, All Countries | 2025 | Land Cover | range(LUH2-2020-extrapol25, LUH2-GCB-2025-extrapol25, LUH3-extrapol25, FAO-2025-extrapol25) | dimensionless | strong | 0.8 | 1.2 |
| hist_land_cover_cropland | World, All Countries | 2010, 2015, 2020 | Land Cover|Cropland | range(LUH2-2020, LUH2-GCB-2025, LUH3, FAO-2025) | dimensionless | strong | 0.8 | 1.2 |
| hist_land_cover_cropland | World, All Countries | 2025 | Land Cover|Cropland | range(LUH2-2020-extrapol25, LUH2-GCB-2025-extrapol25, LUH3-extrapol25, FAO-2025-extrapol25) | dimensionless | strong | 0.7 | 1.3 |
| hist_pe_fossil | World | 2010, 2015, 2020, 2025 | Primary Energy|Coal, Primary Energy|Oil, Primary Energy|Gas | range(IEA-EB-2024, IEA-EB-2024-extrapol25,IEA-EB-2024-COVIDaveraged) | dimensionless | strong | 0.75 | 1.25 |
| hist_pe_fossil | All Countries | 2010, 2015, 2020, 2025 | Primary Energy|Coal, Primary Energy|Oil, Primary Energy|Gas | range(IEA-EB-2024, IEA-EB-2024-extrapol25,IEA-EB-2024-COVIDaveraged) | dimensionless | strong | 0.65 | 1.35 |
| hist_fe | World | 2010, 2015, 2020, 2025 | Final Energy | range(IEA-EB-2024, IEA-EB-2024-extrapol25,IEA-EB-2024-COVIDaveraged) | dimensionless | strong | 0.75 | 1.25 |
| hist_fe | All Countries | 2010, 2015, 2020, 2025 | Final Energy | range(IEA-EB-2024, IEA-EB-2024-extrapol25,IEA-EB-2024-COVIDaveraged) | dimensionless | strong | 0.65 | 1.35 |
| nearterm_biodiversity_intactness | World | 2030 | Terrestrial Biodiversity|BII, Terrestrial Biodiversity|Biodiversity Intactness Index | %/yr | medium | -0.11 | ||
| nearterm_deforestation | World | 2030 | Forest Area Change|Deforestation | million ha/yr | medium | 16.0 | ||
| nearterm_food_availability | World | 2050, 2100 | Food Availability [per capita] | kcal/cap/day | medium | 2100.0 | 5000.0 | |
| nearterm_forest_expansion | World | 2030 | Forest Area Change|Forest Expansion | million ha/yr | medium | 10.0 | ||
| nearterm_planted_forest_expansion | World | 2030 | Forest Area Change|Forest Expansion|Planted | million ha/yr | medium | 5.0 | ||
| nearterm_land_cover | World | 2030 | Land Cover | million ha | strong | 11554.0 | 14318.0 | |
| nearterm_primary_deforestation | World | 2030 | Forest Area Change|Deforestation|Primary | million ha/yr | medium | 12.0 | ||
| nearterm_hydro | Africa (R10) | 2030 | Capacity|Electricity|Hydro | GW | medium | 15.3 | 96.39 | |
| nearterm_hydro | China+ (R10) | 2030 | Capacity|Electricity|Hydro | GW | medium | 201.24 | 832.12 | |
| nearterm_hydro | Europe (R10) | 2030 | Capacity|Electricity|Hydro | GW | medium | 106.16 | 436.09 | |
| ⋮ | ⋮ | ⋮ | ⋮ | ⋮ | ⋮ | ⋮ | ⋮ | ⋮ |
| nearterm_solar | World | 2025 | Capacity|Electricity|Solar | GW | strong | 1609.2 | 3895.6 | |
| nearterm_solar | China+ (R10) | 2025 | Capacity|Electricity|Solar | GW | medium | 518.1 | 2671.7 | |
| nearterm_solar | Europe (R10) | 2025 | Capacity|Electricity|Solar | GW | medium | 194.2 | 764.7 | |
| nearterm_solar | India+ (R10) | 2025 | Capacity|Electricity|Solar | GW | medium | 56.2 | 256.4 | |
| nearterm_solar | World | 2030 | Capacity|Electricity|Solar | GW | medium | 4350.2 | 8163.7 | |
| nearterm_solar | World | 2030 | Capacity|Electricity|Solar | GW | strong | 2683.2 | 10896.0 | |
| nearterm_solar | China+ (R10) | 2030 | Capacity|Electricity|Solar | GW | medium | 936.1 | 7874.1 | |
| nearterm_solar | Europe (R10) | 2030 | Capacity|Electricity|Solar | GW | medium | 280.6 | 1839.9 | |
| nearterm_solar | India+ (R10) | 2030 | Capacity|Electricity|Solar | GW | medium | 104.4 | 855.6 | |
| nearterm_wind_onshore | World | 2025 | Capacity|Electricity|Wind|Onshore | GW | medium | 1138.0 | 1570.0 | |
| nearterm_wind_onshore | World | 2025 | Capacity|Electricity|Wind|Onshore | GW | strong | 945.0 | 1862.0 | |
| nearterm_wind_onshore | Europe (R10) | 2025 | Capacity|Electricity|Wind|Onshore | GW | medium | 154.0 | 505.0 | |
| nearterm_wind_onshore | China+ (R10) | 2025 | Capacity|Electricity|Wind|Onshore | GW | medium | 268.0 | 1101.0 | |
| nearterm_wind_onshore | India+ (R10) | 2025 | Capacity|Electricity|Wind|Onshore | GW | medium | 28.0 | 91.0 | |
| nearterm_wind_onshore | World | 2030 | Capacity|Electricity|Wind|Onshore | GW | medium | 1719.0 | 2853.0 | |
| nearterm_wind_onshore | World | 2030 | Capacity|Electricity|Wind|Onshore | GW | strong | 1220.0 | 3655.0 | |
| nearterm_wind_onshore | Europe (R10) | 2030 | Capacity|Electricity|Wind|Onshore | GW | medium | 191.0 | 969.0 | |
| nearterm_wind_onshore | China+ (R10) | 2030 | Capacity|Electricity|Wind|Onshore | GW | medium | 349.0 | 2117.0 | |
| nearterm_wind_onshore | India+ (R10) | 2030 | Capacity|Electricity|Wind|Onshore | GW | medium | 33.0 | 154.0 | |
| longterm_cropland_yield | World | 2100 | Yield|Cropland|Cereals | t DM/ha/yr | strong | 15.3 | ||
| longterm_nuclear | World | 2040 | Capacity|Electricity|Nuclear | GW | medium | 694.0 | ||
| longterm_nuclear | World | 2050 | Capacity|Electricity|Nuclear | GW | medium | 950.0 | ||
| longterm_ccus | World | 2035 | Carbon Capture | Mt CO2/yr | medium | 1300.0 | ||
| longterm_ccus | World | 2040 | Carbon Capture | Mt CO2/yr | medium | 4300.0 | ||
| longterm_daccs | World | 2050 | Carbon Capture|Geological Storage|Direct Air Capture | Gt CO2/yr | medium | 4.89 | ||
| sustainable_deforestation | World | 2030 | Forest Area Change|Deforestation | million ha/yr | medium | 0.0 | ||
| sustainable_primary_deforestation | World | 2030 | Forest Area Change|Deforestation|Primary | million ha/yr | medium | 0.0 | ||
| sustainable_biodiversity_intactness | World | 2030 | Terrestrial Biodiversity|BII, Terrestrial Biodiversity|Biodiversity Intactness Index | %/yr | medium | 0.0 | ||
| sustainable_bioenergy | World | 2025, 2030, 2035, 2040, 2045, 2050 | Primary Energy|Biomass | EJ/yr | strong | 100.0 | ||
| sustainable_hydropower | World | 2050 | Capacity|Electricity|Hydro | GW | strong | 1500.0 |
Multiple files can be loaded in one go.
In [4]:
Copied!
criteria <- load_criteria(c('criteria-thresholds', 'operations'))
criteria$operations
criteria <- load_criteria(c('criteria-thresholds', 'operations'))
criteria$operations
- $criterion_type
- 'historical'
- $level_of_concern
- 'strong'
- $threshold_type
-
- 'upper'
- 'lower'
- $operation
- 'drop'
- $criterion_id
- 'nearterm_land_cover'
- $level_of_concern
- 'strong'
- $threshold_type
-
- 'upper'
- 'lower'
- $operation
- 'drop'
- $criterion_type
- 'near_term_feasibility'
- $level_of_concern
- 'strong'
- $threshold_type
-
- 'upper'
- 'lower'
- $operation
- 'flag'
- $colour
- 'red'
- $criterion_type
- 'near_term_feasibility'
- $level_of_concern
- 'medium'
- $threshold_type
-
- 'upper'
- 'lower'
- $operation
- 'flag'
- $colour
- 'yellow'
- $criterion_type
- 'long_term_feasibility'
- $level_of_concern
- 'strong'
- $threshold_type
-
- 'upper'
- 'lower'
- $operation
- 'flag'
- $colour
- 'red'
- $criterion_type
- 'long_term_feasibility'
- $level_of_concern
- 'medium'
- $threshold_type
-
- 'upper'
- 'lower'
- $operation
- 'flag'
- $colour
- 'yellow'
- $criterion_type
- 'sustainability'
- $level_of_concern
- 'strong'
- $threshold_type
-
- 'upper'
- 'lower'
- $operation
- 'flag'
- $colour
- 'purple'
Apply vetting criteria to scenarios¶
A tutorial on how to apply the vetting criteria to a list of scenarios based on piamValidation will be made available later.