DOI: 10.5281/zenodo.15168643
title: Input data for DSCALE

description: Overview

This repository contains input data for the DSCALE algorithm, as well as scripts to generate the input files.

The table below provides a description of files available under `input_data.zip`:

    


File name
File location
Description
Notes / References


 Fuel_dict.csv
input_data/
 
 


 GAINS_ISO3.csv
input_data/
Regional mapping of the GAINS model
 


 Grassi_regional_mapping.csv
input_data/
Regional mapping used in Grassi et al 2021 (Suppl. Table 8)
 


 Grassi_regions_dynamic.csv
input_data/
Adjustment values, globally and by region for all SSP2 scenarios (in GtCO2/y), i.e. indirect human-induced sink in non-intact forests, estimated by IMAGE/LPJmL.
Dataframe created from Supplementary Table 8 of Grassi, G., Stehfest, E., Rogelj, J. et al. Critical adjustment of land mitigation pathways for assessing countries’ climate progress. Nat. Clim. Chang. 11, 425–434 (2021). https://doi.org/10.1038/s41558-021-01033-6 (last access: March 2025)


 IEA_Fuel_dict.csv
input_data/
Fuel mapping (map fuels used in the Platts database with fuels used in DSCALE)
 


 MESSAGE_CEDS_region_mapping_2020_02_04.csv
input_data/
Regional country mapping of IPCC regions
 


 gwp.csv
input_data/
Global Warming Potential
NOTE: AR6 from https://github.com/IAMconsortium/units/blob/main/iam_units/data/emissions/AR6GWP100.txt  (last access: March 2025), Otherwise data taken from: https://ghgprotocol.org/sites/default/files/ghgp/Global-Warming-Potential-Values%20%28Feb%2016%202016%29_1.pdf  (last access: March 2025)


 indc_plus_emi_targets.csv
input_data/
NDCs targets at the country level
 


 GDP_NGFS_merged.csv
input_data/NGFS_2023
GDP and Population projections at the country level
 


 combined_lulucf_fluxes.csv
input_data/NGFS_2023
Land use emissions (historical)
Model  data from: https://zenodo.org/records/7541525/files/Global%20models%20land%20CO2%20data%202000-2020.xlsx?download=1   and Inventories from: https://zenodo.org/records/7650360/files/National%20inventories%20LULUCF%20data%202000-2020%20(Dec%202022).xlsx?download=1.  (last access: March 2025)


 config.yaml
input_data/NGFS_2023
Configuration file
 


 default_mapping.csv
input_data/NGFS_2023
Regional-country mapping file (list counries included in each IAM region)
 


 scenario_config.csv
input_data/NGFS_2023
Scenario configuration file
 


snapshot_all_regions.csv
input_data/NGFS_2023/snapshot_v1
Regional IAMs results to be downscaled to the country level
Richters, O., Kriegler, E., Al Khourdajie, A., Bertram, C., Bresch, D. N., Ciullo, A., Cornforth, E., Cui, R., Edmonds, J., Fuchs, S., Hackstock, P., Holland, D., Hurst, I., Kikstra, J., Klein, D., Kotz, M., Kropf, C. M., Lewis, J., Liadze, I., … Zwerling, M. (2024). NGFS Climate Scenarios Data Set (4.2) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.10807824 (last access: March 2025)


 versions.csv
input_data/NGFS_2023
Run version
 




 

The table below shows a list of external input data used in the DSCALE algorithm (inluding proprietary data):




File name
File location (DSCALE)
Description
DOI/Link


 ALLUNITS_PLATTS_ISO.csv
input_data/
World Electric Power Plants Database
Platts:  World Electric Power Plants Data Base, https://www.spglobal.com/commodity-insights/en/products-solutions/clean-energy-technology, 2019.  (last access: March 2025)


 CostCurveHYD_lpjml_gfdl-esm2m_ewembi_rcp26_rcp26soc_co2_qtot_global_daily_2031_2070_merge_monmean_Hydro.csv
input_data/
Supply-Cost curves
github.com/davidgernaat/Hydro_CostCurves Version v1.0.1 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059487 (last access: March 2025)


 CostCurveHYD_lpjml_gfdl-esm2m_ewembi_rcp26_rcp26soc_co2_qtot_global_daily_2031_2070_merge_monmean_Hydro.dat
