Merge pull request #420 from laurinks/master

Extend ScenarioMIP mapping for Carbon Capture and Removal

.buildlibrary

@@ -1,4 +1,4 @@
-ValidationKey: '7728490'
+ValidationKey: '7748950'
 AutocreateReadme: yes
 allowLinterWarnings: no
 AddInReadme: tutorial.md
@@ -8,3 +8,4 @@ AcceptedWarnings:
 AcceptedNotes: checking installed package size
 enforceVersionUpdate: yes
 skipCoverage: no
+AutocreateCITATION: yes

CITATION.cff

@@ -2,8 +2,8 @@ cff-version: 1.2.0
 message: If you use this software, please cite it using the metadata from this file.
 type: software
 title: 'piamInterfaces: Project specific interfaces to REMIND / MAgPIE'
-version: 0.38.5
-date-released: '2024-12-17'
+version: 0.38.6
+date-released: '2024-12-18'
 abstract: Project specific interfaces to REMIND / MAgPIE.
 authors:
 - family-names: Benke

DESCRIPTION

@@ -1,8 +1,8 @@
 Type: Package
 Package: piamInterfaces
 Title: Project specific interfaces to REMIND / MAgPIE
-Version: 0.38.5
-Date: 2024-12-17
+Version: 0.38.6
+Date: 2024-12-18
 Authors@R: c(
     person("Falk", "Benke", , "[email protected]", role = c("aut", "cre")),
     person("Oliver", "Richters", role = "aut")

README.md

@@ -1,6 +1,6 @@
 # Project specific interfaces to REMIND / MAgPIE
 
-R package **piamInterfaces**, version **0.38.5**
+R package **piamInterfaces**, version **0.38.6**
 
 [![CRAN status](https://www.r-pkg.org/badges/version/piamInterfaces)](https://cran.r-project.org/package=piamInterfaces) [![R build status](https://github.com/pik-piam/piamInterfaces/workflows/check/badge.svg)](https://github.com/pik-piam/piamInterfaces/actions) [![codecov](https://codecov.io/gh/pik-piam/piamInterfaces/branch/master/graph/badge.svg)](https://app.codecov.io/gh/pik-piam/piamInterfaces) [![r-universe](https://pik-piam.r-universe.dev/badges/piamInterfaces)](https://pik-piam.r-universe.dev/builds)
 
@@ -117,16 +117,17 @@ In case of questions / problems please contact Falk Benke <[email protected]>
 
 To cite package **piamInterfaces** in publications use:
 
-Benke F, Richters O (2024). _piamInterfaces: Project specific interfaces to REMIND / MAgPIE_. R package version 0.38.5, <https://github.com/pik-piam/piamInterfaces>.
+Benke F, Richters O (2024). "piamInterfaces: Project specific interfaces to REMIND / MAgPIE." Version: 0.38.6, <https://github.com/pik-piam/piamInterfaces>.
 
 A BibTeX entry for LaTeX users is
 
  ```latex
-@Manual{,
+@Misc{,
   title = {piamInterfaces: Project specific interfaces to REMIND / MAgPIE},
   author = {Falk Benke and Oliver Richters},
+  date = {2024-12-18},
   year = {2024},
-  note = {R package version 0.38.5},
   url = {https://github.com/pik-piam/piamInterfaces},
+  note = {Version: 0.38.6},
 }
 ```

inst/mappings/mapping_ScenarioMIP.csv

@@ -524,14 +524,15 @@ Capital Stock;billion USD_2010/yr;;Macroeconomic capital stock;;;;;;;
 Carbon Capture;Mt CO2/yr;1;Total amount of carbon dioxide (CO2) captured either from the atmosphere, directly from oceans, or from point sources as energy use in supply and demand sectors (IPCC category 1A, 1B) or industrial processes (IPCC categories 2A, B, C, E);;;Carbon Management|Carbon Capture;Mt CO2/yr;;;R
 Carbon Capture|Direct Air Capture;Mt CO2/yr;1;Captured carbon dioxide (CO2) from direct air capture;Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|DAC;Mt CO2/yr;;;R
 Carbon Capture|Direct Ocean Capture;Mt CO2/yr;1;Captured carbon dioxide (CO2) from direct ocean capture;Values should be reported as positive numbers.;;;;;;
-Carbon Capture|Energy;Mt CO2/yr;1;Captured carbon dioxide (CO2) from energy use in supply and demand sectors (IPCC category 1A, 1B);Values should be reported as positive numbers.;;;;;;
+Carbon Capture|Energy;Mt CO2/yr;1;Captured carbon dioxide (CO2) from energy use in supply and demand sectors (IPCC category 1A, 1B);Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|Biomass|Pe2Se;Mt CO2/yr;;;R
+Carbon Capture|Energy;Mt CO2/yr;1;Captured carbon dioxide (CO2) from energy use in supply and demand sectors (IPCC category 1A, 1B);Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|Fossil|Pe2Se;Mt CO2/yr;;;R
+Carbon Capture|Energy;Mt CO2/yr;1;Captured carbon dioxide (CO2) from energy use in supply and demand sectors (IPCC category 1A, 1B);Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|Industry Energy;Mt CO2/yr;;;R
 Carbon Capture|Energy|Biomass;Mt CO2/yr;1;Captured carbon dioxide (CO2) from purpose-grown bioenergy crops, biogas, crop and forestry residue, municipal solid waste bioenergy and traditional biomass in supply and demand sectors (IPCC category 1A, 1B);Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|Biomass|Pe2Se;Mt CO2/yr;;;R
 Carbon Capture|Energy|Biomass;Mt CO2/yr;1;Captured carbon dioxide (CO2) from purpose-grown bioenergy crops, biogas, crop and forestry residue, municipal solid waste bioenergy and traditional biomass in supply and demand sectors (IPCC category 1A, 1B);Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|Industry Energy|+|Biomass;Mt CO2/yr;;;R
-Carbon Capture|Energy|Demand;Mt CO2/yr;2;Captured carbon dioxide (CO2) during energy consumption;Values should be reported as positive numbers.;;;;;;
-Carbon Capture|Energy|Demand|Biomass;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of purpose-grown bioenergy crops, biogas, crop and forestry residue, municipal solid waste bioenergy and traditional biomass;Values should be reported as positive numbers.;;;;;;
-Carbon Capture|Energy|Demand|Fossil;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of fossil fuels including coal, natural gas and conventional/unconventional oil;Values should be reported as positive numbers.;;;;;;
+Carbon Capture|Energy|Demand;Mt CO2/yr;2;Captured carbon dioxide (CO2) during energy consumption;Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|Industry Energy;Mt CO2/yr;;;R
+Carbon Capture|Energy|Demand|Biomass;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of purpose-grown bioenergy crops, biogas, crop and forestry residue, municipal solid waste bioenergy and traditional biomass;Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|Industry Energy|+|Biomass;Mt CO2/yr;;;R
+Carbon Capture|Energy|Demand|Fossil;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of fossil fuels including coal, natural gas and conventional/unconventional oil;Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|Industry Energy|+|Fossil;Mt CO2/yr;;;R
 Carbon Capture|Energy|Demand|Industry;Mt CO2/yr;2;Captured carbon dioxide (CO2) during energy consumption in industry;Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|Industry Energy;Mt CO2/yr;;;R
-Carbon Capture|Energy|Demand|Industry;Mt CO2/yr;2;Captured carbon dioxide (CO2) during energy consumption in industry;Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|+|Industry Process;Mt CO2/yr;;;R
 Carbon Capture|Energy|Demand|Industry|Biomass;Mt CO2/yr;2;Captured carbon dioxide (CO2) during use of purpose-grown bioenergy crops, biogas, crop and forestry residue, municipal solid waste bioenergy and traditional biomass in industry;Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|Industry Energy|+|Biomass;Mt CO2/yr;;;R
 Carbon Capture|Energy|Demand|Industry|Chemicals;Mt CO2/yr;2;Captured carbon dioxide (CO2) during energy consumption in production of chemicals;Values should be reported as positive numbers.;;;;;;
 Carbon Capture|Energy|Demand|Industry|Chemicals|Biomass;Mt CO2/yr;2;Captured carbon dioxide (CO2) during use of purpose-grown bioenergy crops, biogas, crop and forestry residue, municipal solid waste bioenergy and traditional biomass in production of chemicals;Values should be reported as positive numbers.;;;;;;
@@ -580,7 +581,7 @@ Carbon Capture|Energy|Demand|Industry|Synthetic Fuels;Mt CO2/yr;2;Captured carbo
 Carbon Capture|Energy|Demand|Industry|Synthetic Fuels|Carbon-Neutral;Mt CO2/yr;2;Captured carbon dioxide (CO2) during use of synthetic fuels produced from carbon captured directly or indirectly from the atmosphere, e.g. using carbon-capture-and-utilization (CCU) from biomass or Direct Air Capture (DAC), not derived from fossil fuels in industry;Values should be reported as positive numbers.;;;;;;
 Carbon Capture|Energy|Demand|Industry|Synthetic Fuels|Fossil;Mt CO2/yr;2;Captured carbon dioxide (CO2) during use of synthetic fuels produced from carbon-capture-and-utilization (CCU) of fossil fuels in industry;Values should be reported as positive numbers.;;;;;;
 Carbon Capture|Energy|Demand|Industry|Synthetic Fuels|Industrial Processes;Mt CO2/yr;2;Captured carbon dioxide (CO2) during use of synthetic fuels produced from carbon-capture-and-utilization (CCU) of industrial processes in industry;Values should be reported as positive numbers.;;;;;;
-Carbon Capture|Energy|Demand|Synthetic Fuels;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of synthetic fuels produced from carbon captured from fossil fuels and directly or indirectly from the atmosphere, e.g. using carbon-capture- and-utilization (CCU) from biomass or fossil fuels or Direct Air Capture (DAC);Values should be reported as positive numbers.;;;;;;
+Carbon Capture|Energy|Demand|Synthetic Fuels;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of synthetic fuels produced from carbon captured from fossil fuels and directly or indirectly from the atmosphere, e.g. using carbon-capture- and-utilization (CCU) from biomass or fossil fuels or Direct Air Capture (DAC);Values should be reported as positive numbers.;;Carbon Management|Carbon Capture|Industry Energy|+|Synfuel;Mt CO2/yr;;;R
 Carbon Capture|Energy|Demand|Synthetic Fuels|Carbon-Neutral;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of synthetic fuels produced from carbon captured directly or indirectly from the atmosphere, e.g. using carbon-capture-and-utilization (CCU) from biomass or Direct Air Capture (DAC), not derived from fossil fuels;Values should be reported as positive numbers.;;;;;;
 Carbon Capture|Energy|Demand|Synthetic Fuels|Fossil;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of synthetic fuels produced from carbon-capture-and-utilization (CCU) of fossil fuels;Values should be reported as positive numbers.;;;;;;
 Carbon Capture|Energy|Demand|Synthetic Fuels|Industrial Processes;Mt CO2/yr;2;Captured carbon dioxide (CO2) during direct consumption of synthetic fuels produced from carbon-capture-and-utilization (CCU) of industrial processes;Values should be reported as positive numbers.;;;;;;
@@ -670,14 +671,19 @@ Carbon Capture|Utilization|Materials|Long-Lived;Mt CO2/yr;2;Captured carbon diox
 Carbon Capture|Utilization|Materials|Short-Lived;Mt CO2/yr;2;Captured carbon dioxide (CO2) that is used to produce short-lived materials where the captured carbon is re-emitted to the atmosphere upon consumption of these products or within annual to decadal timescales (e.g., plastics);;;;;;;
 Carbon Capture|Utilization|Other;Mt CO2/yr;2;Captured carbon dioxide (CO2) that is used to produce other short-lived products;;;;;;;
 Carbon Removal;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through deliberate human activities;Values should be reported as positive numbers.;;Emi|CO2|CDR;Mt CO2/yr;-1;mapping taken from NAVIGATE, NAVIGATE category: carbon management;R
+Carbon Removal;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through deliberate human activities;Values should be reported as positive numbers.;;Emi|CO2|CDR|Land-Use Change;Mt CO2/yr;1;;R
+Carbon Removal;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through deliberate human activities;Values should be reported as positive numbers.;;Emissions|CO2|Land|Land-use Change|Regrowth|+|CO2-price AR;Mt CO2/yr;-1;;M
+Carbon Removal;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through deliberate human activities;Values should be reported as positive numbers.;;Emissions|CO2|Land|Land-use Change|Regrowth|+|NPI_NDC AR;Mt CO2/yr;-1;;M
+Carbon Removal;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through deliberate human activities;Values should be reported as positive numbers.;;Emissions|CO2|Long-Lived Material RAW|Timber|Industrial Roundwood|+|Inflow;Mt CO2/yr;-1;;M
+Carbon Removal;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through deliberate human activities;Values should be reported as positive numbers.;;Emissions|CO2|Long-Lived Material RAW|Timber|Buildings|+|Inflow;Mt CO2/yr;-1;;M
 Carbon Removal|Enhanced Weathering;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) by terrestrial application of alkalinity to increase CO2 uptake on land;Values should be reported as positive numbers.;;Emi|CO2|CDR|EW;Mt CO2/yr;-1;mapping taken from NAVIGATE, NAVIGATE category: carbon management;R
 Carbon Removal|Geological Storage;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through geological storage;Values should be reported as positive numbers.;;Emi|CO2|CDR|BECCS;Mt CO2/yr;-1;;R
 Carbon Removal|Geological Storage;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through geological storage;Values should be reported as positive numbers.;;Emi|CO2|CDR|DACCS;Mt CO2/yr;-1;;R
 Carbon Removal|Geological Storage;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospheric origin or biomass through geological storage;Values should be reported as positive numbers.;;Emi|CO2|CDR|Industry CCS|Synthetic Fuels;Mt CO2/yr;-1;;R
-Carbon Removal|Geological Storage|Biomass;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through geological storage of CO2 from biogenic orgin, i.e., bioenergy with carbon capture and storage (BECCS);Values should be reported as positive numbers.;;;;;;
-Carbon Removal|Geological Storage|Direct Air Capture;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through direct air capture in combination with carbon-capture and sequestration (CCS);Values should be reported as positive numbers.;;;;;;
+Carbon Removal|Geological Storage|Biomass;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through geological storage of CO2 from biogenic orgin, i.e., bioenergy with carbon capture and storage (BECCS);Values should be reported as positive numbers.;;Emi|CO2|CDR|BECCS;Mt CO2/yr;;;R
+Carbon Removal|Geological Storage|Direct Air Capture;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through direct air capture in combination with carbon-capture and sequestration (CCS);Values should be reported as positive numbers.;;Emi|CO2|CDR|DACCS;Mt CO2/yr;-1;;R
 Carbon Removal|Geological Storage|Other Sources;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through geological storage of CO2 from other sources, not including carbon from fossil fuels;Values should be reported as positive numbers.;;;;;;
-Carbon Removal|Geological Storage|Synthetic Fuels;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through geological storage of CO2 captured from burning synthetic fuels produced from carbon-capture-and-utilization (CCU), not derived from fossil fuels;Values should be reported as positive numbers.;;;;;;
+Carbon Removal|Geological Storage|Synthetic Fuels;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through geological storage of CO2 captured from burning synthetic fuels produced from carbon-capture-and-utilization (CCU), not derived from fossil fuels;Values should be reported as positive numbers.;;Emi|CO2|CDR|Industry CCS|Synthetic Fuels;Mt CO2/yr;;;R
 Carbon Removal|Land Use;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through land-based sinks (e.g., afforestation, soil carbon enhancement, biochar);Values should be reported as positive numbers.;;Emissions|CO2|Land|Land-use Change|Regrowth|+|CO2-price AR;Mt CO2/yr;-1;;M
 Carbon Removal|Land Use;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through land-based sinks (e.g., afforestation, soil carbon enhancement, biochar);Values should be reported as positive numbers.;;Emissions|CO2|Land|Land-use Change|Regrowth|+|NPI_NDC AR;Mt CO2/yr;-1;;M
 Carbon Removal|Land Use|Agroforestry;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through intentionally integrating trees with crops or pasture on the same land;Values should be reported as positive numbers.;;;;;;
@@ -699,10 +705,10 @@ Carbon Removal|Long-Lived Materials|Other;Mt CO2/yr;2;Gross removals of carbon d
 Carbon Removal|Long-Lived Materials|Plastics;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through long-lived plastics where the carbon is stored on centennial or longer timescales;Values should be reported as positive numbers.;;Emi|CO2|CDR|Materials|+|Plastics;Mt CO2/yr;-1;;R
 Carbon Removal|Long-Lived Materials|Timber;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through timber in construction and other wood products where the carbon is stored on centennial or longer timescales;Values should be reported as positive numbers.;;Emissions|CO2|Long-Lived Material RAW|Timber|Industrial Roundwood|+|Inflow;Mt CO2/yr;-1;;M
 Carbon Removal|Long-Lived Materials|Timber;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through timber in construction and other wood products where the carbon is stored on centennial or longer timescales;Values should be reported as positive numbers.;;Emissions|CO2|Long-Lived Material RAW|Timber|Buildings|+|Inflow;Mt CO2/yr;-1;;M
-Carbon Removal|Ocean;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through ocean sinks;Values should be reported as positive numbers.;;;;;;
+Carbon Removal|Ocean;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through ocean sinks;Values should be reported as positive numbers.;;Emi|CO2|CDR|OAE;Mt CO2/yr;-1;;R
 Carbon Removal|Ocean|Direct Ocean Capture;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through direct removal of CO2 from the ocean through electrodialysis or other methods;Values should be reported as positive numbers.;;;;;;
 Carbon Removal|Ocean|Fertilization;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through stimulation of the primary production of phytoplankton and other organisms which contribute to ocean uptake of CO2 through direct nutrient addition or artificially upwelling deep nutrient-rich water;Values should be reported as positive numbers.;;;;;;
-Carbon Removal|Ocean|Ocean Alkalinity Enhancement;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through increasing ocean uptake of carbon through anthropogenic alkalinity addition;Values should be reported as positive numbers.;;;;;;
+Carbon Removal|Ocean|Ocean Alkalinity Enhancement;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through increasing ocean uptake of carbon through anthropogenic alkalinity addition;Values should be reported as positive numbers.;;Emi|CO2|CDR|OAE;Mt CO2/yr;-1;;R
 Carbon Removal|Ocean|Other;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through other ocean-based CDR methods;Values should be reported as positive numbers.;;;;;;
 Carbon Removal|Other;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) by other CDR methods and techniques;Values should be reported as positive numbers.;;;;;;
 Consumption;billion USD_2010/yr;1;total consumption of all goods, by all consumers in a region;;;Consumption;billion US$2017/yr;0.9096;mapping taken from NAVIGATE, NAVIGATE category: economy;R