diff --git a/_parts/custom.css b/_parts/custom.css index b4a98478..c92aa50a 100644 --- a/_parts/custom.css +++ b/_parts/custom.css @@ -126,8 +126,8 @@ body { opacity: 0.7; } -/* Home page tracks: technical documentation (brand blue) and user guide (amber). - The card tint and top rule tell the two tracks apart. */ +/* Home page tracks: technical documentation (brand blue), releases (green) and user guide (amber). + The card tint and top rule tell the tracks apart. */ .track-technical .myst-card { background-color: #eaf6fb; border-color: #9fd3e8; @@ -144,3 +144,11 @@ body { .track-user .myst-card:hover { border-color: #e08a1e; } +.track-releases .myst-card { + background-color: #edf7ee; + border-color: #a5d6a7; + border-top: 4px solid #2e9e4f; +} +.track-releases .myst-card:hover { + border-color: #2e9e4f; +} diff --git a/data/country_tiers.csv b/data/country_tiers.csv index b5d61b41..7d954ad0 100644 --- a/data/country_tiers.csv +++ b/data/country_tiers.csv @@ -1,149 +1,149 @@ iso3,country,tier,io_source,io_year,ghg_source,ghg_year -AFG,Afghanistan,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -ALB,Albania,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -DZA,Algeria,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -AGO,Angola,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -ATG,Antigua and Barbuda,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +AFG,Afghanistan,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +ALB,Albania,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +DZA,Algeria,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +AGO,Angola,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +ATG,Antigua and Barbuda,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 ARG,Argentina,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 AUS,Australia,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 AUT,Austria,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -BHS,Bahamas,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -BHR,Bahrain,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -BGD,Bangladesh,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -BRB,Barbados,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +BHS,Bahamas,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +BHR,Bahrain,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +BGD,Bangladesh,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +BRB,Barbados,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 BEL,Belgium,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -BLZ,Belize,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -BEN,Benin,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -BTN,Bhutan,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -BOL,Bolivia,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +BLZ,Belize,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +BEN,Benin,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +BTN,Bhutan,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +BOL,Bolivia,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 BRA,Brazil,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 BGR,Bulgaria,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -BFA,Burkina Faso,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -BDI,Burundi,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +BFA,Burkina Faso,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +BDI,Burundi,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 KHM,Cambodia,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -CMR,Cameroon,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +CMR,Cameroon,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 CAN,Canada,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 -CAF,Central African Republic,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -TCD,Chad,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +CAF,Central African Republic,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +TCD,Chad,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 CHL,Chile,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 CHN,China,1,China National Bureau of Statistics IO table,2023,"Built from OWID, CEDS, national energy statistics, and China's BTR1",2023 COL,Colombia,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -COG,Congo,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +COG,Congo,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 CRI,Costa Rica,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -CIV,Côte d'Ivoire,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +CIV,Côte d'Ivoire,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 HRV,Croatia,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 CYP,Cyprus,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 CZE,Czechia,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 DNK,Denmark,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -DMA,Dominica,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -DOM,Dominican Republic,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -ECU,Ecuador,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -EGY,Egypt,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -SLV,El Salvador,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -GNQ,Equatorial Guinea,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +DMA,Dominica,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +DOM,Dominican Republic,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +ECU,Ecuador,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +EGY,Egypt,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +SLV,El Salvador,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +GNQ,Equatorial Guinea,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 EST,Estonia,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -SWZ,Eswatini,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -ETH,Ethiopia,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -FJI,Fiji,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +SWZ,Eswatini,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +ETH,Ethiopia,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +FJI,Fiji,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 FIN,Finland,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 FRA,France,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -GAB,Gabon,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -GMB,Gambia,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +GAB,Gabon,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +GMB,Gambia,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 DEU,Germany,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 GRC,Greece,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -GRD,Grenada,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -GTM,Guatemala,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -GIN,Guinea,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -GNB,Guinea-Bissau,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -HTI,Haiti,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -HND,Honduras,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +GRD,Grenada,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +GTM,Guatemala,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +GIN,Guinea,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +GNB,Guinea-Bissau,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +HTI,Haiti,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +HND,Honduras,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 HKG,Hong Kong,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 HUN,Hungary,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 ISL,Iceland,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 IND,India,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 IDN,Indonesia,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 -IRN,Iran,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -IRQ,Iraq,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +IRN,Iran,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +IRQ,Iraq,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 IRL,Ireland,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 ISR,Israel,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 ITA,Italy,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -JAM,Jamaica,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -JPN,Japan,1,Input-Output Tables for Japan,2020,Environmental data published with the Japan IO tables,2020 -JOR,Jordan,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +JAM,Jamaica,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +JPN,Japan,1,Input-Output Tables for Japan,2020,NIES 3EID dataset,2020 +JOR,Jordan,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 KAZ,Kazakhstan,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -KEN,Kenya,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -KIR,Kiribati,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -KWT,Kuwait,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +KEN,Kenya,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +KIR,Kiribati,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +KWT,Kuwait,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 LAO,Laos,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 LVA,Latvia,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -LBN,Lebanon,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -LSO,Lesotho,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +LBN,Lebanon,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +LSO,Lesotho,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 LTU,Lithuania,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 LUX,Luxembourg,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -MWI,Malawi,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +MWI,Malawi,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 MYS,Malaysia,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -MDV,Maldives,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -MLI,Mali,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +MDV,Maldives,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +MLI,Mali,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 MLT,Malta,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -MUS,Mauritius,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +MUS,Mauritius,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 MEX,Mexico,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 -MDA,Moldova,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -MNG,Mongolia,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +MDA,Moldova,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +MNG,Mongolia,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 MAR,Morocco,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 MMR,Myanmar,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -NAM,Namibia,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -NRU,Nauru,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -NPL,Nepal,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +NAM,Namibia,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +NRU,Nauru,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +NPL,Nepal,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 NLD,Netherlands,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 NZL,New Zealand,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -NIC,Nicaragua,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -NER,Niger,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -NGA,Nigeria,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -MKD,North Macedonia,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +NIC,Nicaragua,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +NER,Niger,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +NGA,Nigeria,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +MKD,North Macedonia,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 NOR,Norway,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -OMN,Oman,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -PAK,Pakistan,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -PNG,Papua New Guinea,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -PRY,Paraguay,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +OMN,Oman,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +PAK,Pakistan,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +PNG,Papua New Guinea,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +PRY,Paraguay,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 PER,Peru,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 PHL,Philippines,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 POL,Poland,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 PRT,Portugal,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -QAT,Qatar,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +QAT,Qatar,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 ROU,Romania,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 RUS,Russia,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 -RWA,Rwanda,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -KNA,Saint Kitts and Nevis,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -LCA,Saint Lucia,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -VCT,Saint Vincent and the Grenadines,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -WSM,Samoa,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +RWA,Rwanda,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +KNA,Saint Kitts and Nevis,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +LCA,Saint Lucia,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +VCT,Saint Vincent and the Grenadines,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +WSM,Samoa,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 SAU,Saudi Arabia,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 -SEN,Senegal,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -SYC,Seychelles,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -SLE,Sierra Leone,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +SEN,Senegal,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +SYC,Seychelles,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +SLE,Sierra Leone,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 SGP,Singapore,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 SVK,Slovakia,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 SVN,Slovenia,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -SLB,Solomon Islands,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +SLB,Solomon Islands,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 ZAF,South Africa,2,"FIGARO, 2026 edition",2023,"FIGARO, from EDGAR with CEDS corrections",2023 KOR,South Korea,1,Bank of Korea IO tables,2018,GHG data published with the Bank of Korea IO tables,2018 ESP,Spain,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -LKA,Sri Lanka,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +LKA,Sri Lanka,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 SWE,Sweden,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 CHE,Switzerland,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 TWN,Taiwan,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -TZA,Tanzania,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +TZA,Tanzania,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 THA,Thailand,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 -TLS,Timor-Leste,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -TGO,Togo,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -TTO,Trinidad and Tobago,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +TLS,Timor-Leste,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +TGO,Togo,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +TTO,Trinidad and Tobago,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 TUN,Tunisia,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 TUR,Türkiye,2,"FIGARO, 2026 edition",2023,"FIGARO, from air emissions accounts",2023 -UGA,Uganda,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -UKR,Ukraine,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -ARE,United Arab Emirates,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +UGA,Uganda,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +UKR,Ukraine,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +ARE,United Arab Emirates,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 GBR,United Kingdom,1,ONS IO Analytical Tables,2023,ONS atmospheric emissions accounts,2023 USA,United States,0,Cornerstone nowcast Make and Use tables,2024,U.S. GHG inventory with facility data,2024 -URY,Uruguay,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 -VUT,Vanuatu,3,Tier 3 IO template,2020,"Tier 3 GHG template, scaled to national CO₂ total",2018 +URY,Uruguay,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 +VUT,Vanuatu,3,Tier 3 IO proxy table,2020,"Tier 3 GHG proxy emissions, scaled to national CO₂ total",2018 VNM,Viet Nam,2,"ICIO, 2025 edition",2020,"OECD GHG emissions for ICIO, 2025 edition",2020 diff --git a/ee/country-tiers.md b/ee/country-tiers.md index 72627c1f..146c8967 100644 --- a/ee/country-tiers.md +++ b/ee/country-tiers.md @@ -3,7 +3,7 @@ title: "GHG data by country tier" --- :::{tip} Summary -The emissions data for each country follow its {term}`tier `: a detailed facility- and inventory-based model for the U.S., national sources for the four Tier 1 countries, the FIGARO or ICIO emissions data for Tier 2, and a scaled template for Tier 3. Within Tier 2, the detail available differs by source. +The emissions data for each country follow its {term}`tier `: a detailed facility- and inventory-based model for the U.S., national sources for the four Tier 1 countries, the FIGARO or ICIO emissions data for Tier 2, and scaled proxy emissions for Tier 3. Within Tier 2, the detail available differs by source. ::: :::{note} Draft @@ -19,7 +19,7 @@ The emissions data for each country follow its {term}`tier `: a de | Tier 1 | China, Japan, South Korea, United Kingdom | National sources for each country | 2018–2023 | All 7 gases, with gaps filled for South Korea | | Tier 2, FIGARO | 40 countries | FIGARO emissions data from Eurostat | 2023 | 6 gas groups | | Tier 2, ICIO | 20 countries | OECD emissions data matched to the ICIO tables | 2020 | Total CO₂e only | -| Tier 3 | 83 countries | A template scaled to each country's fossil CO₂ per unit of GDP from {term}`EDGAR` | 2018 | CO₂, with other gases from U.S. ratios | +| Tier 3 | 83 countries | Proxy emissions scaled to each country's fossil CO₂ per unit of GDP from {term}`EDGAR` | 2018 | CO₂, with other gases from U.S. ratios | | Rest of world | | Pooled from four Tier 2 countries | 2020–2023 | As for those countries | ## Tier 0: The U.S. GHG model @@ -98,13 +98,13 @@ The products are then mapped to the common sectors with {term}`ABSR`. The last g The OECD data give one CO₂e total for each of the 50 industries, with no split by gas. Farming is split out first, using FAOSTAT CH₄ and N₂O [@faoFAOSTATEmissionsTotals2025], before the totals are mapped to the common sectors with ABSR. The split by gas comes entirely from the U.S. mix for each sector. Electricity is mapped as one sector, with no separate split for gas and heat. -## Tier 3: Template emissions +## Tier 3: Proxy emissions -Tier 3 countries have no emissions data matched to an IO table. Their direct emission intensities start from the same template as their input recipe, a blend of Mexico (30%), Malaysia (30%), and Tunisia (40%). The template uses those countries' CO₂ emissions by industry for 2018, from the OECD's 2021 edition of CO₂ emissions embodied in international trade [@oecdCarbonDioxideEmissions2021]. Other gases are added using the U.S. ratio of total CO₂e to CO₂ in each sector. +Tier 3 countries have no emissions data matched to an IO table. Their direct emission intensities start from the same blend as their proxy table: Mexico (30%), Malaysia (30%), and Tunisia (40%). The proxy emissions use those countries' CO₂ emissions by industry for 2018, from the OECD's 2021 edition of CO₂ emissions embodied in international trade [@oecdCarbonDioxideEmissions2021]. Other gases are added using the U.S. ratio of total CO₂e to CO₂ in each sector. -Each country then adjusts the template two ways: +Each country then adjusts the proxy emissions two ways: -- **Overall level.** All intensities are scaled by the country's fossil CO₂ per unit of GDP relative to the template's. Fossil CO₂ is from EDGAR (version 6.0) for 2018 [@crippaGHGEmissionsAll2021; @monfortiferrarioEDGARV60Greenhouse2021], and GDP from the IMF World Economic Outlook (October 2021) [@imfWorldEconomicOutlook2021]. +- **Overall level.** All intensities are scaled by the country's fossil CO₂ per unit of GDP relative to the proxy's. Fossil CO₂ is from EDGAR (version 6.0) for 2018 [@crippaGHGEmissionsAll2021; @monfortiferrarioEDGARV60Greenhouse2021], and GDP from the IMF World Economic Outlook (October 2021) [@imfWorldEconomicOutlook2021]. - **Electricity.** The electricity sector uses the country's own power-sector CO₂ from EDGAR for 2018, divided by the value of its electricity output: 2018 generation from the U.S. Energy Information Administration [@eiaInternationalEnergyStatistics2026] times an average electricity price from the World Bank. ## Rest of world @@ -149,7 +149,7 @@ Emissions stay at their data year. For the data year of each country's IO table, - **Why we make it:** EDGAR merges some activities that CEDS keeps separate, such as public power plants and on-site generation, and refining and extraction. - **How it affects results:** The split between these industries changes, but the country's total for the group is unchanged. -**Tier 3 countries share one template** +**Tier 3 countries share one set of proxy emissions** - **Assumption:** Tier 3 countries share one pattern of direct emission intensities. They differ only in their overall level, set by fossil CO₂ per unit of GDP, and in their electricity intensity. - **Why we make it:** These countries have no emissions data by sector. diff --git a/factors/calculation.md b/factors/calculation.md index db3bf0da..4b9d9f77 100644 --- a/factors/calculation.md +++ b/factors/calculation.md @@ -29,7 +29,7 @@ The direct emission factors `D` are part of the model but are not published as a ## Tier 3 countries -The 83 Tier 3 countries are not part of the multi-region table, so their factors are calculated one country at a time, from the template described in [](../io/country-tiers.md#tier-3-no-io-tables) and [](../ee/country-tiers.md#tier-3-template-emissions). Each country's domestic inputs carry its own direct emission intensities through its domestic total requirements, `(I − Adom)⁻¹`. Its imported inputs carry China's total emission factors from the multi-region table. The two parts are added to give the country's `M`. +The 83 Tier 3 countries are not part of the multi-region table, so their factors are calculated one country at a time, from the proxy table and proxy emissions described in [](../io/country-tiers.md#tier-3-proxy-tables) and [](../ee/country-tiers.md#tier-3-proxy-emissions). Each country's domestic inputs carry its own direct emission intensities through its domestic total requirements, `(I − Adom)⁻¹`. Its imported inputs carry China's total emission factors from the multi-region table. The two parts are added to give the country's `M`. ## Regional and global averages diff --git a/faq.md b/faq.md index a44c6771..0d149697 100644 --- a/faq.md +++ b/faq.md @@ -156,7 +156,7 @@ The factors are published by the Cornerstone Sustainability Data Initiative unde ::: :::{dropdown} What does a country's tier mean for how much I can rely on its factors? -Countries are grouped in four tiers by the input-output data available for them. Tier 0 (US) has detailed annual tables, Tier 1 (China, Japan, South Korea, UK) uses detailed national tables, Tier 2 (60 countries) uses coarser multi-regional tables from FIGARO or ICIO, and Tier 3 (83 countries) has no usable table and uses a template built from other countries. Factors for Tier 3 countries carry more uncertainty. See [](io/country-tiers.md) for the IO data, [](ee/country-tiers.md) for the emissions data and [](reference/methods-by-country.md). +Countries are grouped in four tiers by the input-output data available for them. Tier 0 (US) has detailed annual tables, Tier 1 (China, Japan, South Korea, UK) uses detailed national tables, Tier 2 (60 countries) uses coarser multi-regional tables from FIGARO or ICIO, and Tier 3 (83 countries) has no usable table and uses a proxy table built from other countries. Factors for Tier 3 countries carry more uncertainty. See [](io/country-tiers.md) for the IO data, [](ee/country-tiers.md) for the emissions data and [](reference/methods-by-country.md). ::: :::{dropdown} Can I get help applying the changes to my footprint? diff --git a/figures/diagrams/country-tiers-map.svg b/figures/diagrams/country-tiers-map.svg index f19bc065..95289d42 100644 --- a/figures/diagrams/country-tiers-map.svg +++ b/figures/diagrams/country-tiers-map.svg @@ -284,7 +284,7 @@ Tier 2FIGARO or ICIO (60) -Tier 3Template (83) +Tier 3Proxy tables (83) Not modeledPart of rest of world diff --git a/figures/diagrams/quality-pipeline.svg b/figures/diagrams/quality-pipeline.svg new file mode 100644 index 00000000..6e362a34 --- /dev/null +++ b/figures/diagrams/quality-pipeline.svg @@ -0,0 +1,49 @@ + + + + + + + + + + + Acquire + source data + + + Transform + map, split, balance + + + Build model + A, L, B, D + + + Calculate + emission factors + + + Publish + release files + + + + + + + + + 2 · Data validation + on arrival, through each step, against references + + + + 3 · Model validation + national emissions, balance, previous results, published files + + + + 1 · Code validation + unit, integration and regression tests on every change to the code that runs each step + diff --git a/figures/scripts/tier_map.py b/figures/scripts/tier_map.py index 3be4ef6e..e2880321 100644 --- a/figures/scripts/tier_map.py +++ b/figures/scripts/tier_map.py @@ -161,7 +161,7 @@ def main() -> None: (TIER_COLORS["0"], "Tier 0", "United States"), (TIER_COLORS["1"], "Tier 1", f"National tables ({counts['1']})"), (TIER_COLORS["2"], "Tier 2", f"FIGARO or ICIO ({counts['2']})"), - (TIER_COLORS["3"], "Tier 3", f"Template ({counts['3']})"), + (TIER_COLORS["3"], "Tier 3", f"Proxy tables ({counts['3']})"), (NOT_MODELED, "Not modeled", "Part of rest of world"), ] ly = MAP_TOP + MAP_H + 30 diff --git a/index.md b/index.md index 94db3cfb..39b4ac06 100644 --- a/index.md +++ b/index.md @@ -57,9 +57,18 @@ How the results compare with independent evidence. The methods and data behind each country in the model. ::: -:::{card} Release details -:link: releases/index.md -Release notes, summaries of changes and change logs. +:::: + +## Releases + +What each release contains and how it differs from USEEIO and CEDA. + +::::{grid} 1 2 2 3 +:class: track-releases + +:::{card} 2026-rc.1 release note +:link: releases/rc.md +The first release candidate, with the spend-based emission factors. ::: :::: diff --git a/io/country-tiers.md b/io/country-tiers.md index 84d940ab..4fcfcf53 100644 --- a/io/country-tiers.md +++ b/io/country-tiers.md @@ -16,12 +16,14 @@ Countries by tier. Darker means more detailed IO data. Small countries are shown The model covers 148 countries plus a rest-of-world region. A country's tier sets which type of table it starts from, how much sector detail that table has, and how it is valued. -| {term}`Country tier` | Countries | Starting tables | -|---|---|---| -| Tier 0 | United States | {term}`Make and Use tables ` for 2024 produced by Cornerstone (nowcast), after {term}`redefinitions `, following BEA's 2017 detailed schema | -| Tier 1 | China, Japan, South Korea, United Kingdom | IO tables published by each country's statistical agency | -| Tier 2 | 60 countries | The country's table from {term}`FIGARO` (40 countries) or the {term}`ICIO` (20 countries) | -| Tier 3 | 83 countries | No usable table: a template built from other countries' tables | +| {term}`Country tier` | Countries | Share of world GDP | Starting tables | +|---|---|---|---| +| Tier 0 | United States | 26.2% | {term}`Make and Use tables ` for 2024 produced by Cornerstone (nowcast), after {term}`redefinitions `, following BEA's 2017 detailed schema | +| Tier 1 | China, Japan, South Korea, United Kingdom | 25.5% | IO tables published by each country's statistical agency | +| Tier 2 | 60 countries | 40.7% | The country's table from {term}`FIGARO` (40 countries) or the {term}`ICIO` (20 countries) | +| Tier 3 | 83 countries | 5.2% | Proxy table recreated from other countries with available data | + +Share of world GDP is each tier's 2024 GDP in current US dollars divided by world GDP. Source: World Bank, World Development Indicators (`NY.GDP.MKTP.CD`), retrieved October 2026. The shares sum to less than 100% because countries in the rest-of-world region are not counted, and because the World Bank does not report Taiwan (Tier 2). ## Tier 0: Detailed, annual IO tables @@ -72,15 +74,15 @@ Both are inter-country tables, so each country's own block of the table gives it Before mapping, five of FIGARO's broad sectors are split into finer ones while keeping their totals: electricity, gas, and heat; water, sewerage, and waste; basic metals (steel, other ferrous, non-ferrous); non-metallic minerals (cement, other); mining (five sectors); and agriculture (11 farm sectors). The tables are then mapped to the common sectors with {term}`ABSR`, and converted to 2024 U.S. dollars the same way as Tier 1. -## Tier 3: No IO tables +## Tier 3: Proxy tables The 83 countries that are in neither Tier 1 nor Tier 2 have no usable published table. They are not part of the multi-region table; their factors are calculated one country at a time. -- **Input recipe.** All 83 share one template recipe, a weighted blend of three Tier 2 economies: Mexico (30%), Malaysia (30%), and Tunisia (40%). -- **Imports.** Each country's own import share splits the template into domestic and imported inputs, with the same share for every sector. The supply chains behind those imports are approximated with China's. +- **Input recipe.** All 83 share one proxy table recipe, a weighted blend of three Tier 2 economies: Mexico (30%), Malaysia (30%), and Tunisia (40%). +- **Imports.** Each country's own import share splits the proxy table into domestic and imported inputs, with the same share for every sector. The supply chains behind those imports are approximated with China's. - **Emissions.** Direct emission intensities are scaled to the country's own emissions per unit of GDP, and electricity uses the country's own emission intensity. -This template is separate from the rest-of-world region in the multi-region table, which is built from different countries (see [](index.md)). +This proxy table is separate from the rest-of-world region in the multi-region table, which is built from different countries (see [](index.md)). ## Currency @@ -102,7 +104,7 @@ All tables are converted to 2024 U.S. dollars. Sector lists are reconciled in th **Tier 3 countries share one recipe** -- **Assumption:** Tier 3 countries share one template input recipe. Each country differs only in its overall import share, applied equally to every sector, and in its direct emission intensities, which are scaled to the country's emissions per unit of GDP, with its own electricity intensity. Their imported supply chains are approximated with China's. +- **Assumption:** Tier 3 countries share one proxy table input recipe. Each country differs only in its overall import share, applied equally to every sector, and in its direct emission intensities, which are scaled to the country's emissions per unit of GDP, with its own electricity intensity. Their imported supply chains are approximated with China's. - **Why we make it:** These countries have no usable published IO table. - **How it affects results:** Differences in industry structure between Tier 3 countries are not captured, and imports from countries other than China are given China's supply chains. Factors for these countries carry more uncertainty than those for Tiers 0 to 2. ::: \ No newline at end of file diff --git a/io/index.md b/io/index.md index 770a8271..75535d30 100644 --- a/io/index.md +++ b/io/index.md @@ -8,7 +8,7 @@ Cornerstone uses standardized national input-output tables to represent producti ## Preparing the IO tables -Every country enters the model as a national IO table, but countries don't all start from the same kind of table. The first step is to collect the best available table for each country and record where it came from: the source, version, year, valuation, and sector detail. Which table we start from depends on the country's {term}`tier `: the U.S. starts from {term}`Make and Use tables ` for 2024 that Cornerstone produces using BEA's methodology, after {term}`redefinitions ` and following BEA's 2017 detailed schema, while other countries start from national statistical agency tables, {term}`FIGARO` or {term}`ICIO`, or a template. See [](country-tiers.md) for what each tier starts from. +Every country enters the model as a national IO table, but countries don't all start from the same kind of table. The first step is to collect the best available table for each country and record where it came from: the source, version, year, valuation, and sector detail. Which table we start from depends on the country's {term}`tier `: the U.S. starts from {term}`Make and Use tables ` for 2024 that Cornerstone produces using BEA's methodology, after {term}`redefinitions ` and following BEA's 2017 detailed schema, while other countries start from national statistical agency tables, {term}`FIGARO` or {term}`ICIO`, or a proxy table. See [](country-tiers.md) for what each tier starts from. The detailed U.S. structure sets the model's common sector list, and it is used to split other countries' coarser sectors (see {term}`ABSR`). Sector lists and currencies are reconciled in the later steps: mapping to the common sector list, linking with trade data, and balancing. @@ -90,7 +90,7 @@ Each country's tables say how much of its inputs are imported, but not where the 1. **Put every country in one table.** The 65 countries in Tiers 0 to 2 each get their own block, so `A` is a 65 × 65 grid of country blocks, each 405 × 405 sectors. Each country's `Adom` sits on the diagonal. A country's column holds everything its industries buy; the rows say which country sold it. 2. **Split imports by origin.** Each country's `Aimp` is spread down its column using bilateral trade data ({term}`BACI`): for each product, the share the country imports from each origin. Products the trade data don't cover, mostly services, use origin shares from {term}`FIGARO` or {term}`ICIO`. Imported final demand (`yimp`) is split the same way. -3. **Add the rest of the world.** Imports from countries outside the table come from a rest-of-world region. Its domestic input structure is pooled from the tables of Colombia, Mexico, Türkiye, and Chile. It is added as one more block, making `A` a 66 × 66 grid of country blocks. This region is separate from the template used for Tier 3 countries' own factors (see [](country-tiers.md)). +3. **Add the rest of the world.** Imports from countries outside the table come from a rest-of-world region. Its domestic input structure is pooled from the tables of Colombia, Mexico, Türkiye, and Chile. It is added as one more block, making `A` a 66 × 66 grid of country blocks. This region is separate from the proxy table used for Tier 3 countries' own factors (see [](country-tiers.md)). 4. **Balance.** The table is balanced with {term}`RAS`, so that each country's sales to all users, at home and abroad, add up to its output, without changing it's domestic recipe. This makes small adjustments to the import coefficients. 5. **Solve.** The total requirements (`L`) are calculated for the whole table at once, so supply chains that cross several borders are captured in full (see [below](#total-requirements)). diff --git a/myst.yml b/myst.yml index 035ac9ed..cd9685fe 100644 --- a/myst.yml +++ b/myst.yml @@ -40,13 +40,13 @@ project: - file: factors/margins.md - file: validation/index.md - file: benchmarking/index.md - - file: releases/index.md + - file: releases/index.md + children: + - file: releases/rc.md children: - - file: releases/rc.md - children: - - file: releases/summary-useeio.md - - file: releases/summary-ceda.md - - file: releases/change-log.md + - file: releases/summary-useeio.md + - file: releases/summary-ceda.md + - file: releases/change-log.md - title: User guide children: - file: factors/whats-in-a-release.md diff --git a/reference/glossary.md b/reference/glossary.md index f7ae42e3..e378f6b6 100644 --- a/reference/glossary.md +++ b/reference/glossary.md @@ -21,7 +21,7 @@ CEDS : Community Emissions Data System. A global inventory of emissions by country and detailed activity, used to refine the split of emissions between energy industries and for China's CH₄ and N₂O. Country tier -: A group of countries modeled with the same level of detail and the same kinds of data sources: Tier 0, detailed annual IO tables (the United States); Tier 1, detailed periodic national IO tables; Tier 2, coarse multi-regional tables from FIGARO or ICIO; and Tier 3, no IO tables (a template built from other countries). +: A group of countries modeled with the same level of detail and the same kinds of data sources: Tier 0, detailed annual IO tables (the United States); Tier 1, detailed periodic national IO tables; Tier 2, coarse multi-regional tables from FIGARO or ICIO; and Tier 3, no IO tables (a proxy table built from other countries). EDGAR : Emissions Database for Global Atmospheric Research, from the European Commission's Joint Research Centre. Global emissions by country and activity; the basis of FIGARO emissions for its non-European countries. diff --git a/reference/methods-by-country.md b/reference/methods-by-country.md index 5018664b..fc483222 100644 --- a/reference/methods-by-country.md +++ b/reference/methods-by-country.md @@ -15,7 +15,7 @@ Each country's {term}`tier ` sets which kind of IO table and emiss The data sources and years used can differ between the dollar years that factors are published for, so the table is given for each set of dollar years that share the same data. -Tier 3 countries share one IO template, a blend of Malaysia (30%) and Tunisia (40%) from the ICIO for 2020 and Mexico (30%) from FIGARO for 2023; the table gives 2020, the year of most of the blend. They also share one GHG template, scaled to each country's fossil CO₂ total from {term}`EDGAR` (see [](../ee/country-tiers.md#tier-3-template-emissions)). +Tier 3 countries share one IO proxy table, a blend of Malaysia (30%) and Tunisia (40%) from the ICIO for 2020 and Mexico (30%) from FIGARO for 2023; the table gives 2020, the year of most of the blend. They also share one set of GHG proxy emissions, scaled to each country's fossil CO₂ total from {term}`EDGAR` (see [](../ee/country-tiers.md#tier-3-proxy-emissions)). The rest-of-world region is not in the table. Its input recipe and emission intensities are pooled from Colombia, Mexico, Türkiye, and Chile. @@ -27,153 +27,153 @@ The release candidate's 2024, 2025, and 2026 factors are all built from the same | Country | ISO3 | Tier | IO table | IO data year | GHG data | GHG data year | |---|---|---|---|---|---|---| -| Afghanistan | AFG | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Albania | ALB | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Algeria | DZA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Angola | AGO | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Antigua and Barbuda | ATG | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Afghanistan | AFG | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Albania | ALB | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Algeria | DZA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Angola | AGO | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Antigua and Barbuda | ATG | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Argentina | ARG | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | | Australia | AUS | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | | Austria | AUT | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Bahamas | BHS | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Bahrain | BHR | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Bangladesh | BGD | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Barbados | BRB | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Bahamas | BHS | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Bahrain | BHR | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Bangladesh | BGD | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Barbados | BRB | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Belgium | BEL | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Belize | BLZ | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Benin | BEN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Bhutan | BTN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Bolivia | BOL | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Belize | BLZ | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Benin | BEN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Bhutan | BTN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Bolivia | BOL | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Brazil | BRA | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | | Bulgaria | BGR | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Burkina Faso | BFA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Burundi | BDI | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Burkina Faso | BFA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Burundi | BDI | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Cambodia | KHM | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Cameroon | CMR | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Cameroon | CMR | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Canada | CAN | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | -| Central African Republic | CAF | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Chad | TCD | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Central African Republic | CAF | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Chad | TCD | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Chile | CHL | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | China | CHN | 1 | China National Bureau of Statistics IO table | 2023 | Built from OWID, CEDS, national energy statistics, and China's BTR1 | 2023 | | Colombia | COL | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Congo | COG | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Congo | COG | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Costa Rica | CRI | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Côte d'Ivoire | CIV | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Côte d'Ivoire | CIV | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Croatia | HRV | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Cyprus | CYP | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Czechia | CZE | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Denmark | DNK | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Dominica | DMA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Dominican Republic | DOM | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Ecuador | ECU | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Egypt | EGY | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| El Salvador | SLV | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Equatorial Guinea | GNQ | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Dominica | DMA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Dominican Republic | DOM | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Ecuador | ECU | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Egypt | EGY | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| El Salvador | SLV | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Equatorial Guinea | GNQ | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Estonia | EST | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Eswatini | SWZ | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Ethiopia | ETH | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Fiji | FJI | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Eswatini | SWZ | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Ethiopia | ETH | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Fiji | FJI | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Finland | FIN | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | France | FRA | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Gabon | GAB | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Gambia | GMB | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Gabon | GAB | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Gambia | GMB | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Germany | DEU | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Greece | GRC | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Grenada | GRD | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Guatemala | GTM | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Guinea | GIN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Guinea-Bissau | GNB | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Haiti | HTI | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Honduras | HND | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Grenada | GRD | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Guatemala | GTM | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Guinea | GIN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Guinea-Bissau | GNB | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Haiti | HTI | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Honduras | HND | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Hong Kong | HKG | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Hungary | HUN | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Iceland | ISL | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | India | IND | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | | Indonesia | IDN | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | -| Iran | IRN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Iraq | IRQ | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Iran | IRN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Iraq | IRQ | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Ireland | IRL | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Israel | ISR | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Italy | ITA | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Jamaica | JAM | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Jamaica | JAM | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Japan | JPN | 1 | Input-Output Tables for Japan | 2020 | NIES 3EID dataset | 2020 | -| Jordan | JOR | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Jordan | JOR | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Kazakhstan | KAZ | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Kenya | KEN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Kiribati | KIR | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Kuwait | KWT | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Kenya | KEN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Kiribati | KIR | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Kuwait | KWT | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Laos | LAO | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Latvia | LVA | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Lebanon | LBN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Lesotho | LSO | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Lebanon | LBN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Lesotho | LSO | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Lithuania | LTU | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Luxembourg | LUX | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Malawi | MWI | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Malawi | MWI | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Malaysia | MYS | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Maldives | MDV | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Mali | MLI | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Maldives | MDV | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Mali | MLI | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Malta | MLT | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Mauritius | MUS | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Mauritius | MUS | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Mexico | MEX | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | -| Moldova | MDA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Mongolia | MNG | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Moldova | MDA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Mongolia | MNG | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Morocco | MAR | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Myanmar | MMR | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Namibia | NAM | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Nauru | NRU | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Nepal | NPL | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Namibia | NAM | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Nauru | NRU | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Nepal | NPL | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Netherlands | NLD | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | New Zealand | NZL | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Nicaragua | NIC | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Niger | NER | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Nigeria | NGA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| North Macedonia | MKD | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Nicaragua | NIC | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Niger | NER | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Nigeria | NGA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| North Macedonia | MKD | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Norway | NOR | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Oman | OMN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Pakistan | PAK | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Papua New Guinea | PNG | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Paraguay | PRY | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Oman | OMN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Pakistan | PAK | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Papua New Guinea | PNG | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Paraguay | PRY | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Peru | PER | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Philippines | PHL | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Poland | POL | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Portugal | PRT | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Qatar | QAT | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Qatar | QAT | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Romania | ROU | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Russia | RUS | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | -| Rwanda | RWA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Saint Kitts and Nevis | KNA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Saint Lucia | LCA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Saint Vincent and the Grenadines | VCT | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Samoa | WSM | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Rwanda | RWA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Saint Kitts and Nevis | KNA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Saint Lucia | LCA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Saint Vincent and the Grenadines | VCT | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Samoa | WSM | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Saudi Arabia | SAU | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | -| Senegal | SEN | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Seychelles | SYC | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Sierra Leone | SLE | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Senegal | SEN | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Seychelles | SYC | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Sierra Leone | SLE | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Singapore | SGP | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Slovakia | SVK | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Slovenia | SVN | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Solomon Islands | SLB | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Solomon Islands | SLB | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | South Africa | ZAF | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from EDGAR with CEDS corrections | 2023 | | South Korea | KOR | 1 | Bank of Korea IO tables | 2018 | GHG data published with the Bank of Korea IO tables | 2018 | | Spain | ESP | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Sri Lanka | LKA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Sri Lanka | LKA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Sweden | SWE | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Switzerland | CHE | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | | Taiwan | TWN | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Tanzania | TZA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Tanzania | TZA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Thailand | THA | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | -| Timor-Leste | TLS | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Togo | TGO | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Trinidad and Tobago | TTO | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Timor-Leste | TLS | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Togo | TGO | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Trinidad and Tobago | TTO | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Tunisia | TUN | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | | Türkiye | TUR | 2 | FIGARO, 2026 edition | 2023 | FIGARO, from air emissions accounts | 2023 | -| Uganda | UGA | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Ukraine | UKR | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| United Arab Emirates | ARE | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Uganda | UGA | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Ukraine | UKR | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| United Arab Emirates | ARE | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | United Kingdom | GBR | 1 | ONS IO Analytical Tables | 2023 | ONS atmospheric emissions accounts | 2023 | | United States | USA | 0 | Cornerstone nowcast Make and Use tables | 2024 | U.S. GHG inventory with facility data | 2024 | -| Uruguay | URY | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | -| Vanuatu | VUT | 3 | Tier 3 IO template | 2020 | Tier 3 GHG template, scaled to national CO₂ total | 2018 | +| Uruguay | URY | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | +| Vanuatu | VUT | 3 | Tier 3 IO proxy table | 2020 | Tier 3 GHG proxy emissions, scaled to national CO₂ total | 2018 | | Viet Nam | VNM | 2 | ICIO, 2025 edition | 2020 | OECD GHG emissions for ICIO, 2025 edition | 2020 | diff --git a/releases/index.md b/releases/index.md index a83a3362..9a294288 100644 --- a/releases/index.md +++ b/releases/index.md @@ -1,5 +1,5 @@ --- -title: Release details +title: Releases --- :::{tip} Summary diff --git a/validation/index.md b/validation/index.md index 6f22191e..2b6a6a2a 100644 --- a/validation/index.md +++ b/validation/index.md @@ -4,24 +4,82 @@ label: validation-hub --- :::{tip} Summary -*To be written.* +Validation asks "did we build the model correctly?" It checks the code that builds the model, the data that go into it, and the model and emission factors that come out. Benchmarking, described in [](../benchmarking/index.md), asks a different question: "are the results plausible compared with independent evidence?" Both feed into the next release. ::: -:::{note} Draft placeholder -:class: dropdown -Plan §3.5 · target: **RC (Oct 27)** +:::{figure} ../figures/diagrams/quality-pipeline.svg +:label: fig-quality-pipeline +:alt: Five boxes in a row show the build: acquire source data, transform (map, split, balance), build the model (A, L, B, D), calculate the emission factors, and publish the release files. Below them, a data validation band spans acquire and transform, a model validation band spans build, calculate and publish, and a code validation band spans all five steps. +Where each kind of validation runs in the build. Code validation covers every step; data validation follows the data in; model validation checks what comes out. Benchmarking against independent evidence follows the build and feeds the next release (see [](../benchmarking/index.md)). +::: +## 1. Code validation -**Planned content** +The model is built by open-source code, and every change to that code is tested before it is merged. -- Short summary of every check (plan §4), linking down to the section pages that hold the details -- Cross-link to benchmarking: both feed the same loop into model development +- **Unit tests.** About 2,900 automated tests check individual steps against known answers. They include tests of the core formulas, such as `N = D × L`, and of the conservation rules the methods rely on: when emissions or output are split, mapped or reallocated, the totals before and after must match. Small worked examples, including a toy model of {term}`ABSR` and of {term}`RAS` balancing, are solved by hand and checked against the code. +- **Schema checks.** The main tables are checked for their structure every time they are built: the full list of 405 sectors in the right order, every country present, no duplicates, and no missing values. Final demand and exports must not be negative. +- **Integration and regression tests.** Larger tests rebuild whole parts of the model, such as the U.S. tables, the GHG extension, and the global `B` and `M` matrices, and compare them with a pinned reference result from the release build. A change that moves any value by more than 0.01% fails the test, so every change to the results is deliberate and reviewed. The longest of these tests run on a schedule every weekday. +- **Code quality.** Each proposed change is checked automatically for formatting, coding errors and type consistency before the tests run. -**Key visuals** +## 2. Data validation -- 🖼 "Quality pipeline" graphic showing where in the build each check runs -- 🖼 Release scorecard table (pass/fail/notes per check, per release) -::: +Data are checked when they arrive, as they move through each step of the build, and against references. + +### On arrival + +- **Structure and coverage.** Each source is checked for the countries, sectors, years and units it should contain. A source that is missing a country or sector the model needs is rejected rather than filled silently. +- **Internal consistency.** Published identities in the source are checked before the data are used. For example, the accounting identities of the FIGARO tables must be satisfied, each sector's emissions in the OECD data must add up to the published total, and the BEA tables are checked against BEA's own benchmark panel and sign conventions. +- **Reproducibility.** Extracted datasets are regenerated from the original source and compared with the stored copy, and stored copies older than the method that made them are flagged. + +### Through each transformation + +- **Totals are kept.** When a source sector is split, allocated to the 405 common sectors, or reallocated between sectors, each country's total for each source sector is kept. An independent calculation maps the final results back to every source cell and fails if they do not match (see [](../ee/index.md)). +- **Tables balance.** The U.S. Supply and Use tables are balanced so that for every commodity, supply equals use, along with industry output, taxes, subsidies, margins and value added. The multi-region table is balanced with {term}`RAS` so that each country's sales match its output within 0.1%; a run that cannot meet a looser 1% limit fails instead of being published. Final demand implied by the balanced table must not be negative. +- **Facility data set a floor.** For U.S. sectors, CO₂, CH₄ and N₂O are not allowed to fall below what the sector's own facilities report to EPA's Greenhouse Gas Reporting Program ({term}`GHGRP`). Sectors whose facilities are almost all covered by the program are also capped from above. Each national inventory total is unchanged by these adjustments. +- **No missing or invalid values.** Values are checked for missing, infinite or negative numbers where they are not allowed, and a calculation that would leave a gas or a country empty stops with an error. How the few negative values in source data are treated is recorded case by case. + +### Against references and other years + +- **Other years of the same data.** Each data update is compared with the previous year of the same source, checking sector counts, totals, and which sectors move most. Over the U.S. time series from 2017 to 2024, changes in emissions are checked against changes in output, sector by sector. +- **Other sources.** The model's U.S. emissions by sector are compared with facility totals from GHGRP. To choose the Tier 2 source, FIGARO and the OECD ICIO were compared cell by cell for 2020 across the 45 countries both cover, on common grids of 44 sector groups for the IO tables and 43 for emissions. FIGARO was chosen for the 40 Tier 2 countries it covers, and the ICIO is used for the other 20 (see [](../reference/methods-by-country.md)). +- **Gaps.** Coverage is checked for every country and sector. Where a country has no output or no emissions for a sector, its emission factor is filled from its region, as described in [](../factors/calculation.md#filling-missing-country-factors). + +## 3. Model validation + +The model as a whole is checked by asking whether it reproduces the data it was built from and how its results compare with previous models. + +### Recalculating national emissions + +An input-output model should recalculate the emissions it was built from. Running the final demand of every country (`y`) through the model gives the output needed to meet it (`L × y`), and multiplying by the direct emission factors gives the emissions of producing it: + +`E_model = diag(D) × L × y` + +Summed over the world, this equals `N × y`, the emissions embodied in all final demand. Summed over each country's own sectors, it gives the emissions produced in that country. Two checks follow: + +- **Against the source data.** Each country's recalculated emissions are compared with its source emissions: the national inventory for the U.S. and the Tier 1 countries, and the FIGARO or OECD totals for Tier 2. A difference points to a problem in balancing or in how emissions were attached to sectors. +- **Against the model's own output.** The same emissions calculated from output directly, `B × q`, must match the result from final demand. Any gap between the two is a balance residual, which should be close to zero. + +The U.S. tables are also checked on their own: + +- Running final demand through the U.S. tables must give back each commodity's output (see [](../io/index.md#final-demand-for-the-national-accounting-balance)). +- The Make and Use tables must give the same output for each commodity and each industry, within 5%. The only expected exceptions are a small number of waste and special sectors, whose definitions in the Cornerstone sector list differ from those in the BEA tables. +- Output by commodity and by industry must move consistently with their price indexes, within 5%. + +### Comparing with previous results + +- **Previous models.** Every release is compared with the models it replaces, sector by sector and country by country. For Cornerstone EEIO 2026 these are CEDA 2025 and the USEEIO Supply Chain GHG Emission Factors v1.4 (see [](../releases/summary-ceda.md) and [](../releases/summary-useeio.md)). During development, the U.S. part of the model is also compared with the USEEIO v2.6 model. +- **Step by step.** Changes are added to the model one at a time with the factors recalculated after each step. As a result, every change in the results can be traced to the data update or method change that caused it. These steps are the drivers shown in the release summaries and listed in the [](../releases/change-log.md). +- **Large moves.** Sectors and countries whose factors move most are reviewed individually. Each large move must be explained by a real change in the data or modeling approach. +- **Reproducibility.** The release build is pinned, and rebuilding it reproduces the published results. + +### Checking the published files + +The published emission factors are read directly from the pinned release build. Before release, the files are checked for their locked column layout, complete gas and sector coverage, regional and global averages for every sector, and NAICS mapping weights that add up to one. + +### Beyond validation + +Validation shows that the model was built as designed. Whether the results agree with independent evidence, such as sector studies and other databases, is the job of [benchmarking](../benchmarking/index.md). +++