input_data/
Supply-Cost curves
github.com/davidgernaat/Hydro_CostCurves Version v1.0.1 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059487 (last access: March 2025)


 CostCurve_1stGen_Bio.dat
input_data/
Supply-Cost curves
github.com/davidgernaat/Bio_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059455 (last access: March 2025)


 CostCurve_2ndGen_Bio.dat
input_data/
Supply-Cost curves
github.com/davidgernaat/Bio_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059455 (last access: March 2025)


 CostCurve_PV.dat
input_data/
Supply-Cost curves
 github.com/davidgernaat/Solar_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059441 (last access: March 2025)


 CostCurve_PVres.dat
input_data/
Supply-Cost curves
github.com/davidgernaat/Solar_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059441 (last access: March 2025)


 CostCurve_offshore_Wind.dat
input_data/
Supply-Cost curves
 github.com/davidgernaat/Wind_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059451 (last access: March 2025)


 CostCurve_onshore_Wind.dat
input_data/
Supply-Cost curves
github.com/davidgernaat/Wind_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059451 (last access: March 2025)


 Emission_Clock_transport_act_data_aggregation_WEO2021_STEPS_V2.csv
input_data/
Activity indicators
Based on IEA data, IEA (2021). World Energy Outlook 2021, All rights reserved  (last access: March 2025)


 Extended_IEA_en_bal_2019_ISO.csv
input_data/
IEA Energy balances (historical data)
https://www.iea.org/data-and-statistics/data-product/world-energy-statistics-and-balances (last access: March 2025)


 Guetschow_et_al_2024-PRIMAP-hist_v2.5.1_final_no_extrap_no_rounding_27-Feb-2024.csv
input_data/
The PRIMAP-hist national historical emissions time series (1750-2022)
The PRIMAP-hist national historical emissions time series (1750-2022) v2.5.1 (2.5.1) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.10705513 (last access: March 2025)


 Historical_data.csv
input_data/
IEA energy statistics indicators. Dataframe in long format . It should include an `ISO` (ISO 3166-1 alpha-3 code) column associated to each country (e.g. `ITA` to denote Italy)
https://www.iea.org/data-and-statistics/data-product/world-energy-statistics-and-balances (last access: March 2025)


 IEA 2019 CO2 emissions from fuels_ISO.csv
input_data/
IEA CO2 emissions from fuel combustion. Dataframe in wide format. It should contain an `ISO` (ISO 3166-1 alpha-3 code) column associated to each country.
https://www.iea.org/data-and-statistics/data-product/greenhouse-gas-emissions-from-energy#co2-emissions-from-fuel-combustion-detailed-estimates (last access: March 2025)


 MaxProdHYD_lpjml_gfdl-esm2m_ewembi_rcp26_rcp26soc_co2_qtot_global_daily_2031_2070_merge_monmean_Hydro.dat
input_data/
Supply-Cost curves
github.com/davidgernaat/Hydro_CostCurves Version v1.0.1 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059487 (last access: March 2025)


 MaxProd_1stGen_Bio.dat
input_data/
Supply-Cost curves (maximum production)
github.com/davidgernaat/Bio_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059455 (last access: March 2025)


 MaxProd_2ndGen_Bio.dat
input_data/
Supply-Cost curves (maximum production)


github.com/davidgernaat/Bio_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059455 (last access: March 2025)



 MaxProd_PV.dat
input_data/
Supply-Cost curves (maximum production)
 github.com/davidgernaat/Solar_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059441 (last access: March 2025)


 MaxProd_PVres.dat
input_data/
Supply-Cost curves (maximum production)
 github.com/davidgernaat/Solar_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059441 (last access: March 2025)


 MaxProd_offshore_Wind.dat
input_data/
Supply-Cost curves (maximum production)
 github.com/davidgernaat/Wind_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059451 (last access: March 2025)


 MaxProd_onshore_Wind.dat
input_data/
Supply-Cost curves (maximum production)
github.com/davidgernaat/Wind_CostCurves Version v1.0.0 (Zenodo, 2020); https://doi.org/10.5281/zenodo.4059451 (last access: March 2025)


 SspDb_country_data_2013-06-12.csv
input_data/
GDP/Population projections at the country level , based on SSPs
Dataset available at: https://tntcat.iiasa.ac.at/SspDb/dsd?Action=htmlpage&page=60,  https://doi.org/10.1016/j.gloenvcha.2016.05.009 (last access: March 2025)


 master_proj_obs.csv
