From a67416fab21f16af865aab60bb537c98e8cef2eb Mon Sep 17 00:00:00 2001
From: Pascal Weigmann <pascal.weigmann@pik-potsdam.de>
Date: Thu, 22 Aug 2024 16:50:45 +0200
Subject: [PATCH] update configs

---
 inst/config/validationConfig_AMT.csv          |  61 ++++++++----------
 inst/config/validationConfig_ARIADNE.csv      |   2 +-
 inst/config/validationConfig_ELEVATE.xlsx     | Bin 0 -> 85835 bytes
 inst/config/validationConfig_default.csv      |  60 ++++++++++-------
 inst/config/validationConfig_sanityChecks.csv |   8 +++
 5 files changed, 73 insertions(+), 58 deletions(-)
 create mode 100644 inst/config/validationConfig_ELEVATE.xlsx
 create mode 100644 inst/config/validationConfig_sanityChecks.csv

diff --git a/inst/config/validationConfig_AMT.csv b/inst/config/validationConfig_AMT.csv
index 46f573d..9542922 100644
--- a/inst/config/validationConfig_AMT.csv
+++ b/inst/config/validationConfig_AMT.csv
@@ -1,45 +1,38 @@
 metric;critical;variable;unit;model;scenario;region;period;min_red;min_yel;max_yel;max_red;ref_model;ref_scenario;ref_period;source/link to discussion
 Deviation to historical data;;;;;;;;;;;;;;;
-relative;no;Emi|CO2|Energy;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
-relative;no;Emi|CO2|Energy|Demand|Transport;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
-relative;no;Emi|CO2|Energy|Demand|Buildings;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
-relative;no;Emi|CO2|Energy|Demand|Industry;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
-relative;no;Emi|CO2|Energy|Supply;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
-relative;no;Emi|CO2|Industrial Processes;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
-relative;no;PE|Coal;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;BP, IEA;historical;;
-relative;no;PE|Oil;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;BP, IEA;historical;;
-relative;no;PE|Gas;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;BP, IEA;historical;;
-relative;no;SE|Electricity;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;Ember, BP;historical;;
-relative;no;SE|Electricity|*;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;Ember, BP;historical;;
-relative;no;FE;EJ/yr;;;;2005-2020;-40%;-20%;20%;40%;IEA;historical;;
-relative;no;FE|*;EJ/yr;;;;2005-2020;-40%;-20%;20%;40%;IEA;historical;;
-relative;no;Cap|Electricity|*;GW;;;;2005-2020;-40%;-20%;20%;40%;Ember;historical;;
+relative;yes;Emi|CO2|Energy;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Demand|Transport;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Demand|Buildings;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Demand|Industry;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Supply;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
+relative;yes;Emi|CO2|Industrial Processes;Mt CO2/yr;;;;2005-2020;-40%;-20%;20%;40%;EDGAR8;historical;;
+relative;yes;PE|Coal;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;BP, IEA;historical;;
+relative;yes;PE|Oil;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;BP, IEA;historical;;
+relative;yes;PE|Gas;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;BP, IEA;historical;;
+relative;yes;SE|Electricity;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;Ember, BP;historical;;
+relative;yes;SE|Electricity|*;EJ/yr;;;;2005-2020;-30%;-15%;15%;30%;Ember, BP;historical;;
+relative;yes;FE;EJ/yr;;;;2005-2020;-40%;-20%;20%;40%;IEA;historical;;
+relative;yes;FE|*;EJ/yr;;;;2005-2020;-40%;-20%;20%;40%;IEA;historical;;
+relative;yes;Cap|Electricity|*;GW;;;;2005-2020;-40%;-20%;20%;40%;Ember;historical;;
 ;;;;;;;;;;;;;;;
 Near-term realism;;;;;;;;;;;;;;;
