Add validation test for emissions factor references provided in zone …

…configs (#6001)

* zone config: retain 'emissionFactors' key after configuration is loaded

* tests: add test case to validate the reference sources listed in zone config emissions factor entries

* Run 'poetry run format'

* Zone model: add emissionFactors field to allow pydantic validation to pass

* config.model: relocate 'Zone' class definition so that it can reference classes defined above it within the module

* config.model: add ZoneEmissionFactors model to represent emissions factors stored directly on zone config objects as read from YAML

* config.model: cleanup: remove outdated comment

* config.model: cleanup: use snake-casing

* tests: migrate to a pydantic-model-based reference-testing approach

* Revert "config.model: cleanup: use snake-casing"

This reverts commit efd56dc.

* Revert "config.model: cleanup: remove outdated comment"

This reverts commit 2de8e37.

* Revert "config.model: add ZoneEmissionFactors model to represent emissions factors stored directly on zone config objects as read from YAML"

This reverts commit 88ea0a6.

* Revert "config.model: relocate 'Zone' class definition so that it can reference classes defined above it within the module"

This reverts commit 3ca1990.

* Revert "Zone model: add emissionFactors field to allow pydantic validation to pass"

This reverts commit e4e701c.

* Revert "zone config: retain 'emissionFactors' key after configuration is loaded"

This reverts commit 1464290.

* tests: refactor zone reference-testing to use existing CO2EQ_CONFIG_MODEL

* tests: apply isort-preferred module formatting

* tests: every zone production mode estimate must provide a source reference, so assert that it is a required value

* config: refactor-out HOPS source reference into an origin document and a link to the calculation that derived it

While doing this I also confirmed that HOPS is an ENTSOE transmission system operator in Croatia; the linked document is also available on their English-language homepage under Documents -> Basic Data at 'http://hops.hr/page-file/iXgT7cSSC4U28AfzW8lBZ6/publications/Temeljni_podaci_2018.pdf'

Cross-references-commit d3072b4.

* config: refactor-out references to IEA MX energy generation ix report URL by defining 'sources' entries for it per-zone

Also confirmed while doing this that the comment is accurate, in that the percentages mentioned refer to the Y2020 energy mix reported by the charts at the given URL

* config: refactor-out references to IPCC 2014 Ocean (includes tidal) electricity supply technologies

* config: refactor-out references to data partially derived from the Guatemalan AMM (Administrador del Mercado Mayorista)

The link is to the page containing the API where data was extracted from and that belongs to the authority source; the docs.google.com URL for the derived analysis remains as a _url property on the relevant emissions factors

* config: refactor-out references to Enerdata as a data source from zone configuration files for Japan

* tests: factor-out special-case Electricity Maps reference by rephrasing the sentence, hopefully with no loss of information (and retaining the explicit disclaimer note)

* config: rephrase CA-AB source assumption note into a more grammatically-correct structure

* config: fixup: data for IN-KA shouldn't be described as an assumption (that was a temporary measure to allow the unit tests to pass while cleaning up the zone config files)

* config: factor-out sources for assumed 50-50 solar:wind renewables mix in UA

* tests: cleanup: 'emission_factors' and the 'zone_overrides' subfield are required (not optional) on each CO2 parameters model

* tests: add assertion that top-level sources configuration is present when reference sources are found

* tests: lint fixup: comment brevity to fix within line length limits

* tests: nitpick: standardize error message format, and include full path to missing 'source' key

* config: add top-level 'source' entry to CH zone config for results derived from Electricity Maps worksheet with SFOE contribution

config/zones/CA-AB.yaml

@@ -78,7 +78,7 @@ emissionFactors:
         source: Electricity Maps, 2021 average
         value: 483.05444890890203
     unknown:
-      source: 'Battle River dual fuel power plant: 50% coal and 50% natural gas'
+      source: 'assumes 50% coal and 50% natural gas from Battle River dual fuel power plant'
       value: 655
 fallbackZoneMixes:
   powerOriginRatios:

config/zones/CH.yaml

@@ -74,27 +74,21 @@ emissionFactors:
         value: 113.07156762843732
     unknown:
       - datetime: '2017-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 271
       - datetime: '2018-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 335
       - datetime: '2019-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 279
       - datetime: '2020-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 244
       - datetime: '2021-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 209
       - datetime: '2022-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 195
   lifecycle:
@@ -164,27 +158,21 @@ emissionFactors:
       value: 29.5
     unknown:
       - datetime: '2017-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 384
       - datetime: '2018-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 464
       - datetime: '2019-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 391
       - datetime: '2020-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 349
       - datetime: '2021-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 306
       - datetime: '2022-01-01'
-        _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
         source: SFOE, Electricity Maps
         value: 292
 estimation_method: RECONSTRUCT_BREAKDOWN
@@ -302,27 +290,21 @@ isLowCarbon:
     value: 0.894
   unknown:
     - datetime: '2017-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.53
     - datetime: '2018-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.42
     - datetime: '2019-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.51
     - datetime: '2020-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.57
     - datetime: '2021-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.64
     - datetime: '2022-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.66
 isRenewable:
@@ -332,27 +314,21 @@ isRenewable:
     value: 0.5771
   unknown:
     - datetime: '2017-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.53
     - datetime: '2018-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.42
     - datetime: '2019-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.51
     - datetime: '2020-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.57
     - datetime: '2021-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.64
     - datetime: '2022-01-01'
-      _comment: 'Assumed make up of the unknown production is detailed here: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E'
       source: SFOE, Electricity Maps
       value: 0.66
 parsers:
@@ -368,4 +344,6 @@ sources:
     link: https://docs.google.com/spreadsheets/d/1w5DJ7sPen6axIHU8TCVcuzNCjlct4I6JAbhUlw-ZXu8/edit?usp=sharing
   IPCC 2014:
     link: https://www.ipcc.ch/site/assets/uploads/2018/02/ipcc_wg3_ar5_annex-iii.pdf#page=7
+  SFOE, Electricity Maps:
+    link: https://docs.google.com/spreadsheets/d/1FLHQ6e9Es08BIqX654BM3SEb_fuAk4k4O-6cmRXyw_E
 timezone: Europe/Zurich

config/zones/FO-MI.yaml

@@ -32,7 +32,8 @@ emissionFactors:
       source: EU-ETS, ENTSO-E 2021
       value: 1193.417464
     unknown:
-      source: Tidal (IPCC 2014)
+      comment: Data reflects Ocean (tidal) direct emissions from table A.III.2
+      source: IPCC 2014
       value: 0
   lifecycle:
     biomass:
@@ -60,7 +61,8 @@ emissionFactors:
       source: EU-ETS, ENTSO-E 2021; IPCC 2014
       value: 1437.417464
     unknown:
-      source: Tidal (IPCC 2014)
+      comment: Data reflects median Ocean (tidal) lifecycle emissions from table A.III.2
+      source: IPCC 2014
       value: 17
     wind:
       datetime: '2014-01-01'

config/zones/FO.yaml

@@ -64,7 +64,8 @@ emissionFactors:
       source: EU-ETS, ENTSO-E 2021
       value: 1193.417464
     unknown:
-      source: Tidal (IPCC 2014)
+      comment: Data reflects Ocean (tidal) direct emissions from table A.III.2
+      source: IPCC 2014
       value: 0
   lifecycle:
     battery discharge:
@@ -124,7 +125,8 @@ emissionFactors:
       source: EU-ETS, ENTSO-E 2021; IPCC 2014
       value: 1437.417464
     unknown:
-      source: Tidal (IPCC 2014)
+      comment: Data reflects median Ocean (tidal) lifecycle emissions from table A.III.2
+      source: IPCC 2014
       value: 17
     wind:
       datetime: '2014-01-01'

config/zones/GT.yaml

@@ -64,7 +64,7 @@ emissionFactors:
         value: 269.6478450016261
     unknown:
       _url: https://docs.google.com/spreadsheets/d/1CegROfej9HqRZTfihpjPpgZTYPUHrTNgTdHWbbP3w74/edit#gid=291258352
-      source: Guatemala AMM 2021-2022 and IEA 2020
+      source: Guatemala AMM 2021-2022; IEA 2020
       value: 383.240577
   lifecycle:
     battery discharge:
@@ -113,7 +113,7 @@ emissionFactors:
         value: 311.9991841222269
     unknown:
       _url: https://docs.google.com/spreadsheets/d/1CegROfej9HqRZTfihpjPpgZTYPUHrTNgTdHWbbP3w74/edit#gid=291258352
-      source: Guatemala AMM 2021-2022 and IEA 2020
+      source: Guatemala AMM 2021-2022; IEA 2020
       value: 549.9988504
 fallbackZoneMixes:
   powerOriginRatios:
@@ -181,3 +181,6 @@ parsers:
   consumption: GT.fetch_consumption
   production: GT.fetch_production
 timezone: America/Guatemala
+sources:
+  Guatemala AMM 2021-2022:
+    link: https://www.amm.org.gt/portal

config/zones/HR.yaml

@@ -106,7 +106,7 @@ emissionFactors:
       source: INCER ACV
       value: 29.03333333
     unknown:
-      source: 2018 average estimated from https://www.hops.hr/page-file/oEvvKj779KAhmQg10Gezt2/temeljni-podaci/Temeljni%20podaci%202018.pdf
+      source: HOPS 2018; HOPS 2018 derived calculation
       value: 240
     wind:
       datetime: '2021-01-01'
@@ -171,6 +171,10 @@ price_displayed: false
 sources:
   EU-ETS, ENTSO-E 2021:
     link: https://drive.google.com/file/d/15UeUHyhcjVw8fGLc0Zx_HELSx20cw_-e/view?usp=share_link
+  HOPS 2018:
+    link: https://www.hops.hr/page-file/oEvvKj779KAhmQg10Gezt2/temeljni-podaci/Temeljni%20podaci%202018.pdf
+  HOPS 2018 derived calculation:
+    link: https://github.com/electricitymaps/electricitymaps-contrib/pull/1965
   INCER ACV:
     link: https://docs.google.com/spreadsheets/d/1w5DJ7sPen6axIHU8TCVcuzNCjlct4I6JAbhUlw-ZXu8/edit?usp=sharing
   IPCC 2014:

config/zones/IN-KA.yaml

@@ -83,10 +83,8 @@ emissionFactors:
         source: Electricity Maps, 2021 average
         value: 459.2042079468457
     unknown:
-      _comment: 'Source: Souther Regional Load Dispatch Center Allocation Limits'
-      _url:
-        - http://srldc.org/2018-19srallocation.aspx
-      source: calculated 20% nuclear, 80% thermal (coal)
+      _comment: calculated 20% nuclear, 80% thermal (coal)
+      source: Souther Regional Load Dispatch Center Allocation Limits 2018-2019; SRLDC 2018-2019 derived calculation for Karnataka
       value: 658.4
 fallbackZoneMixes:
   powerOriginRatios:
@@ -169,3 +167,8 @@ parsers:
   consumption: IN_KA.fetch_consumption
   production: IN_KA.fetch_production
 timezone: Asia/Kolkata
+sources:
+  Souther Regional Load Dispatch Center Allocation Limits 2018-2019:
+    link: http://srldc.org/2018-19srallocation.aspx
+  SRLDC 2018-2019 derived calculation for Karnataka:
+    link: https://github.com/electricitymaps/electricitymaps-contrib/issues/1867

config/zones/JP-CG.yaml

@@ -17,10 +17,7 @@ capacity:
 emissionFactors:
   lifecycle:
     unknown:
-      _comment: 'Source: Enerdata 2022 Japanese National Average'
-      _url:
-        - https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf
-      source: Enerdata 2022
+      source: 'Enerdata 2022 Japanese National Average'
       value: 462
 contributors:
   - tmslaine
@@ -31,3 +28,6 @@ parsers:
   price: JP.fetch_price
   production: JP.fetch_production
 timezone: Asia/Tokyo
+sources:
+  Enerdata 2022 Japanese National Average:
+    link: https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf

config/zones/JP-HKD.yaml

@@ -24,13 +24,13 @@ contributors:
 emissionFactors:
   lifecycle:
     unknown:
-      _comment: 'Source: Enerdata 2022 Japanese National Average'
-      _url:
-        - https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf
-      source: Enerdata 2022
+      source: 'Enerdata 2022 Japanese National Average'
       value: 462
 parsers:
   consumptionForecast: JP.fetch_consumption_forecast
   price: JP.fetch_price
   production: JP.fetch_production
 timezone: Asia/Tokyo
+sources:
+  Enerdata 2022 Japanese National Average:
+    link: https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf

config/zones/JP-HR.yaml

@@ -22,13 +22,13 @@ disclaimer: The data provider (Hokuriku Electric Power Co.,Inc.) provides live d
 emissionFactors:
   lifecycle:
     unknown:
-      _comment: 'Source: Enerdata 2022 Japanese National Average'
-      _url:
-        - https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf
-      source: Enerdata 2022
+      source: 'Enerdata 2022 Japanese National Average'
       value: 462
 parsers:
   consumptionForecast: JP.fetch_consumption_forecast
   price: JP.fetch_price
   production: JP.fetch_production
 timezone: Asia/Tokyo
+sources:
+  Enerdata 2022 Japanese National Average:
+    link: https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf

config/zones/JP-ON.yaml

@@ -19,13 +19,13 @@ capacity:
 emissionFactors:
   lifecycle:
     unknown:
-      _comment: 'Source: Enerdata 2022 Japanese National Average'
-      _url:
-        - https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf
-      source: Enerdata 2022
+      source: 'Enerdata 2022 Japanese National Average'
       value: 462
 parsers:
   consumptionForecast: JP.fetch_consumption_forecast
   price: JP.fetch_price
   production: JP.fetch_production
 timezone: Asia/Tokyo
+sources:
+  Enerdata 2022 Japanese National Average:
+    link: https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf

config/zones/JP-SK.yaml

@@ -23,13 +23,13 @@ disclaimer: The data provider (Yonden Shikoku Electric Power Co.,Inc.) provides
 emissionFactors:
   lifecycle:
     unknown:
-      _comment: 'Source: Enerdata 2022 Japanese National Average'
-      _url:
-        - https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf
-      source: Enerdata 2022
+      source: 'Enerdata 2022 Japanese National Average'
       value: 462
 parsers:
   consumptionForecast: JP.fetch_consumption_forecast
   price: JP.fetch_price
   production: JP.fetch_production
 timezone: Asia/Tokyo
+sources:
+  Enerdata 2022 Japanese National Average:
+    link: https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf

config/zones/JP-TH.yaml

@@ -23,13 +23,13 @@ contributors:
 emissionFactors:
   lifecycle:
     unknown:
-      _comment: 'Source: Enerdata 2022 Japanese National Average'
-      _url:
-        - https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf
-      source: Enerdata 2022
+      source: 'Enerdata 2022 Japanese National Average'
       value: 462
 parsers:
   consumptionForecast: JP.fetch_consumption_forecast
   price: JP.fetch_price
   production: JP.fetch_production
 timezone: Asia/Tokyo
+sources:
+  Enerdata 2022 Japanese National Average:
+    link: https://www.climate-transparency.org/wp-content/uploads/2022/10/CT2022-Japan-Web.pdf

config/zones/MX-CE.yaml

@@ -8,14 +8,17 @@ emissionFactors:
   direct:
     unknown:
       - datetime: '2020-01-01'
-        source: 'https://www.iea.org/data-and-statistics/charts/electricity-generation-mix-in-mexico-1-jan-30-sep-2019-and-2020'
+        source: 'IEA, Electricity generation mix in Mexico, 1 Jan - 30 Sep, 2019 and 2020, IEA, Paris'
         comment: 'Assumes a mix of 3.6% nuclear, 8.8% hydro, 8.4% oil, 63.4% gas, 4.2% coal, 4.3%solar, 5.9% wind, 1.5% other renewables with default IPCC2014 values.'
         value: 305
   lifecycle:
     unknown:
       - datetime: '2020-01-01'
-        source: 'https://www.iea.org/data-and-statistics/charts/electricity-generation-mix-in-mexico-1-jan-30-sep-2019-and-2020'
+        source: 'IEA, Electricity generation mix in Mexico, 1 Jan - 30 Sep, 2019 and 2020, IEA, Paris'
         comment: 'Assumes a mix of 3.6% nuclear, 8.8% hydro, 8.4% oil, 63.4% gas, 4.2% coal, 4.3%solar, 5.9% wind, 1.5% other renewables with default IPCC2014 values.'
         value: 411
 parsers:
   consumption: CENACE.fetch_consumption
+sources:
+  'IEA, Electricity generation mix in Mexico, 1 Jan - 30 Sep, 2019 and 2020, IEA, Paris':
+    link: https://www.iea.org/data-and-statistics/charts/electricity-generation-mix-in-mexico-1-jan-30-sep-2019-and-2020

config/zones/MX-NE.yaml

@@ -8,14 +8,17 @@ emissionFactors:
   direct:
     unknown:
       - datetime: '2020-01-01'
-        source: 'https://www.iea.org/data-and-statistics/charts/electricity-generation-mix-in-mexico-1-jan-30-sep-2019-and-2020'
+        source: 'IEA, Electricity generation mix in Mexico, 1 Jan - 30 Sep, 2019 and 2020, IEA, Paris'
         comment: 'Assumes a mix of 3.6% nuclear, 8.8% hydro, 8.4% oil, 63.4% gas, 4.2% coal, 4.3%solar, 5.9% wind, 1.5% other renewables with default IPCC2014 values.'
         value: 305
   lifecycle:
     unknown:
       - datetime: '2020-01-01'
-        source: 'https://www.iea.org/data-and-statistics/charts/electricity-generation-mix-in-mexico-1-jan-30-sep-2019-and-2020'
+        source: 'IEA, Electricity generation mix in Mexico, 1 Jan - 30 Sep, 2019 and 2020, IEA, Paris'
         comment: 'Assumes a mix of 3.6% nuclear, 8.8% hydro, 8.4% oil, 63.4% gas, 4.2% coal, 4.3%solar, 5.9% wind, 1.5% other renewables with default IPCC2014 values.'
         value: 411
 parsers:
   consumption: CENACE.fetch_consumption
+sources:
+  'IEA, Electricity generation mix in Mexico, 1 Jan - 30 Sep, 2019 and 2020, IEA, Paris':
+    link: https://www.iea.org/data-and-statistics/charts/electricity-generation-mix-in-mexico-1-jan-30-sep-2019-and-2020