input_data/
Projected Governance indicators
Dataset available at: https://github.com/marina-andrijevic/governance2019/tree/master/data,  https://doi.org/10.1038/s41893-019-0405-0 (last access: March 2025)


GAINS_nonCO2_Global_21Feb2022_byGas.csv
input_data/NGFS_2023
GAINS results for a baseline scenario and maximum abatemement potential
https://doi.org/10.5281/zenodo.10653413 (last access: March 2025)


IEA_balances_Rev2022.csv
input_data/
Energy Balances from IEA (2022 Version)
https://www.iea.org/data-and-statistics/data-product/world-energy-statistics-and-balances (last access: March 2025)




 

This repository contains scripts to generate addutional files. Please note that all of these scripts rely on other python files published in the DSCALE repository: https://doi.org/10.5281/zenodo.14795503 

    


File name
File location
Description
Script


 IEA_hist_trade_variables_v2022.csv
input_data/
IEA Historical Trade variable, 2021 version. 
create_iea_data.py


 Projected GW _ COAL _ Status=[OPR, PLN, CON] _50 years_all_countries.csv
input_data/
Projected Installed capacity based on remaining technical lifetime (assuming 50 years of technical lifetime unless otherwise specified), based on `ALLUNITS_PLATTS_ISO.csv`
create_installed_gw_files.py


 Projected GW _ GAS _ Status=[OPR, PLN, CON] _40 years_all_countries.csv
input_data/
Projected Installed capacity based on remaining technical lifetime (assuming 40 years of technical lifetime unless otherwise specified), based on `ALLUNITS_PLATTS_ISO.csv`
create_installed_gw_files.py


 Projected GW _ GEO _ Status=[OPR, PLN, CON] _30 years_all_countries.csv
input_data/
Projected Installed capacity based on remaining technical lifetime (assuming 30 years of technical lifetime unless otherwise specified), based on `ALLUNITS_PLATTS_ISO.csv`
create_installed_gw_files.py


 Projected GW _ OIL _ Status=[OPR, PLN, CON] _30 years_all_countries.csv
input_data/
Projected Installed capacity based on remaining technical lifetime (assuming 30 years of technical lifetime unless otherwise specified), based on `ALLUNITS_PLATTS_ISO.csv`
create_installed_gw_files.py


 input_reference_iea_2022.csv
input_data/
IEA Historical data in IAMC format with MODEL='Reference' and SCENARIO='IEA Energy Statistics (r2022)'
create_iea_data.py




 

If you have any questions please contact: sferra@iiasa.ac.at

 

References



Andrijevic, M., Crespo Cuaresma, J., Muttarak, R. et al. Governance in socioeconomic pathways and its role for future adaptive capacity. Nat Sustain 3, 35–41 (2020). https://doi.org/10.1038/s41893-019-0405-0 (last access: March 2025)Based on IEA data, IEA (2021). World Energy Outlook 2021, All rights reserved  (last access: March 2025)