-relative;no;FE;EJ/yr;;;;2030;-40%;-20%;;;;;2020;Survey: Felix
-relative;no;Emi|GHG;Mt CO2/yr;;;;2030;-50%;-30%;;;;;2020;Survey: Felix
-absolute;no;Emi|CO2;Mt CO2/yr;;;;2025;39816;;;;;;;"based on Elmars assumptions on max. reduction scenarios:
+relative;yes;FE;EJ/yr;;;;2030;-40%;-20%;;;;;2020;Survey: Felix
+relative;yes;Emi|GHG;Mt CO2/yr;;;;2030;-50%;-30%;;;;;2020;Survey: Felix
+absolute;yes;Emi|CO2;Mt CO2/yr;;;World;2025;39816;;;;;;;"based on Elmars assumptions on max. reduction scenarios:
 2019: 37.65Gt (EDGAR, wo LULUCF). 2025 (-3.4%): 36.37Gt + 3.45Gt LULUCF = 39.82Gt CO2"
-absolute;no;Emi|CO2;Mt CO2/yr;;;;2030;30987;;;;;;;2030 (-23%): 28.99Gt + 2.0Gt LULUCF = 30.99Gt CO2
-absolute;no;Emi|CH4;Mt CH4/yr;;;;2040;100;;;1000;;;;AR6 WG3 Annex III, Table 11
-absolute;no;Carbon Management|Storage;Mt CO2/yr;;;World;2030;;;;2000;;;;AR6 WG3 Annex III, Table 11
-absolute;no;SE|Electricity|Nuclear;EJ/yr;;;World;2030;;;;20;;;;AR6 WG3 Annex III, Table 11
+absolute;yes;Emi|CO2;Mt CO2/yr;;;World;2030;30987;;;;;;;2030 (-23%): 28.99Gt + 2.0Gt LULUCF = 30.99Gt CO2
+absolute;yes;Emi|CH4;Mt CH4/yr;;;World;2040;100;;;1000;;;;AR6 WG3 Annex III, Table 11
+absolute;yes;Carbon Management|Storage;Mt CO2/yr;;;World;2030;;;;2000;;;;AR6 WG3 Annex III, Table 11
+absolute;yes;SE|Electricity|Nuclear;EJ/yr;;;World;2030;;;;20;;;;AR6 WG3 Annex III, Table 11
 ;;;;;;;;;;;;;;;
 Absolute technical/geological limits;;;;;;;;;;;;;;;
