Merge pull request #440 from pik-piam/fixCO2AFOLU

update CO2 AFOLU mappings

.buildlibrary

@@ -1,4 +1,4 @@
-ValidationKey: '8491484'
+ValidationKey: '8511606'
 AutocreateReadme: yes
 allowLinterWarnings: no
 AddInReadme: tutorial.md

CITATION.cff

@@ -2,7 +2,7 @@ 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.42.2
+version: 0.42.3
 date-released: '2025-02-03'
 abstract: Project specific interfaces to REMIND / MAgPIE.
 authors:

DESCRIPTION

@@ -1,7 +1,7 @@
 Type: Package
 Package: piamInterfaces
 Title: Project specific interfaces to REMIND / MAgPIE
-Version: 0.42.2
+Version: 0.42.3
 Date: 2025-02-03
 Authors@R: c(
     person("Falk", "Benke", , "[email protected]", role = c("aut", "cre")),

README.md

@@ -1,6 +1,6 @@
 # Project specific interfaces to REMIND / MAgPIE
 
-R package **piamInterfaces**, version **0.42.2**
+R package **piamInterfaces**, version **0.42.3**
 
 [![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)
 
@@ -143,7 +143,7 @@ In case of questions / problems please contact Falk Benke <[email protected]>
 
 To cite package **piamInterfaces** in publications use:
 
-Benke F, Richters O (2025). "piamInterfaces: Project specific interfaces to REMIND / MAgPIE." Version: 0.42.2, <https://github.com/pik-piam/piamInterfaces>.
+Benke F, Richters O (2025). "piamInterfaces: Project specific interfaces to REMIND / MAgPIE." Version: 0.42.3, <https://github.com/pik-piam/piamInterfaces>.
 
 A BibTeX entry for LaTeX users is
 
@@ -154,6 +154,6 @@ A BibTeX entry for LaTeX users is
   date = {2025-02-03},
   year = {2025},
   url = {https://github.com/pik-piam/piamInterfaces},
-  note = {Version: 0.42.2},
+  note = {Version: 0.42.3},
 }
 ```

inst/mappings/mapping_ScenarioMIP.csv

@@ -701,8 +701,9 @@ Carbon Removal;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from atmospher
 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|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|Timber|Buildings|+|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|Land|Land-use Change|Timber|Storage in HWP|+|Industrial Roundwood;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|Timber|Storage in HWP|+|Buildings;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|+|Cropland Tree Cover;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;
@@ -713,7 +714,7 @@ Carbon Removal|Geological Storage|Other Sources;Mt CO2/yr;1;Gross removals of ca
 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|Synthetic Fuels CCS;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.;;;;;;;
+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.;;Emissions|CO2|Land|Land-use Change|Regrowth|+|Cropland Tree Cover;Mt CO2/yr;-1;;M;
 Carbon Removal|Land Use|Biochar;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through conversion of biomass to recalcitrant carbon via pyrolysis and its subsequent application to croplands to increase soil carbon stocks;Values should be reported as positive numbers.;;;;;;;
 Carbon Removal|Land Use|Forest Management;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through improved forest management;Values should be reported as positive numbers.;;;;;;;
 Carbon Removal|Land Use|Other;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through other land-related CDR methods;Values should be reported as positive numbers.;;;;;;;
@@ -726,12 +727,12 @@ Carbon Removal|Land Use|Soil Carbon Management;Mt CO2/yr;2;Gross removals of car
 Carbon Removal|Land Use|Soil Carbon Management|Cropland;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through enhancing the carbon content of cropland soils;Values should be reported as positive numbers.;;;;;;;
 Carbon Removal|Land Use|Soil Carbon Management|Grassland;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through enhancing the carbon content of grassland soils;Values should be reported as positive numbers.;;;;;;;
 Carbon Removal|Long-Lived Materials;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through long-lived materials;Values should be reported as positive numbers.;;Emi|CO2|CDR|Materials;Mt CO2/yr;-1;;R;
-Carbon Removal|Long-Lived Materials;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through long-lived materials;Values should be reported as positive numbers.;;Emissions|CO2|Long-Lived Material|Timber|Industrial Roundwood|+|Inflow;Mt CO2/yr;-1;;M;
-Carbon Removal|Long-Lived Materials;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through long-lived materials;Values should be reported as positive numbers.;;Emissions|CO2|Long-Lived Material|Timber|Buildings|+|Inflow;Mt CO2/yr;-1;;M;
+Carbon Removal|Long-Lived Materials;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through long-lived materials;Values should be reported as positive numbers.;;Emissions|CO2|Land|Land-use Change|Timber|Storage in HWP|+|Industrial Roundwood;Mt CO2/yr;-1;;M;
+Carbon Removal|Long-Lived Materials;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) through long-lived materials;Values should be reported as positive numbers.;;Emissions|CO2|Land|Land-use Change|Timber|Storage in HWP|+|Buildings;Mt CO2/yr;-1;;M;
 Carbon Removal|Long-Lived Materials|Other;Mt CO2/yr;2;Gross removals of carbon dioxide (CO2) through other long-lived materials where the carbon is stored on centennial or longer timescales;Values should be reported as positive numbers.;;Emi|CO2|CDR|Materials|+|Non-Plastics;Mt CO2/yr;-1;;R;
 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|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|Timber|Buildings|+|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|Land|Land-use Change|Timber|Storage in HWP|+|Industrial Roundwood;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|Land|Land-use Change|Timber|Storage in HWP|+|Buildings;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.;;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.;;;;;;;
@@ -4893,7 +4894,8 @@ Gross Emissions|CO2;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2), not acc
 Gross Emissions|CO2|AFOLU;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), not including any removals from the atmosphere (e.g., biochar);Emissions reported in this category represent fluxes from the land pool to the atmosphere. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|+|Deforestation;Mt CO2/yr;;;M;linear
 Gross Emissions|CO2|AFOLU;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), not including any removals from the atmosphere (e.g., biochar);Emissions reported in this category represent fluxes from the land pool to the atmosphere. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|+|Other land conversion;Mt CO2/yr;;;M;linear
 Gross Emissions|CO2|AFOLU;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), not including any removals from the atmosphere (e.g., biochar);Emissions reported in this category represent fluxes from the land pool to the atmosphere. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|+|Peatland;Mt CO2/yr;;;M;linear
-Gross Emissions|CO2|AFOLU;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), not including any removals from the atmosphere (e.g., biochar);Emissions reported in this category represent fluxes from the land pool to the atmosphere. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|Timber|+|Wood Harvest;Mt CO2/yr;;;M;linear
+Gross Emissions|CO2|AFOLU;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), not including any removals from the atmosphere (e.g., biochar);Emissions reported in this category represent fluxes from the land pool to the atmosphere. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|+|Wood Harvest;Mt CO2/yr;;;M;linear
+Gross Emissions|CO2|AFOLU;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), not including any removals from the atmosphere (e.g., biochar);Emissions reported in this category represent fluxes from the land pool to the atmosphere. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|SOM|+|Emissions;Mt CO2/yr;;;M;linear
 Gross Emissions|CO2|Energy;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from energy use, including fugitive emissions from fuels (IPCC category 1A, 1B), not accounting for removals from the atmosphere;;;Emi|CO2|w/ Bunkers|Gross|Energy;Mt CO2/yr;;mapping taken from NAVIGATE, NAVIGATE category: emissions (CO2);R;linear
 Gross Emissions|CO2|Energy and Industrial Processes;Mt CO2/yr;2;Gross emissions of carbon dioxide (CO2) from energy use in supply and demand sectors (IPCC category 1A, 1B) and from industrial processes (IPCC categories 1A2, 1A5, 2A, 2B, 2C, 2E), including emissions from international bunker fuels, not accounting for removals from the atmosphere;;;Emi|CO2|w/ Bunkers|Gross|Energy and Industrial Processes;Mt CO2/yr;;mapping taken from NAVIGATE, NAVIGATE category: emissions (CO2);R;linear
 Gross Emissions|CO2|Energy|Demand;Mt CO2/yr;1;Gross emissions of carbon dioxide (CO2) from fuel combustion in industry (IPCC category 1A2), residential, commercial, institutional sectors and agriculture, forestry, fishing (AFOFI) (IPCC category 1A4a, 1A4b, 1A4c), and the transportation sector (IPCC category 1A3), excluding pipeline emissions (IPCC category 1A3ei), not accounting for removals from the atmosphere;;;Emi|CO2|w/ Bunkers|Gross|Energy|Demand;Mt CO2/yr;;mapping taken from NAVIGATE, NAVIGATE category: emissions (CO2);R;linear
@@ -4948,7 +4950,7 @@ Gross Emissions|CO2|Industrial Processes;Mt CO2/yr;1;Gross emissions of carbon d
 Gross Removals|CO2;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) excluding positive emissions, including removals from bioenergy with CCS (BECCS), direct air carbon capture and agriculture, forestry and other land use (AFOLU);Net emissions 'Emissions|CO2' = 'Gross Emissions|CO2' + 'Gross Removals|CO2'.;;;;;;;linear
 Gross Removals|CO2|AFOLU;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), including intentional carbon dioxide removals ('Carbon Removal|Land Use') and all un-intentional or indirect removals, e.g. from regrowth of natural vegetation after land abandonment, regrowth of forests after wood harvest or regrowth of timber plantations;Removals reported in this category represent fluxes from the atmosphere to the land pool. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|+|Regrowth;Mt CO2/yr;;;M;linear
 Gross Removals|CO2|AFOLU;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), including intentional carbon dioxide removals ('Carbon Removal|Land Use') and all un-intentional or indirect removals, e.g. from regrowth of natural vegetation after land abandonment, regrowth of forests after wood harvest or regrowth of timber plantations;Removals reported in this category represent fluxes from the atmosphere to the land pool. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|Timber|+|Storage in HWP;Mt CO2/yr;;;M;linear
-Gross Removals|CO2|AFOLU;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), including intentional carbon dioxide removals ('Carbon Removal|Land Use') and all un-intentional or indirect removals, e.g. from regrowth of natural vegetation after land abandonment, regrowth of forests after wood harvest or regrowth of timber plantations;Removals reported in this category represent fluxes from the atmosphere to the land pool. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|+|SOM;Mt CO2/yr;;;M;linear
+Gross Removals|CO2|AFOLU;Mt CO2/yr;1;Gross removals of carbon dioxide (CO2) from agriculture, forestry and other land use (IPCC 1996 category 4, 5 - IPCC 2006 category 3), including intentional carbon dioxide removals ('Carbon Removal|Land Use') and all un-intentional or indirect removals, e.g. from regrowth of natural vegetation after land abandonment, regrowth of forests after wood harvest or regrowth of timber plantations;Removals reported in this category represent fluxes from the atmosphere to the land pool. Net emissions 'Emissions|CO2|AFOLU' = 'Gross Emissions|CO2|AFOLU' + 'Gross Removals|CO2|AFOLU'.;;Emissions|CO2|Land|Land-use Change|SOM|+|Withdrawals;Mt CO2/yr;;;M;linear
 Harvested Area|Forestry;million ha/yr;2;Total timber harvest/production area (= sum of timber plantations, and other productive forest that is being harvested);;;Resources|Timber operations|Harvested area for timber|Total;mha per yr;1;;M;
 Health|Child Mortality;million;;Child mortality;;;;;;;;
 Health|Child Mortality|Indoor Air Pollution;million;;Child mortality associated with indoor air pollution;;;;;;;;