From a79a179fc8bbfa58406f6207d4041363cad6232f Mon Sep 17 00:00:00 2001
From: Paul Natsuo Kishimoto <mail@paul.kishimoto.name>
Date: Wed, 2 Oct 2024 16:42:21 +0200
Subject: [PATCH] Add "emission" code list

---
 doc/pkg-data/codelists.rst                    |  6 ++
 message_ix_models/data/emission.yaml          | 75 +++++++++++++++++++
 .../tests/model/test_structure.py             |  1 +
 3 files changed, 82 insertions(+)
 create mode 100644 message_ix_models/data/emission.yaml

diff --git a/doc/pkg-data/codelists.rst b/doc/pkg-data/codelists.rst
index 114e1734b3..831ac89808 100644
--- a/doc/pkg-data/codelists.rst
+++ b/doc/pkg-data/codelists.rst
@@ -25,6 +25,12 @@ These codes have the following annotations:
 .. literalinclude:: ../../message_ix_models/data/commodity.yaml
    :language: yaml
 
+Emission species (:file:`emission.yaml`)
+========================================
+
+.. literalinclude:: ../../message_ix_models/data/emission.yaml
+   :language: yaml
+
 .. _level-yaml:
 
 Levels (``level.yaml``)
diff --git a/message_ix_models/data/emission.yaml b/message_ix_models/data/emission.yaml
new file mode 100644
index 0000000000..481da3c21e
--- /dev/null
+++ b/message_ix_models/data/emission.yaml
@@ -0,0 +1,75 @@
+BCA:
+  name: Black carbon
+  report: BC
+
+CH4:
+  name: Methane
+
+CO:
+  name: Carbon monoxide
+
+CO2:
+  name: Carbon dioxide
+
+N2O:
+  name: Nitrous oxide
+
+NH3:
+  name: Ammonia
+
+NOx:
+  name: Nitrogen oxides
+
+OCA:
+  name: Organic carbon
+  report: OC
+
+SO2:
+  name: Sulfur dioxide
+  report: Sulfur
+
+VOC:
+  name: Volatile organic compounds
+
+# The following codes also appear in
+# ixmp://ixmp-dev/SSP_dev_SSP4_v0.1_Blv0.18/materials_low_dem_scen#1
+# (2024-10-02) but are not currently used by code in message_ix_models.
+#
+# Agri_CH4
+# Agri_N2O
+# Agri_N2O_calc
+# BCA_LandUseChangeEM
+# BCA_SavanBurnEM
+# CF4
+# CH4_LandUseChangeEM
+# CH4_SavanBurnEM
+# CO_LandUseChangeEM
+# CO_SavanBurnEM
+# CO2_industry
+# CO2_transformation
+# CO2_transport
+# HFC
+# LU_CH4
+# LU_CH4_Agri
+# LU_CH4_BioBurn
+# LU_CO2
+# LU_N2O
+# NH3_LandUseChangeEM
+# NH3_ManureEM
+# NH3_RiceEM
+# NH3_SavanBurnEM
+# NH3_SoilEM
+# NOx_LandUseChangeEM
+# NOx_SavanBurnEM
+# NOx_SoilEM
+# OCA_LandUseChangeEM
+# OCA_SavanBurnEM
+# PM2p5
+# SF6
+# SO2_LandUseChangeEM
+# SO2_SavanBurnEM
+# TCE
+# TCE_CO2
+# TCE_non-CO2
+# VOC_LandUseChangeEM
+# VOC_SavanBurnEM
diff --git a/message_ix_models/tests/model/test_structure.py b/message_ix_models/tests/model/test_structure.py
index be4c788c9f..3924250a0f 100644
--- a/message_ix_models/tests/model/test_structure.py
+++ b/message_ix_models/tests/model/test_structure.py
@@ -54,6 +54,7 @@ class TestGetCodes:
         (
             "cd_links/unit",
             "commodity",
+            "emission",
             "level",
             "node/ISR",
             "node/R11",