-growthrate;no;New Cap|Electricity|Solar|PV;GW/yr;;;;;;;50%;100%;;;;Survey: Felix
-absolute;no;Carbon Management|Storage;Mt CO2/yr;;;World;;;;4000;8600;;;;"from ESABCC, based on Luderer et al. ""Impact of Declining Renewable Energy Costs on Electrification
-in Low-Emission Scenarios"""
-absolute;no;PE|Biomass;EJ/yr;;;World;;;;100;240;;;;"from ESABCC, based on Creutzig et al. ""Bioenergy and Climate Change Mitigation: An
+growthrate;yes;New Cap|Electricity|Solar|PV;GW/yr;;;;2020-2100;;;50%;100%;;;;Survey: Felix
+absolute;yes;Carbon Management|Storage;Mt CO2/yr;;;World;2005-2050;;;;5000;;;;https://www.sciencedirect.com/science/article/pii/S1750583622001840
+absolute;yes;Carbon Management|Storage;Mt CO2/yr;;;World;2060-2100;;;;8600;;;;https://www.sciencedirect.com/science/article/pii/S1750583622001840
+absolute;yes;PE|Biomass;EJ/yr;;;World;;;;100;240;;;;"from ESABCC, based on Creutzig et al. ""Bioenergy and Climate Change Mitigation: An
 Assessment"" (2015), Frank et al. ""and-Based Climate
 Change Mitigation Potentials within the Agenda for Sustainable Development"" (2021)"
 ;;;;;;;;;;;;;;;
 Scenario specific;;;;;;;;;;;;;;;
-absolute;no;Temperature|Global Mean;K;;Bal;;2100;;;1.5;1.55;;;;SDP_MC-PkBudg650-AMT, SSP1-PkBudg650-AMT, SSP2EU-EU21-PkBudg500-AMT, SSP2EU-EU21-PkBudg650-AMT, SSP2EU-PkBudg500-AMT, SSP2EU-PkBudg650-AMT, SSP5-PkBudg650
-;;;;;;;;;;;;;;;
-Sanity checks;;;;;;;;;;;;;;;
-absolute;yes;Price|**;;;;;;0.000001;;;;;;;
-absolute;yes;FE|**;;;;;;0.000001;;;;;;;
-absolute;yes;SE|**;;;;;;0.000001;;;;;;;
-absolute;yes;PE|**;;;;;;0.000001;;;;;;;
-absolute;yes;Emi|**|Fossil;;;;;;0.000001;;;;;;;
-absolute;yes;**|Share;;;;;;0.000001;;;100;;;;
+absolute;yes;Temperature|Global Mean;K;;SSP2EU-EU21-PkBudg500-AMT, SSP2EU-PkBudg500-AMT;;2100;;;1.5;1.6;;;;corresponds to C1 category
+absolute;yes;Temperature|Global Mean;K;;SDP_MC-PkBudg650-AMT, SSP1-PkBudg650-AMT, SSP2EU-EU21-PkBudg650-AMT, SSP2EU-PkBudg650-AMT, SSP5-PkBudg650;;2100;;;;1.8;;;;C2? Or also C1?
diff --git a/inst/config/validationConfig_ARIADNE.csv b/inst/config/validationConfig_ARIADNE.csv
index 093c24d..ab0a586 100644
--- a/inst/config/validationConfig_ARIADNE.csv
+++ b/inst/config/validationConfig_ARIADNE.csv
@@ -1,5 +1,5 @@
 metric;critical;variable;unit;model;scenario;region;period;min_red;min_yel;max_yel;max_red;ref_model;ref_scenario;ref_period;source/link to discussion
-relative;yes;Emi|GHG|w/o Land-Use Change;MtCO2eq/yr;REMIND;;DEU;2020;-0.2;-0.1;0.1;0.2;UBA;historical;;
+relative;yes;Emi|GHG|w/o Land-Use Change;Mt CO2eq/yr;REMIND;;DEU;2020;-0.2;-0.1;0.1;0.2;UBA;historical;;
 relative;yes;Emi|GHG|Energy|Supply;Mt CO2eq/yr;REMIND;;DEU;2020;-0.2;-0.1;0.1;0.2;UBA;historical;;
 relative;yes;Emi|GHG|Industry;Mt CO2eq/yr;REMIND;;DEU;2020;-0.2;-0.1;0.1;0.2;UBA;historical;;
 relative;yes;Emi|GHG|Energy|Demand|Buildings;Mt CO2eq/yr;REMIND;;DEU;2020;-0.2;-0.1;0.1;0.2;UBA;historical;;
diff --git a/inst/config/validationConfig_ELEVATE.xlsx b/inst/config/validationConfig_ELEVATE.xlsx
new file mode 100644
index 0000000000000000000000000000000000000000..6da24879457f0e9497f7a50d0a515577d8eb1115
GIT binary patch
literal 85835
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
bqm4V{%H_l0izn9J6SPaP4A!%V2mJp5U>OtC

literal 0
HcmV?d00001

diff --git a/inst/config/validationConfig_default.csv b/inst/config/validationConfig_default.csv
index 3972685..4321244 100644
--- a/inst/config/validationConfig_default.csv
+++ b/inst/config/validationConfig_default.csv
@@ -1,24 +1,38 @@
 metric;critical;variable;unit;model;scenario;region;period;min_red;min_yel;max_yel;max_red;ref_model;ref_scenario;ref_period;source/link to discussion
-relative;yes;Emi|CO2|Energy;Mt CO2/yr;;Elec, H2;;;-0.25;-0.2;0.2;0.25;EDGAR6;historical;;
-relative;yes;Emi|CO2|Energy;Mt CO2eq/yr;;Elec, H2;World;;-0.2;-0.1;0.1;0.2;EDGAR6;historical;;
-relative;yes;Emi|CO2|Energy;Mt CO2/yr;;Elec, H2;DEU;;-0.25;-0.15;0.15;0.25;EDGAR6;historical;;
-relative;yes;PE|Coal;EJ/yr;;;;;-0.1;;;0.1;BP, IEA;historical;;
-relative;yes;PE|Coal;EJ/yr;;;World;;-0.2;;;0.2;BP, IEA;historical;;
-difference;yes;PE|Oil;EJ/yr;;;;;-2;;;2;;historical;;
-difference;yes;PE|Oil;EJ/yr;;;World;;-5;;;5;;historical;;
-relative;yes;FE|Electricity;EJ/yr;;Bal;;;-0.1;;;0.1;;historical;;
-relative;yes;FE|Electricity;EJ/yr;;Bal;World;;-0.2;;;0.2;;historical;;
-absolute;yes;Price|Carbon;US$2005/t CO2;;;;2030;;;300;600;;;;
-absolute;yes;Price|Carbon;US$2005/t CO2;;;;2050;;;;1000;;;;
-absolute;yes;Price|Carbon;US$2005/t CO2;;;DEU;2030;50;100;400;800;;;;
-absolute;yes;Price|Carbon;US$2005/t CO2;;;DEU;2050;100;150;600;1200;;;;
-absolute;no;Price|Carbon;US$2005/t CO2;;;LAM, MEA, SSA, OAS, IND;2030, 2050;;;;200;;;;
-absolute;yes;Emi|GHG;Mt CO2eq/yr;;Bal;DEU, USA, JPN, REF, CHA, CAZ, EUR;2050;-2000;-1000;0;500;;;;
-absolute;no;Emi|GHG;Mt CO2eq/yr;;Bal;LAM, MEA, SSA, OAS, IND;2060;-2000;-1000;0;500;;;;
-absolute;yes;Temperature|Global Mean;K;;Bal;;2100;;;1.5;1.55;;;;
-relative;yes;Emi|CO2;Mt CO2/yr;;;;2030;-0.5;-0.3;;;;;2020;
-relative;yes;Emi|CO2;Mt CO2/yr;;;;2030;-0.6;-0.4;;;;;2015;
-relative;no;FE;EJ/yr;;;;2030, 2040;-0.4;-0.2;;;;;2020;
-absolute;yes;Price|Secondary Energy|Electricity;US$2005/GJ;;Bal;;;5.56;;;;;;;
-growthrate;yes;New Cap|Electricity|Solar|PV;GW/yr;;;;;;;0.5;1;;;;
-relative;yes;Price|Carbon;US$2005/t CO2;;Bal;;2030, 2040, 2050;0;;;;;NPi;;
+Deviation to historical data;;;;;;;;;;;;;;;
+relative;yes;Emi|CO2|Energy;Mt CO2/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Demand|Transport;Mt CO2/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Demand|Buildings;Mt CO2/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Demand|Industry;Mt CO2/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;EDGAR8;historical;;
+relative;yes;Emi|CO2|Energy|Supply;Mt CO2/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;EDGAR8;historical;;
+relative;yes;Emi|CO2|Industrial Processes;Mt CO2/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;EDGAR8;historical;;
+relative;yes;PE|Coal;EJ/yr;;;;2005-2020;-0.3;-0.15;0.15;0.3;BP, IEA;historical;;
+relative;yes;PE|Oil;EJ/yr;;;;2005-2020;-0.3;-0.15;0.15;0.3;BP, IEA;historical;;
+relative;yes;PE|Gas;EJ/yr;;;;2005-2020;-0.3;-0.15;0.15;0.3;BP, IEA;historical;;
+relative;yes;SE|Electricity;EJ/yr;;;;2005-2020;-0.3;-0.15;0.15;0.3;Ember, BP;historical;;
+relative;yes;SE|Electricity|*;EJ/yr;;;;2005-2020;-0.3;-0.15;0.15;0.3;Ember, BP;historical;;
+relative;yes;FE;EJ/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;IEA;historical;;
+relative;yes;FE|*;EJ/yr;;;;2005-2020;-0.4;-0.2;0.2;0.4;IEA;historical;;
+relative;yes;Cap|Electricity|*;GW;;;;2005-2020;-0.4;-0.2;0.2;0.4;Ember;historical;;
+;;;;;;;;;;;;;;;
+Near-term realism;;;;;;;;;;;;;;;
+relative;yes;FE;EJ/yr;;;;2030;-0.4;-0.2;;;;;2020;Survey: Felix
+relative;yes;Emi|GHG;Mt CO2/yr;;;;2030;-0.5;-0.3;;;;;2020;Survey: Felix
+absolute;yes;Emi|CO2;Mt CO2/yr;;;World;2025;39816;;;;;;;"based on Elmars assumptions on max. reduction scenarios:
+2019: 37.65Gt (EDGAR, wo LULUCF). 2025 (-3.4%): 36.37Gt + 3.45Gt LULUCF = 39.82Gt CO2"
+absolute;yes;Emi|CO2;Mt CO2/yr;;;World;2030;30987;;;;;;;2030 (-23%): 28.99Gt + 2.0Gt LULUCF = 30.99Gt CO2
+absolute;yes;Emi|CH4;Mt CH4/yr;;;World;2040;100;;;1000;;;;AR6 WG3 Annex III, Table 11
+absolute;yes;Carbon Management|Storage;Mt CO2/yr;;;World;2030;;;;2000;;;;AR6 WG3 Annex III, Table 11
+absolute;yes;SE|Electricity|Nuclear;EJ/yr;;;World;2030;;;;20;;;;AR6 WG3 Annex III, Table 11
+;;;;;;;;;;;;;;;
+Absolute technical/geological limits;;;;;;;;;;;;;;;
+growthrate;yes;New Cap|Electricity|Solar|PV;GW/yr;;;;2020-2100;;;0.5;1;;;;Survey: Felix
+absolute;yes;Carbon Management|Storage;Mt CO2/yr;;;World;2005-2050;;;;5000;;;;https://www.sciencedirect.com/science/article/pii/S1750583622001840
+absolute;yes;Carbon Management|Storage;Mt CO2/yr;;;World;2060-2100;;;;8600;;;;https://www.sciencedirect.com/science/article/pii/S1750583622001840
+absolute;yes;PE|Biomass;EJ/yr;;;World;;;;100;240;;;;"from ESABCC, based on Creutzig et al. ""Bioenergy and Climate Change Mitigation: An
+Assessment"" (2015), Frank et al. ""and-Based Climate
+Change Mitigation Potentials within the Agenda for Sustainable Development"" (2021)"
+;;;;;;;;;;;;;;;
+Scenario specific;;;;;;;;;;;;;;;
+absolute;yes;Temperature|Global Mean;K;;SSP2EU-EU21-PkBudg500-AMT, SSP2EU-PkBudg500-AMT;;2100;;;1.5;1.6;;;;corresponds to C1 category
+absolute;yes;Temperature|Global Mean;K;;SDP_MC-PkBudg650-AMT, SSP1-PkBudg650-AMT, SSP2EU-EU21-PkBudg650-AMT, SSP2EU-PkBudg650-AMT, SSP5-PkBudg650;;2100;;;;1.8;;;;C2? Or also C1?
diff --git a/inst/config/validationConfig_sanityChecks.csv b/inst/config/validationConfig_sanityChecks.csv
new file mode 100644
index 0000000..d79f668
--- /dev/null
+++ b/inst/config/validationConfig_sanityChecks.csv
@@ -0,0 +1,8 @@
+metric;critical;variable;unit;model;scenario;region;period;min_red;min_yel;max_yel;max_red;ref_model;ref_scenario;ref_period;source/link to discussion
+Sanity checks;;;;;;;;;;;;;;;
+absolute;yes;FE|**;;;;;;0;;;;;;;
+absolute;yes;SE|**;;;;;;0;;;;;;;
+absolute;yes;SE|Hydrogen|Net Imports;;;;;;-10000;;;;;;;overwrite min for the one SE variable that can be negative
+absolute;yes;PE|**;;;;;;0;;;;;;;
+absolute;yes;Emi|**|Fossil;;;;;;0;;;;;;;
+absolute;yes;**|Share;;;;;;0;;;100;;;;