David Gernaat. (2020). davidgernaat/Bio_CostCurves: Bio_CostCurves (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.4059455 (last access: March 2025)

David Gernaat. (2020). davidgernaat/Hydro_CostCurves: Hydro_CostCurves (v1.0.1). Zenodo. https://doi.org/10.5281/zenodo.4059487  (last access: March 2025)

David Gernaat. (2020). davidgernaat/Solar_CostCurves: Solar_CostCurves (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.4059441 (last access: March 2025)

David Gernaat. (2020). davidgernaat/Wind_CostCurves: Wind_CostCurves (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.4059451(last access: March 2025)

Global Warming Potential Values https://ghgprotocol.org/  (last access: March 2025)

Grassi, G., Schwingshackl, C., Gasser, T., Houghton, R. A., Sitch, S., Canadell, J. G., Cescatti, A., Ciais, P., Federici, S., Friedlingstein, P., Kurz, W. A., Sanz Sanchez, M. J., Abad Viñas, R., Alkama, R., Bultan, S., Ceccherini, G., Falk, S., Kato, E., Kennedy, D., … Pongratz, J. (2023). Harmonising the land-use flux estimates of global models and national inventories for 2000-2020: background data [Data set]. In Earth System Science Data. Zenodo. https://doi.org/10.5281/zenodo.7541525 (last access: March 2025)

Grassi, G., Schwingshackl, C., Gasser, T., Houghton, R. A., Sitch, S., Canadell, J. G., Cescatti, A., Ciais, P., Federici, S., Friedlingstein, P., Kurz, W. A., Sanz Sanchez, M. J., Abad Viñas, R., Alkama, R., Bultan, S., Ceccherini, G., Falk, S., Kato, E., Kennedy, D., … Pongratz, J. (2023). Harmonising the land-use flux estimates of global models and national inventories for 2000-2020: background data [Data set]. In Earth System Science Data. Zenodo. https://doi.org/10.5281/zenodo.7650360 (last access: March 2025)

Grassi, G., Stehfest, E., Rogelj, J. et al. Critical adjustment of land mitigation pathways for assessing countries’ climate progress. Nat. Clim. Chang. 11, 425–434 (2021). https://doi.org/10.1038/s41558-021-01033-6 (last access: March 2025)

IEA CO2 emissions from fuel combustion, https://www.iea.org/data-and-statistics/data-product/greenhouse-gas-emissions-from-energy#co2-emissions-from-fuel-combustion-detailed-estimates (last access: March 2025)

IEA World Energy Statistics and Balances https://www.iea.org/data-and-statistics/data-product/world-energy-statistics-and-balances (last access: March 2025)

IPCC, 2021: Climate Change 2021: The Physical Science Basis. Contribution of Working Group I to the Sixth Assessment Report of the Intergovernmental Panel on Climate Change [Masson-Delmotte, V., P. Zhai, A. Pirani, S.L. Connors, C. Péan, S. Berger, N. Caud, Y. Chen, L. Goldfarb, M.I. Gomis, M. Huang, K. Leitzell, E. Lonnoy, J.B.R. Matthews, T.K. Maycock, T. Waterfield, O. Yelekçi, R. Yu, and B. Zhou (eds.)]. Cambridge University Press, Cambridge, United Kingdom and New York, NY, USA, 2391 pp. doi:10.1017/9781009157896 (last access: March 2025)

Keywan Riahi, Detlef P. van Vuuren, Elmar Kriegler, Jae Edmonds, Brian C. O’Neill, Shinichiro Fujimori, Nico Bauer, Katherine Calvin, Rob Dellink, Oliver Fricko, Wolfgang Lutz, Alexander Popp, Jesus Crespo Cuaresma, Samir KC, Marian Leimbach, Leiwen Jiang, Tom Kram, Shilpa Rao, Johannes Emmerling, Kristie Ebi, Tomoko Hasegawa, Petr Havlik, Florian Humpenöder, Lara Aleluia Da Silva, Steve Smith, Elke Stehfest, Valentina Bosetti, Jiyong Eom, David Gernaat, Toshihiko Masui, Joeri Rogelj, Jessica Strefler, Laurent Drouet, Volker Krey, Gunnar Luderer, Mathijs Harmsen, Kiyoshi Takahashi, Lavinia Baumstark, Jonathan C. Doelman, Mikiko Kainuma, Zbigniew Klimont, Giacomo Marangoni, Hermann Lotze-Campen, Michael Obersteiner, Andrzej Tabeau, Massimo Tavoni, "The Shared Socioeconomic Pathways and their energy, land use, and greenhouse gas emissions implications: An overview".Global Environmental Change, Volume 42, 2017, Pages 153-168, https://doi.org/10.1016/j.gloenvcha.2016.05.009.https://doi.org/10.1016/j.gloenvcha.2016.05.009 (last access: March 2025)

Platts:  World Electric Power Plants Data Base, https://www.spglobal.com/commodity-insights/en/products-solutions/clean-energy-technology, 2019.  (last access: March 2025)

Sferra, F., van Ruijven, B., Riahi, K., Hackstock, P., Maczek, F., Kikstra, J., & Haas, R. (2025). fabiosferra/DSCALE: v0.1 (v0.1). Zenodo. https://doi.org/10.5281/zenodo.14795503 (last access: March 2025)

The PRIMAP-hist national historical emissions time series (1750-2022) v2.5.1 (2.5.1) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.10705513 (last access: March 2025)

Vashold, L., Sferra, F., Höglund-Isaksson, L., van Ruijven, B., Warnecke, L., Crespo Cuaresma, J., Min, J., & Fengler, W. (2024). Dataset: World Emissions Clock (1.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.10653414(last access: March 2025)