Code lists

Every closed code list the loader validates against. A value outside these sets halts the ingest (UnmappedSourceValue): an adapter never invents a code and never falls back to unknown. Adding one is a deliberate migration plus a seed update.

Six of these lists are also spreadsheets, regenerated whenever a list changes: categories.xlsx, system-boundaries.xlsx, classification-schemes.xlsx, units.xlsx, licence-terms.xlsx and, for the regions, geography.xlsx. Each opens with an About sheet that names the page explaining it.

system_boundary: 63 codes#

The column that keeps wrong numbers out: it is the position on the decomposition axis, not a label. Aggregate only over family <> 'contribution': a contribution is a part of its parent factor and is never reported alone. unknown is explicit ignorance, never a fallback.

family asset_stage (16)#

code name standard means
A1 Raw material supply en15804 EN 15804 module A1: raw material supply (product stage).
A2 Transport to manufacturer en15804 EN 15804 module A2: transport of raw materials to the manufacturer (product stage).
A3 Manufacturing en15804 EN 15804 module A3: manufacturing (product stage).
A4 Transport to site en15804 EN 15804 module A4: transport of the finished product to the construction site.
A5 Installation en15804 EN 15804 module A5: installation of the product into the building.
B1 Use en15804 EN 15804 module B1: use of the installed product.
B2 Maintenance en15804 EN 15804 module B2: maintenance.
B3 Repair en15804 EN 15804 module B3: repair of the installed product (use stage).
B4 Replacement en15804 EN 15804 module B4: replacement.
B5 Refurbishment en15804 EN 15804 module B5: refurbishment.
B6 Operational energy use en15804 EN 15804 module B6: operational energy use.
B7 Operational water use en15804 EN 15804 module B7: operational water use.
C1 Deconstruction and demolition en15804 EN 15804 module C1: de-construction / demolition (end-of-life).
C2 Transport to waste processing en15804 EN 15804 module C2: transport to waste processing (end-of-life).
C3 Waste processing en15804 EN 15804 module C3: waste processing for reuse/recovery/recycling (end-of-life).
C4 Disposal en15804 EN 15804 module C4: disposal (end-of-life).

family contribution (17)#

code name standard means
agriculture Agriculture open_ef Contribution slice: agricultural production stage of the parent factor's total. Never reported alone.
processing Processing open_ef Contribution slice: processing/transformation stage of the parent factor's total. Never reported alone.
packaging Packaging open_ef Contribution slice: packaging stage of the parent factor's total. Never reported alone.
transport Transport open_ef Contribution slice: transport/logistics stage of the parent factor's total. Never reported alone.
distribution Distribution and retail open_ef Contribution slice: retail storage and distribution stage of the parent factor's total. Never reported alone.
consumption Consumer use open_ef Contribution slice: consumer use/preparation stage of the parent factor's total. Never reported alone.
land_use_change Land-use change open_ef Contribution slice: emissions and removals from land-use change attributed to the product: dLUC, sLUC or iLUC; see the value's luc_method qualifier. Direct LUC is the above- and below-ground carbon stock change on land converted for this production, statistical LUC spreads a region's conversion over its crops, and indirect LUC is the conversion displaced elsewhere by the demand. Never reported alone; it is the single most commonly separated agricultural component and is published as its own line by ADEME, Agribalyse, GLEAM and GFLI. Whether a whole boundary INCLUDES this burden is not a scope term but a property of the value: read value_co2_luluc_native and co2e_basis.
inputs Raw materials and inputs open_ef Contribution slice: raw materials and other inputs (ADEME 'Intrants') of the parent factor's total. Never reported alone.
manufacturing Manufacturing open_ef Contribution slice: manufacturing/assembly stage (ADEME 'Fabrication') of the parent factor's total. Never reported alone.
energy_use Production energy open_ef Contribution slice: energy consumed during production (ADEME 'Energie') of the parent factor's total. Never reported alone.
amortization Capital goods amortization open_ef Contribution slice: capital goods (plant, buildings, vehicles) amortized over the parent factor's output, e.g. ADEME's 'Amortissement' and UBA AT's 'Fahrzeugherstellung'. Usually published beside the total it decomposes, but not always: a publisher may print the slice with no total, in which case the aggregate is derived and never invented.
collection Waste collection open_ef Contribution slice: waste collection stage (ADEME 'Collecte') of the parent factor's total. Never reported alone.
treatment Waste treatment open_ef Contribution slice: waste treatment stage (ADEME 'Traitement') of the parent factor's total. Never reported alone.
incineration Incineration open_ef Contribution slice: incineration stage (ADEME 'Incinération') of the parent factor's total. Never reported alone.
avoided_credit Avoided-emission credit open_ef Contribution slice: an avoided-emission credit, stated by the publisher as its own signed number, for the burden a recovery route displaces elsewhere (recycled material substituting virgin, recovered energy substituting grid supply). It is NOT netted into the parent's treatment total, so summing it with the parent double-counts. The generic counterpart of EN 15804 module D, for publishers that declare a credit outside an EPD.
other Other stages open_ef Contribution slice: residual stage the publisher does not itemize (ADEME 'Autre'). Never reported alone.
D Benefits and loads beyond the boundary en15804 EN 15804 module D: benefits and loads beyond the system boundary (reuse/recovery/recycling potential). A signed credit, never added to the A-C total.

family energy_stage (12)#

code name standard means
combustion Combustion (direct, at point of use) open_ef Direct emissions from burning the fuel at the point of use, in a boiler, furnace, engine or vehicle (for a vehicle, tank-to-wheel). The buyer's Scope 1.
upstream_fuel Upstream fuel (well-to-tank) open_ef Extraction, refining and transport of the fuel before it is burned (well-to-tank). The buyer's Scope 3 category 3.
generation Generation open_ef Combustion at the generating plant for purchased energy carriers. The buyer's Scope 2.
transmission_distribution Transmission and distribution losses open_ef Grid or network losses between generation and the point of use. The buyer's Scope 3 category 3.
transmission_distribution_upstream Upstream of transmission and distribution losses open_ef Upstream (well-to-tank) of the energy a grid or network loses between generation and the point of use: extraction, refining and transport of the fuel that generated the lost energy. The companion of transmission_distribution, which prices the lost energy's own generation; together they are the loss leg of the buyer's Scope 3 category 3, and neither is a total on its own.
fugitive Fugitive releases open_ef Unintended releases (leaks, venting, process escapes) attributable to the activity.
aviation_non_co2 Aviation non-CO2 effects (contrails) open_ef The non-CO2 warming of a flight at altitude, chiefly the condensation trails and the cirrus they seed, priced in CO2e beside the fuel the aircraft burns (ADEME's Trainées de condensation). A part of an aviation total, never a factor on its own; the number it reads is set by the radiative-forcing multiplier the publisher chose, and no greenhouse-gas inventory standard requires it.
well_to_use Well-to-use (upstream, burn or generation, network losses) open_ef One unit of energy as consumed, priced from the well to the point of use: the well-to-tank chain plus the burn for a fuel; generation, its well-to-tank and the transmission and distribution losses for a delivered carrier (electricity, steam or hot water, chilled water). ISO 14083's well-to-wheel, which reads the network losses into an electric vehicle's factor, generalised to stationary energy; in GHG Protocol terms the buyer's Scope 1 or Scope 2 plus the fuel- and energy-related part of Scope 3 category 3. The asset that burns or generates is outside. The upstream chain and the network losses are answered per factor by boundary_profile, since a publisher may print the delivered carrier without its well-to-tank or a fuel without its network; the burn or the generation is in on every factor.
generation_and_upstream Generation and upstream (before network losses) open_ef Everything before the network: one unit of a delivered energy carrier priced from the well to the plant, so the generation plus the well-to-tank chain of the fuel it burns, without the transmission and distribution losses between the plant and the point of use. A publisher's life-cycle figure for energy as generated lands here (Statistics Finland's life-cycle coefficient for electricity); adding the transmission_distribution leg gives the well_to_use total. In GHG Protocol terms the buyer's Scope 2 plus the well-to-tank part of Scope 3 category 3, without its loss part. The asset that generates is outside.
generation_and_network Generation and network losses (before upstream) open_ef Delivered without its upstream chain: one unit of a delivered energy carrier (electricity, steam or hot water, chilled water) priced as the generation or heat production plus the transmission and distribution losses between the plant and the point of use, without the well-to-tank chain of the fuel the plant burns. A publisher's figure per unit of energy sold that bills the plant's combustion against the energy delivered lands here (Japan's statutory district-heat coefficients, MOD-0096 D1); adding the well-to-tank legs gives the well_to_use total. In GHG Protocol terms the buyer's Scope 2 plus the loss part of Scope 3 category 3, without its well-to-tank part. The asset that generates is outside.
energy_lifecycle Energy, full life cycle (fuel cycle and asset) open_ef Full life-cycle emissions of one unit of energy service (a kWh generated, or a vehicle-, passenger- or tonne-kilometre moved): extraction and delivery of the fuel or electricity, its combustion in the plant or vehicle, and the manufacture of the generating asset or vehicle itself amortized over its lifetime output. The asset is exactly what separates it from well_to_use and generation, which put it outside. The shared network the energy travels on (grid losses, roads, rail, ports, airports) is out unless the factor's boundary_profile says otherwise, as it does for a grid supply mix that carries its network losses. Whether the asset's own maintenance rides inside the capital-goods leg is likewise the publisher's choice, so read the boundary_profile.
useful_heat_lifecycle Useful heat, full life cycle (fuel cycle and heating system) open_ef Full life-cycle emissions of one kWh of useful heat delivered by a heating system: extraction and delivery of the fuel or electricity the system takes in, its combustion or conversion in the boiler, stove or heat pump, and the manufacture of the heating system itself amortized over its lifetime heat output. The denominator is the heat the system gives off, not the energy it takes in, so the system's efficiency is inside the number; that is what separates it from energy_lifecycle, whose kWh is the carrier itself, and the two never share a facet without that conversion. Disposal of the heating system is out.

family lifecycle (17)#

code name standard means
cradle_to_gate Cradle to gate open_ef Extraction of raw materials through production, up to the producer's factory gate. Excludes distribution, use and end-of-life.
cradle_to_grave Cradle to grave open_ef Full life cycle: cradle_to_gate plus distribution, use phase and end-of-life.
cradle_to_grave_embodied Cradle to grave, embodied (excl. use) open_ef The whole life cycle EXCEPT the use stage: cradle_to_gate plus distribution to site, installation and end-of-life (EN 15804 A1-A3 + A4 + A5 + C1-C4). This is the industry's embodied carbon cut, and it exists as its own code because it is the only whole-life number that compares across products: a cradle_to_grave total built from EN 15804 is dominated by module B6, operational energy over a reference service life, which is a property of the building the product sits in rather than of the product. Measured over the 1,530 OEKOBAUDAT EPDs declaring a complete A+B+C set, A-C is a median 29.3x the gate and B6 alone a median 19.1x; this cut is a median 1.09x.
epd_total EPD total (declared modules) en15804 The sum of every EN 15804 module an EPD declares, when that set is not the complete A-C grid (MOD-0034). Always at least the product stage A1-A3 plus one more module; which modules it holds is per factor and is written on the parent's boundary_profile and its member links, never on this code. It exists because an EPD that declares, say, A1-A5 + B6 + C1-C4 has a publisher-defined total that is neither cradle_to_grave (B1-B5, B7 missing) nor cradle_to_grave_embodied (B6 present); the name says what this EPD declared rather than pretending to a standard envelope. Declared-partition only: never a cover-rule target, and never compared across products without reading the profile.
cradle_to_consumer Cradle to consumer open_ef Cradle through to the product as consumed, including consumer preparation. Excludes end-of-life.
gate_to_gate Gate to gate (one production step) open_ef One production step at one site, from its input gate to its output gate: the material the step converts arrives without the burden of producing it, and the step's own conversion, the fuel it burns and the energy it buys are inside. Nothing upstream of the input gate for that material and nothing downstream of the output gate is counted, so it understates the product's cradle-to-gate figure and never substitutes for it. Whether the step's inbound transport, energy supply chains, packaging and equipment are traced is answered per library (Plastics Recyclers Europe's recycling EcoProfiles trace all but packaging).
cradle_to_farm_gate Cradle to farm gate open_ef Agricultural production only, up to the farm gate.
cradle_to_processing_gate Cradle to processing gate open_ef Cradle_to_farm_gate plus processing/transformation.
cradle_to_plant_gate Cradle to plant gate open_ef Cradle to the gate of the plant that produces a FEED material (the GFLI compound-feed boundary). Deliberately not cradle_to_processing_gate: the animal production stage is entirely outside, so reusing the processing-gate code would claim a farm stage that was never modelled.
cradle_to_packaging_gate Cradle to packaging gate open_ef Cradle_to_processing_gate plus packaging.
cradle_to_distribution_gate Cradle to distribution gate open_ef Cradle_to_packaging_gate plus transport to the point of sale.
cradle_to_store_gate Cradle to store gate open_ef Cradle_to_distribution_gate plus retail storage and distribution.
cbam_embedded CBAM embedded emissions eu_cbam Embedded emissions of a CBAM good as the EU defines them: the direct emissions of the production processes at the installation (the EU ETS installation boundary), the indirect emissions of the electricity those processes consume, and the embedded emissions of the relevant precursors. Deliberately NOT cradle_to_gate: the fuels' upstream (well-to-tank), transport of inputs to the installation, and capital equipment and infrastructure are all outside it.
own_operations Own operations (direct only) open_ef The direct emissions of the producing industry or activity itself, per unit of its output or spend: its own fuel combustion, process and fugitive releases. No input it buys is inside: not its materials, not the upstream of its fuels, not the electricity or heat it purchases. Stands alone as a direct-only intensity (a statistics office's emissions per unit of output), or sits under a supply-chain total that contains it. Never a footprint: for a service industry it reads near zero where the supply chain is most of the impact.
process_direct Process emissions (direct, non-combustion) open_ef The direct non-combustion emissions of an industrial, agricultural or waste process itself, per unit of its activity: the gas its chemistry or biology releases (CO2 from calcining carbonates or from a reductant, CH4 from enteric fermentation, a flooded paddy or stored manure, N2O from nitrogen applied to soil or from nitric and adipic acid). The fuel the process burns is outside, as are the electricity and heat it buys and the upstream of every input; a leak is filed as fugitive, not here. Reported alone as the whole quantity a mandatory programme bills (IPCC sectors 2 and 3), never a footprint.
domestic_supply_chain Domestic supply chain (imports excluded) open_ef Cradle to gate within one national economy: the producing industry's own emissions plus those of its domestic suppliers at every tier, from a single-country input-output model. The emissions embodied in imported inputs are outside, so the number is lower than a multi-regional cradle_to_gate footprint of the same product, by a margin that grows with the share of imports in its supply chain.
end_of_life End of life open_ef Treatment of the product after use: collection, recycling, incineration, landfill. EN 15804 modules C1-C4 together.

family unknown (1)#

code name standard means
unknown Unspecified open_ef The publisher states no boundary and none can be derived. Explicit ignorance, never a fallback for an unmapped value.

Life-cycle coverage (63 codes, MOD-0032)#

Which of the four phases each boundary covers, declared per code in ingest/lifecycle_coverage.py and stored on system_boundary.phase_*, role and preset. A phase reads full, partial, none, unstated (the publisher's silence) or n_a (a phase the product has no such thing as); the last two are never none. role says whether the number is a whole answer, a part to add to others, a credit to keep apart or unknown. preset is the reader-facing group the explorer's boundary filter draws as a parent; each code sits under exactly one, and a preset's role is the role of every code under it. A part's topic is the sub-heading the rail files it under (empty for the residual part that belongs to none).

preset role topic name codes
cradle_to_gate whole Cradle to gate cradle_to_gate, cradle_to_farm_gate, cradle_to_processing_gate, cradle_to_plant_gate, cradle_to_packaging_gate, cbam_embedded, domestic_supply_chain
cradle_to_shelf whole Cradle to shelf cradle_to_distribution_gate, cradle_to_store_gate, cradle_to_consumer
full_lifecycle whole Full life cycle cradle_to_grave, cradle_to_grave_embodied, epd_total
end_of_life_waste whole End of life / waste end_of_life
energy_full_chain whole Energy, full chain well_to_use, generation_and_network, energy_lifecycle, useful_heat_lifecycle
energy_partial_chain whole Energy, partial chain generation_and_upstream
direct_only part energy Direct only combustion, fugitive, aviation_non_co2, generation, own_operations, process_direct
supply_chain_only part energy Supply chain only upstream_fuel, transmission_distribution, transmission_distribution_upstream
upstream_slice part products Upstream slices A1, A2, agriculture, inputs, amortization, land_use_change
production_slice part products Production slices A3, processing, manufacturing, gate_to_gate, packaging, energy_use
use_slice part products Use & distribution slices A4, A5, B1, B2, B3, B4, B5, B6, B7, distribution, consumption, transport
eol_slice part waste End-of-life slices C1, C2, C3, C4, collection, treatment, incineration
other_slice part Other, unspecified slice other
credit credit Credit D, avoided_credit
unknown unknown Unknown unknown
code upstream production downstream eol role preset
cradle_to_gate full full none none whole cradle_to_gate
cradle_to_farm_gate full partial none none whole cradle_to_gate
cradle_to_processing_gate full partial none none whole cradle_to_gate
cradle_to_plant_gate full full none none whole cradle_to_gate
cradle_to_packaging_gate full full none none whole cradle_to_gate
cbam_embedded partial partial none none whole cradle_to_gate
domestic_supply_chain partial full none none whole cradle_to_gate
cradle_to_distribution_gate full full partial none whole cradle_to_shelf
cradle_to_store_gate full full partial none whole cradle_to_shelf
cradle_to_consumer full full partial none whole cradle_to_shelf
cradle_to_grave full full full full whole full_lifecycle
cradle_to_grave_embodied full full partial full whole full_lifecycle
epd_total full full partial partial whole full_lifecycle
end_of_life none none none full whole end_of_life_waste
well_to_use full full n_a n_a whole energy_full_chain
generation_and_upstream partial full n_a n_a whole energy_partial_chain
generation_and_network partial full n_a n_a whole energy_full_chain
energy_lifecycle full full n_a n_a whole energy_full_chain
useful_heat_lifecycle full full partial none whole energy_full_chain
combustion none full n_a n_a part direct_only
fugitive none full n_a n_a part direct_only
aviation_non_co2 none full n_a n_a part direct_only
generation none full n_a n_a part direct_only
own_operations none partial none none part direct_only
process_direct none partial none none part direct_only
upstream_fuel full none n_a n_a part supply_chain_only
transmission_distribution full none n_a n_a part supply_chain_only
transmission_distribution_upstream full none n_a n_a part supply_chain_only
A1 partial none none none part upstream_slice
A2 partial none none none part upstream_slice
A3 partial full none none part production_slice
A4 none none partial none part use_slice
A5 none none partial none part use_slice
B1 none none partial none part use_slice
B2 none none partial none part use_slice
B3 none none partial none part use_slice
B4 none none partial none part use_slice
B5 none none partial none part use_slice
B6 none none partial none part use_slice
B7 none none partial none part use_slice
C1 none none none partial part eol_slice
C2 none none none partial part eol_slice
C3 none none none partial part eol_slice
C4 none none none partial part eol_slice
D none none none none credit credit
agriculture partial none none none part upstream_slice
inputs partial none none none part upstream_slice
amortization partial none none none part upstream_slice
processing none partial none none part production_slice
manufacturing none partial none none part production_slice
gate_to_gate partial partial none none part production_slice
packaging none partial none none part production_slice
energy_use none partial none none part production_slice
distribution none none partial none part use_slice
consumption none none partial none part use_slice
transport partial none partial none part use_slice
land_use_change partial none none none part upstream_slice
collection none none none partial part eol_slice
treatment none none none partial part eol_slice
incineration none none none partial part eol_slice
avoided_credit none none none none credit credit
other unstated unstated unstated unstated part other_slice
unknown unstated unstated unstated unstated unknown unknown

boundary_scope_term: 24 terms#

The questions a boundary answers. Read them through factors_flat.boundary_scope, which layers, most specific first, the factor's own boundary_profile, the publisher's publisher_boundary_scope rows (its sub-category, its category, the whole library) and the boundary default; boundary_scope_source names the layer that answered each key, or factor_deduction where no layer stated the term and the mark was read off the factor's value, name or EN 15804 modules under a published rule. varies is stored but never served: it reads not_stated. A library row may answer not_stated itself, where the library's documents are silent and the boundary default would otherwise answer for it. Sparse on purpose: a missing key means does not apply or not established, never excluded.

A stage is one of the four life-cycle phases, or one of two that are not phases and are drawn apart from them: beyond_boundary (a credit, EN 15804 module D) and inclusion (a content counted across every phase). Carbon pools (biogenic CO2, land-use change) are not terms: the value's co2e_basis and gas legs answer them.

applies to lists the subject kinds the term can apply to (boundary_scope_term.subject_kinds, MOD-0044). factors_flat serves a term only on a factor whose category is of one of those kinds.

term name stage applies to question
raw_materials Raw materials upstream product, service, waste Extraction and production of the material inputs the activity consumes.
inbound_transport Inbound transport upstream product, service, waste Transport of inputs to the site where the activity happens.
upstream_fuel Upstream fuel (well-to-tank) upstream product, grid_energy, fuel, transport, service, waste, land Extraction, refining and delivery of the fuels the activity burns, before combustion (well-to-tank).
td_losses Transmission and distribution losses upstream grid_energy, transport Energy lost in transmission and distribution between generation and the point of use.
imported_inputs Imported inputs upstream product, grid_energy, fuel, transport, service, waste Emissions embodied in the inputs the activity's supply chain imports from abroad, at every tier. A multi-regional input-output model counts them; a single-country model stops at the border and leaves them out.
fuel_combustion Fuel combustion production product, grid_energy, fuel, transport, service, waste, direct, land Combustion of fuel by the activity itself (tank-to-wheel; the operator's Scope 1).
fugitive_release Fugitive releases production product, grid_energy, fuel, transport, waste, direct Direct releases to atmosphere attributable to the activity other than the accounted combustion of its fuel: refrigerant and process leakage, venting, flaring, pipeline losses, and the non-CO2 legs a publisher reports beside a combustion total.
manufacturing Manufacturing production product, service, waste Conversion, assembly and on-site processing that turns the inputs into the product.
packaging Packaging production product Production of the product's own primary and secondary packaging.
purchased_electricity Purchased electricity and heat production product, grid_energy, fuel, transport, service, waste Network-delivered energy consumed by the activity, and the generation emissions of it: the four carriers the GHG Protocol puts in Scope 2: electricity, steam, heating and cooling. The code keeps the electricity name because that is the carrier every publisher in the corpus prices; district heat and chilled water answer the same question and are read here rather than in a separate term.
outbound_transport Outbound transport downstream product Distribution of the finished product from the producer to the point of sale or use.
retail Retail downstream product Retail storage, refrigeration and store operation before the product is bought.
installation Installation downstream product Installing or assembling the product where it will be used, including installation waste.
use_phase Use phase downstream product Energy, water and consumables used while the product is in service (incl. consumer preparation).
maintenance Maintenance downstream product Repair, replacement and refurbishment during the product's service life.
end_of_life End of life eol product, waste Collection, transport and treatment of the product after use (recycling, incineration, landfill).
secondary_material_reprocessing Secondary material reprocessing eol product, waste Reprocessing recovered waste into secondary material: re-pulping, re-melting, re-granulating. The recycled-content (cut-off) method leaves this step to the material's next user, so a cut-off recycling factor stops at collection and sorting.
recycling_credit Recycling credit beyond_boundary product, waste Avoided burdens credited for material or energy recovered beyond the system boundary (EN 15804 module D).
capital_goods Capital goods inclusion product, grid_energy, fuel, transport, service, waste, land Production of the equipment, buildings and vehicles the activity uses, amortized over their output.
infrastructure Infrastructure inclusion grid_energy, fuel, transport Construction and maintenance of the shared networks the activity relies on (roads, rail, pipelines, grid).
business_travel Business travel inclusion product, grid_energy, fuel, transport, service, waste Business travel of the people carrying out the activity, in vehicles the organisation does not own (GHG Protocol Scope 3 category 6).
employee_commuting Employee commuting inclusion product, grid_energy, fuel, transport, service, waste Travel of the people carrying out the activity between their home and their place of work (GHG Protocol Scope 3 category 7).
overheads_services Overheads and services inclusion product, grid_energy, fuel, transport, service, waste Purchased services and overheads attributable to the activity (an input-output boundary contains them by construction; a process LCA usually does not).
product_transport Freight transport inclusion product, waste A freight leg of the product or of its inputs, without saying which one: inbound_transport and outbound_transport answer that where the publisher states it, this term only asserts that a freight leg is inside.

Subject kinds (category_subject_kind, 8 kinds)#

What a factor measures, coarsely: every open_ef_category branch has a kind, and a leaf listed here overrides its branch's. A term a factor's kind cannot have is never served on it, so a service lists no packaging and a building material no grid.

kind branches leaf overrides
product materials, manufactured_goods, food_agriculture, buildings_infrastructure
grid_energy electricity, heat_cooling
fuel fuels
transport transport
service services, water agricultural_operations, logistics_warehousing
waste waste
direct direct_emissions
land land_use_removals

Boundary defaults (system_boundary_scope, 338 rows)#

boundary in varies out
A1 raw_materials inbound_transport, manufacturing
A2 inbound_transport raw_materials
A3 manufacturing, packaging, fuel_combustion, purchased_electricity, upstream_fuel raw_materials, inbound_transport
A4 outbound_transport installation
A5 installation outbound_transport
B1 use_phase
B2 maintenance
B3 maintenance
B4 maintenance
B5 maintenance
B6 use_phase td_losses
B7 use_phase
C1 end_of_life
C2 end_of_life
C3 end_of_life secondary_material_reprocessing, recycling_credit
C4 end_of_life
D recycling_credit end_of_life
agriculture raw_materials
amortization capital_goods
aviation_non_co2 fugitive_release fuel_combustion, upstream_fuel
avoided_credit recycling_credit end_of_life
cbam_embedded raw_materials, manufacturing, fuel_combustion purchased_electricity upstream_fuel, inbound_transport, outbound_transport, packaging, capital_goods, infrastructure, maintenance, td_losses, use_phase, end_of_life, recycling_credit
collection end_of_life
combustion fuel_combustion upstream_fuel, purchased_electricity, capital_goods, infrastructure, td_losses
consumption use_phase
cradle_to_consumer raw_materials, manufacturing, packaging, outbound_transport, retail, use_phase end_of_life, recycling_credit, maintenance
cradle_to_distribution_gate raw_materials, manufacturing, packaging, outbound_transport capital_goods, overheads_services, business_travel, imported_inputs, upstream_fuel, purchased_electricity, inbound_transport, fuel_combustion retail, use_phase, end_of_life
cradle_to_farm_gate raw_materials manufacturing, packaging, outbound_transport, retail, use_phase, end_of_life
cradle_to_gate raw_materials, inbound_transport, upstream_fuel, fuel_combustion, purchased_electricity, manufacturing, packaging capital_goods, infrastructure, business_travel, employee_commuting, overheads_services outbound_transport, retail, installation, use_phase, maintenance, end_of_life, recycling_credit
cradle_to_grave raw_materials, inbound_transport, upstream_fuel, fuel_combustion, purchased_electricity, manufacturing, packaging, outbound_transport, use_phase, end_of_life installation, maintenance, retail, recycling_credit, capital_goods, infrastructure
cradle_to_grave_embodied raw_materials, inbound_transport, upstream_fuel, fuel_combustion, purchased_electricity, manufacturing, packaging, outbound_transport, installation, end_of_life recycling_credit, capital_goods, infrastructure, business_travel, employee_commuting, overheads_services use_phase, maintenance, retail
cradle_to_packaging_gate raw_materials, manufacturing, packaging outbound_transport, retail, use_phase, end_of_life
cradle_to_plant_gate raw_materials, manufacturing, inbound_transport use_phase, end_of_life
cradle_to_processing_gate raw_materials, manufacturing packaging, outbound_transport, retail, use_phase, end_of_life
cradle_to_store_gate raw_materials, manufacturing, packaging, outbound_transport, retail capital_goods, overheads_services, business_travel, imported_inputs, upstream_fuel, purchased_electricity, inbound_transport, fuel_combustion use_phase, end_of_life
distribution retail
domestic_supply_chain raw_materials, inbound_transport, upstream_fuel, fuel_combustion, fugitive_release, purchased_electricity, manufacturing, packaging capital_goods, infrastructure, business_travel, employee_commuting, overheads_services imported_inputs, outbound_transport, retail, installation, use_phase, maintenance, end_of_life, recycling_credit
end_of_life end_of_life secondary_material_reprocessing, recycling_credit raw_materials, manufacturing, use_phase
energy_lifecycle fuel_combustion, upstream_fuel, capital_goods infrastructure, purchased_electricity, td_losses manufacturing
energy_use fuel_combustion upstream_fuel, purchased_electricity
epd_total raw_materials, inbound_transport, upstream_fuel, fuel_combustion, purchased_electricity, manufacturing, packaging outbound_transport, installation, use_phase, maintenance, end_of_life, recycling_credit, capital_goods, infrastructure, business_travel, employee_commuting, overheads_services retail
fugitive fugitive_release fuel_combustion, upstream_fuel
gate_to_gate manufacturing, fuel_combustion, purchased_electricity inbound_transport, upstream_fuel, packaging, capital_goods raw_materials, outbound_transport, retail, installation, use_phase, maintenance, end_of_life
generation fuel_combustion, purchased_electricity upstream_fuel, td_losses, capital_goods
generation_and_network fuel_combustion, purchased_electricity, td_losses upstream_fuel, capital_goods, infrastructure
generation_and_upstream fuel_combustion, purchased_electricity, upstream_fuel td_losses, capital_goods, infrastructure
incineration end_of_life
inputs raw_materials
land_use_change raw_materials
manufacturing manufacturing
own_operations fuel_combustion, fugitive_release, manufacturing raw_materials, inbound_transport, upstream_fuel, purchased_electricity, td_losses, packaging, capital_goods, infrastructure, overheads_services, business_travel, employee_commuting
packaging packaging
process_direct manufacturing fuel_combustion, fugitive_release, raw_materials, inbound_transport, upstream_fuel, purchased_electricity, td_losses, packaging, capital_goods, infrastructure, overheads_services, business_travel, employee_commuting
processing manufacturing raw_materials, packaging
transmission_distribution td_losses upstream_fuel capital_goods
transmission_distribution_upstream upstream_fuel fuel_combustion, capital_goods
transport product_transport outbound_transport, inbound_transport raw_materials, manufacturing, packaging
treatment end_of_life secondary_material_reprocessing
upstream_fuel upstream_fuel purchased_electricity fuel_combustion, capital_goods, infrastructure
useful_heat_lifecycle fuel_combustion, upstream_fuel, capital_goods, use_phase end_of_life
well_to_use fuel_combustion upstream_fuel, td_losses, purchased_electricity capital_goods, infrastructure

end_of_life reads recycling_credit: varies deliberately. A treatment total may or may not net the credit for what recovery displaces: only the publisher knows, so the boundary establishes nothing: the factor's own boundary_profile decides, else its library's publisher_boundary_scope row (ADEME prints its recycling credits as separate factors, so its waste treatment factors read out), else the factor reads not_stated. A credit the publisher prints as its own signed number is never filed there: it takes avoided_credit, or EN 15804 module D, both contribution codes reading recycling_credit: in. That makes boundary_scope ->> 'recycling_credit' = 'in' the one cross-library selector for credits, and credit_on_lifecycle_family (gating) fails a publisher that files one under a lifecycle total instead.

GHG scope by reporter role#

A scope is not a property of a factor. The same kWh of grid electricity is Scope 2 to the office that buys it and Scope 1 to the utility that generates it. resolve_ghg_scopes(category, sub_category, boundary, child_boundaries) (ingest/ghg_scope.py) answers per role, from three inputs:

  • the category names the roles that can report the factor at all, the first being the default (category_reporter_role);
  • the role gives the slot of any part nothing else names (ghg_reporter_role.default_slot);
  • the boundary overrides that where the stage changes the answer (ghg_scope_assignment).

For a boundary b and a role: when b is a whole, the union of its parts' answers (system_boundary_relation), each part read inside b: a ghg_scope_leg_assignment row for (b, part, role) answers it; else a farm-gate contribution (inputs, energy_use, amortization, land_use_change) reads as agriculture (CONTRIBUTION_SLICES in ingest/boundary_relations.py); else the part resolves the same way, recursively. Else the rows for (b, role) are the answer; else the role's default slot, reported this period; else no claim. A whole carries no row of its own unless it sums into itself, so a total and the legs served under it cannot disagree. The factor's stored children narrow a whole: transmission_distribution is the loss leg unless it holds transmission_distribution_upstream, and a well_to_use whose children fit one rule sums that rule only. unknown and an uncategorised factor have no claim for any role. Claims of one role that carry a condition are alternatives: the reporter picks the one that matches its contract. A conditional claim is dropped when the role claims the same slot unconditionally.

A row served as a LEG of another row is read inside its parent, by resolve_leg_ghg_scopes(category, sub_category, leg, parent, child_boundaries): the same stage can land elsewhere there than it does for a factor of that boundary. A row in ghg_scope_leg_assignment for (parent, leg, role) is that reading; else a farm-gate contribution reads as agriculture, as inside a factor; else the leg reads as a factor of its own boundary would. So a farm gate sold as a factor is the farm itself, its parts read inside it, while a processor's farm-gate leg stays the farm output it bought. The API reads a leg under its parent's category, not the one its own row carries.

Reporting moments: this_period, during_use, at_end_of_life. Conditions: you_pay_delivery, customer_pays_delivery.

ghg_scope_slot: 25 slots#

Where an emission can land, in reading order. scope is NULL only for outside_scopes; category is set only inside Scope 3.

scheme code scope category label
ghg_protocol scope_1 1 Scope 1: direct emissions
ghg_protocol scope_1_stationary 1 Scope 1: stationary combustion
ghg_protocol scope_1_mobile 1 Scope 1: mobile combustion
ghg_protocol scope_1_fugitive 1 Scope 1: fugitive emissions
ghg_protocol scope_1_process 1 Scope 1: process emissions
ghg_protocol scope_2 2 Scope 2: indirect emissions from purchased energy
ghg_protocol scope_2_electricity 2 Scope 2: purchased electricity
ghg_protocol scope_2_heat_steam 2 Scope 2: purchased heat and steam
ghg_protocol scope_2_cooling 2 Scope 2: purchased cooling
ghg_protocol scope_3_1 3 1 Scope 3.1: Purchased goods and services
ghg_protocol scope_3_2 3 2 Scope 3.2: Capital goods
ghg_protocol scope_3_3 3 3 Scope 3.3: Fuel- and energy-related activities
ghg_protocol scope_3_4 3 4 Scope 3.4: Upstream transportation and distribution
ghg_protocol scope_3_5 3 5 Scope 3.5: Waste generated in operations
ghg_protocol scope_3_6 3 6 Scope 3.6: Business travel
ghg_protocol scope_3_7 3 7 Scope 3.7: Employee commuting
ghg_protocol scope_3_8 3 8 Scope 3.8: Upstream leased assets
ghg_protocol scope_3_9 3 9 Scope 3.9: Downstream transportation and distribution
ghg_protocol scope_3_10 3 10 Scope 3.10: Processing of sold products
ghg_protocol scope_3_11 3 11 Scope 3.11: Use of sold products
ghg_protocol scope_3_12 3 12 Scope 3.12: End-of-life treatment of sold products
ghg_protocol scope_3_13 3 13 Scope 3.13: Downstream leased assets
ghg_protocol scope_3_14 3 14 Scope 3.14: Franchises
ghg_protocol scope_3_15 3 15 Scope 3.15: Investments
ghg_protocol outside_scopes Outside the scopes: reported separately

ghg_reporter_role: 17 roles#

Who is reporting, in the order a reader is offered them. The default slot answers a part no assignment names; a role without one has no claim there.

# role default slot who
1 operator You own or control the activity: you run the plant that makes the energy, manage the land, or release the gas.
2 fuel_user 3.3 You buy the fuel and burn it: its combustion is yours, and everything before the burn is its upstream.
3 vehicle_operator You own or run the vehicle: you burn its fuel or charge it with electricity you buy.
4 energy_buyer You buy the electricity, heat, steam or cooling and use it.
5 grid_owner You own or operate the network that carries the energy, so the energy lost in it is yours.
6 purchaser 3.1 You buy the good or service and use it up in your operations.
7 capital_purchaser 3.2 You buy the good as a long-lived asset, such as a building, machine or vehicle.
8 freight_buyer_upstream 3.4 You pay a carrier or warehouse for goods you buy, or for delivering goods you sell.
9 freight_buyer_downstream 3.9 Goods you sold travel or are stored after they leave you, and you do not pay for it.
10 traveller 3.6 You or your staff travel for work in vehicles you do not own or run, hotel stays included.
11 commuter 3.7 Your staff travel between home and work.
12 waste_generator 3.5 Your operations produce the waste and someone else treats it.
13 seller You make and sell the product, so each stage falls in your own scopes or your value chain's.
14 lessee 3.8 You rent or lease the asset from its owner and operate it, and it is not already in your Scope 1 or 2.
15 lessor 3.13 You own the asset and lease it out, so someone else operates it.
16 sold_product_seller 3.11 You sold the product and someone else runs it: the energy that use consumes is your Scope 3 category 11, whichever part of the energy factor you read. Not the seller of the energy, who is its operator or its network owner.
17 sold_product_disposer You sold the product and someone else throws it away: its collection and treatment are your Scope 3 category 12. Not the one who sends the waste, whose category is 5, nor the one who treats it.

category_reporter_role: 35 categories#

The roles a category offers, in ordinal order; the first is the default. A leaf listed here replaces its branch's roles; every other leaf inherits them.

level category roles
branch fuels fuel_user, sold_product_seller
branch electricity energy_buyer, operator, grid_owner, sold_product_seller
branch heat_cooling energy_buyer, operator, grid_owner, sold_product_seller
branch water purchaser
branch materials purchaser, capital_purchaser, seller
branch manufactured_goods purchaser, capital_purchaser, seller
branch food_agriculture purchaser, seller
branch buildings_infrastructure capital_purchaser, seller
branch transport freight_buyer_upstream, freight_buyer_downstream, traveller, commuter, vehicle_operator
branch services purchaser
branch waste waste_generator, sold_product_disposer
branch direct_emissions operator
branch land_use_removals operator
leaf heat_generation operator, energy_buyer, sold_product_seller
leaf construction_products capital_purchaser, purchaser, seller
leaf machinery capital_purchaser, purchaser, seller
leaf vehicles capital_purchaser, purchaser, seller
leaf accommodation traveller, purchaser
leaf teleworking commuter
leaf logistics_warehousing freight_buyer_upstream, freight_buyer_downstream
leaf equipment_rental_leasing purchaser, lessee, lessor
leaf freight_road freight_buyer_upstream, freight_buyer_downstream, vehicle_operator
leaf freight_rail freight_buyer_upstream, freight_buyer_downstream, vehicle_operator
leaf freight_air freight_buyer_upstream, freight_buyer_downstream, vehicle_operator
leaf freight_sea freight_buyer_upstream, freight_buyer_downstream, vehicle_operator
leaf freight_inland_waterway freight_buyer_upstream, freight_buyer_downstream, vehicle_operator
leaf freight_pipeline freight_buyer_upstream, freight_buyer_downstream, vehicle_operator
leaf freight_multimodal freight_buyer_upstream, freight_buyer_downstream, vehicle_operator
leaf passenger_car traveller, commuter, vehicle_operator
leaf passenger_rail traveller, commuter, vehicle_operator
leaf passenger_air traveller, commuter, vehicle_operator
leaf passenger_bus_coach traveller, commuter, vehicle_operator
leaf passenger_ferry traveller, commuter, vehicle_operator
leaf passenger_two_three_wheeler traveller, commuter, vehicle_operator
leaf passenger_multimodal traveller, commuter, vehicle_operator

ghg_scope_assignment: 250 rows#

One row per (boundary, role, slot); rendered here grouped by role, with the boundaries that share an answer on one line. A boundary a role does not list falls back to its parts, then to the role's default slot.

role boundaries slots reported applies when note
operator inputs, A1, A2, agriculture, land_use_change, packaging, transport, distribution 3.3 this_period always A cradle-to-gate factor of energy you make: your plant (A3, or processing in a supply-chain total) is Scope 1, everything before or around it the fuel's upstream, 3.3.
operator A3, processing, manufacturing 1 this_period always A cradle-to-gate factor of energy you make: your plant (A3, or processing in a supply-chain total) is Scope 1, everything before or around it the fuel's upstream, 3.3.
operator C1, C2, C3, C4 1 this_period always Waste you vent, flare or release on your own site: Scope 1.
operator D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
operator own_operations 1 this_period always Your industry's own combustion, process and fugitive releases: Scope 1.
operator domestic_supply_chain 1, 2, 3.1, 3.3 this_period always Your industry's own emissions (1), the energy it buys (2) and its upstream (3.3), and its other domestic inputs (3.1).
operator generation, combustion 1 this_period always You burn the fuel or run the plant: Scope 1.
operator fugitive 1 this_period always Leaks and releases from equipment you own or control: Scope 1.
operator process_direct 1 this_period always The gas your own process releases by its chemistry or biology: Scope 1.
operator upstream_fuel 3.3 this_period always Extracting, refining and delivering the fuel you burn: Scope 3 category 3.
operator generation_and_network 1 this_period always You run the plant and its network: the burn behind the energy delivered, losses included, is Scope 1.
operator energy_use 1, 2 this_period always Fuel you burn on site is Scope 1; electricity or heat you buy is Scope 2.
operator amortization 3.2 this_period always The plant or vehicle you own is a capital good; the inventory reports it whole in 3.2 the year it is bought.
operator energy_lifecycle 1, 3.2, 3.3 this_period always Your combustion is Scope 1, the fuel's upstream 3.3, the amortized asset 3.2.
operator useful_heat_lifecycle 1, 2, 3.2, 3.3 this_period always Fuel your heating system burns is Scope 1, electricity or heat it draws Scope 2, their upstream 3.3, the amortized heating system 3.2.
operator other 3.1 this_period always The part of a process you run that the publisher does not itemize, read as its purchased inputs: Scope 3 category 1.
fuel_user D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
fuel_user generation, combustion, fugitive 1 this_period always You burn the fuel, or it leaks from equipment you control: Scope 1.
fuel_user upstream_fuel 3.3 this_period always Extracting, refining and delivering the fuel you burn: Scope 3 category 3.
fuel_user energy_use 1, 2 this_period always Fuel you burn on site is Scope 1; electricity or heat you buy is Scope 2.
fuel_user amortization 3.2 this_period always The plant or vehicle you own is a capital good; the inventory reports it whole in 3.2 the year it is bought.
fuel_user energy_lifecycle 1, 3.2, 3.3 this_period always Your combustion is Scope 1, the fuel's upstream 3.3, the amortized asset 3.2.
fuel_user useful_heat_lifecycle 1, 2, 3.2, 3.3 this_period always Fuel your heating system burns is Scope 1, electricity or heat it draws Scope 2, their upstream 3.3, the amortized heating system 3.2.
vehicle_operator A1, A2, upstream_fuel, transmission_distribution, transmission_distribution_upstream 3.3 this_period always The fuel's upstream and the electricity lost on the way to your charger: Scope 3 category 3.
vehicle_operator A3, energy_use 1, 2 this_period always Fuel your vehicles burn is Scope 1; electricity you buy to run them is Scope 2.
vehicle_operator D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
vehicle_operator generation 2 this_period always Generating the electricity you charge the vehicle with: Scope 2.
vehicle_operator combustion, fugitive 1 this_period always The fuel your vehicle burns, and the refrigerant it leaks: Scope 1.
vehicle_operator aviation_non_co2 1 this_period always The contrails your aircraft forms, beside the fuel it burns: reported with that Scope 1 burn where an inventory reports them at all.
vehicle_operator generation_and_network 2, 3.3 this_period always Generating the electricity you charge the vehicle with is Scope 2; the part lost on the way to your charger 3.3.
vehicle_operator amortization 3.2 this_period always The plant or vehicle you own is a capital good; the inventory reports it whole in 3.2 the year it is bought.
vehicle_operator energy_lifecycle 1, 2, 3.2, 3.3 this_period always Fuel burnt is Scope 1 or charging electricity Scope 2, their upstream 3.3, the amortized vehicle 3.2.
energy_buyer inputs, A1, A2, agriculture, land_use_change, packaging, transport, distribution 3.3 this_period always A cradle-to-gate factor of energy you buy: its generation (A3, or processing in a supply-chain total) is Scope 2, everything before or around it 3.3.
energy_buyer A3, processing, manufacturing 2 this_period always A cradle-to-gate factor of energy you buy: its generation (A3, or processing in a supply-chain total) is Scope 2, everything before or around it 3.3.
energy_buyer A4, other 3.3 this_period always A remainder of the energy you buy that is not its generation, or its delivery to you: Scope 3 category 3.
energy_buyer D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
energy_buyer own_operations 2 this_period always The direct emissions of the industry that generates the energy you buy: Scope 2.
energy_buyer domestic_supply_chain 2, 3.3 this_period always Generating the energy you buy is Scope 2; its domestic supply chain is 3.3.
energy_buyer generation, combustion, energy_use 2 this_period always Generating the energy you buy: Scope 2.
energy_buyer fugitive, upstream_fuel, transmission_distribution, transmission_distribution_upstream 3.3 this_period always The fuel's upstream and the energy lost on the way to you: Scope 3 category 3.
energy_buyer generation_and_network 2, 3.3 this_period always Generating the energy you buy is Scope 2; the energy lost on the way to you is 3.3.
energy_buyer energy_lifecycle 2, 3.3 this_period always Generation is Scope 2; the fuel's upstream and the amortized plant are 3.3.
energy_buyer useful_heat_lifecycle 2, 3.3 this_period always Heat you buy is Scope 2; the fuel's upstream and the amortized heating system are 3.3.
grid_owner inputs, A1, A2, agriculture, land_use_change, packaging, transport, distribution 3.3 this_period always A cradle-to-gate factor of energy you buy: its generation (A3, or processing in a supply-chain total) is Scope 2, everything before or around it 3.3.
grid_owner A3, processing, manufacturing 2 this_period always A cradle-to-gate factor of energy you buy: its generation (A3, or processing in a supply-chain total) is Scope 2, everything before or around it 3.3.
grid_owner A4, other 3.3 this_period always A remainder of the energy you buy that is not its generation, or its delivery to you: Scope 3 category 3.
grid_owner D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
grid_owner own_operations 2 this_period always The direct emissions of the industry that generates the energy you buy: Scope 2.
grid_owner domestic_supply_chain 2, 3.3 this_period always Generating the energy you buy is Scope 2; its domestic supply chain is 3.3.
grid_owner generation, combustion, energy_use 2 this_period always Energy you buy for your own use: Scope 2.
grid_owner upstream_fuel, transmission_distribution_upstream 3.3 this_period always The upstream of the energy lost or used: Scope 3 category 3.
grid_owner transmission_distribution 2 this_period always The energy lost in a network you own is your Scope 2 (Scope 2 Guidance).
grid_owner generation_and_network 2 this_period always Energy you buy for your own use and the energy lost in the network you own: Scope 2.
grid_owner energy_lifecycle 2, 3.3 this_period always Generation is Scope 2; the fuel's upstream and the amortized plant are 3.3.
purchaser A4 3.4 this_period always Delivery of the product to you: Scope 3 category 4.
purchaser B1 1 during_use always What the product releases while you use it: Scope 1, as it happens.
purchaser B2, B3 3.1 during_use always Maintenance and repair materials are purchased goods.
purchaser B4, B5 3.1 during_use always Replacement and refurbishment, reported as you buy them.
purchaser B6 1, 2, 3.3 during_use always The energy used: fuel you burn is Scope 1, energy you buy is Scope 2, and their upstream is 3.3.
purchaser B7 3.1, 3.5 during_use always Water you buy is 3.1; treating it after use is 3.5.
purchaser C1, C2, C3, C4 3.5 at_end_of_life always Discarding the product is waste from your operations: 3.5.
purchaser D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
purchaser consumption 1, 2, 3.3 during_use always Preparing and storing the food yourself. The energy used: fuel you burn is Scope 1, energy you buy is Scope 2, and their upstream is 3.3.
capital_purchaser A4 3.4 this_period always Delivery of the product to you: Scope 3 category 4.
capital_purchaser B1 1 during_use always What the product releases while you use it: Scope 1, as it happens.
capital_purchaser B2, B3 3.1 during_use always Maintenance and repair materials are purchased goods.
capital_purchaser B4, B5 3.2 during_use always Replacement and refurbishment, reported as you buy them.
capital_purchaser B6 1, 2, 3.3 during_use always The energy used: fuel you burn is Scope 1, energy you buy is Scope 2, and their upstream is 3.3.
capital_purchaser B7 3.1, 3.5 during_use always Water you buy is 3.1; treating it after use is 3.5.
capital_purchaser C1, C2, C3, C4 3.5 at_end_of_life always Discarding the product is waste from your operations: 3.5.
capital_purchaser D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
freight_buyer_upstream D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
freight_buyer_downstream D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
traveller D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
commuter D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
waste_generator D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
seller inputs, A1, agriculture, land_use_change, packaging 3.1 this_period always What you buy to make the product: Scope 3 category 1.
seller A2 3.4 this_period always Carrying what you buy to your plant: Scope 3 category 4, whoever pays.
seller A3, processing, manufacturing, energy_use 1, 2, 3.3 this_period always Your own production. The energy used: fuel you burn is Scope 1, energy you buy is Scope 2, and their upstream is 3.3.
seller A4, transport 3.4 this_period you_pay_delivery Delivery you pay for: Scope 3 category 4.
seller A4, transport 3.9 this_period customer_pays_delivery Delivery your customer pays for: Scope 3 category 9.
seller A5 3.10 this_period always Installing what you sold: Scope 3 category 10, reported the year you sell it.
seller B1, B2, B3, B4, B5, B6, B7, consumption 3.11 this_period always The use of what you sold: Scope 3 category 11, its lifetime reported the year you sell it.
seller C1, C2, C3, C4 3.12 this_period always The end of life of what you sold: Scope 3 category 12, reported the year you sell it.
seller D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
seller distribution 3.4 this_period you_pay_delivery Retail and storage you pay for after the goods leave you: Scope 3 category 4.
seller distribution 3.9 this_period customer_pays_delivery Retail and storage your customer pays for: Scope 3 category 9.
seller cradle_to_plant_gate 1, 2, 3.1, 3.3 this_period always Your feed plant's own energy (1, 2, 3.3) and the ingredients you buy (3.1).
seller cbam_embedded 1, 2, 3.1 this_period always Your installation's direct emissions (1), its electricity (2) and the precursors you buy (3.1).
seller own_operations 1 this_period always Your industry's own combustion, process and fugitive releases: Scope 1.
seller domestic_supply_chain 1, 2, 3.1, 3.3 this_period always Your industry's own emissions (1), the energy it buys (2) and its upstream (3.3), and its other domestic inputs (3.1).
seller process_direct 1 this_period always The gas your own process releases by its chemistry or biology: Scope 1.
seller amortization 3.2 this_period always Your plant and equipment: Scope 3 category 2.
lessee D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
lessor D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
sold_product_seller D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.
sold_product_disposer C1, C2, C3, C4, collection, treatment, incineration 3.12 this_period always The end of life of what you sold: Scope 3 category 12, reported the year you sell it.
sold_product_disposer D, avoided_credit outside this_period always A credit for reuse, recovery or recycling is reported outside the scopes.

ghg_scope_leg_assignment: 6 rows#

One row per (envelope, leg, role, slot): where a stage lands when it is read as a leg of that envelope, overriding what it reads anywhere else. No condition column; the envelope is the condition.

within leg role slot reported note
cradle_to_farm_gate agriculture seller 1 this_period Inside the farm gate the farming is the farm's own activity, so its seller reports it in Scope 1. Read anywhere else, the same stage is farm output bought from a farm, which is category 1.
cradle_to_farm_gate energy_use seller 1 this_period Inside the farm gate the farm's fuel and electricity are its seller's own: fuel burnt is Scope 1, electricity bought Scope 2, their upstream 3.3. To anyone else they are part of the farm output they buy.
cradle_to_farm_gate energy_use seller 2 this_period Inside the farm gate the farm's fuel and electricity are its seller's own: fuel burnt is Scope 1, electricity bought Scope 2, their upstream 3.3. To anyone else they are part of the farm output they buy.
cradle_to_farm_gate energy_use seller 3.3 this_period Inside the farm gate the farm's fuel and electricity are its seller's own: fuel burnt is Scope 1, electricity bought Scope 2, their upstream 3.3. To anyone else they are part of the farm output they buy.
cradle_to_farm_gate amortization seller 3.2 this_period Inside the farm gate the farm's buildings and machinery are its seller's capital goods, Scope 3 category 2. To anyone else they are part of the farm output they buy.
cradle_to_processing_gate cradle_to_farm_gate seller 3.1 this_period Inside the processing gate the farm gate is the farm output the processor buys, which is category 1. Read as the factor, the farm gate's seller is the farm itself.

system_boundary_relation: 61 relations#

Which stage sums into which (sums_to_parent), or is reported beside it (reported_beside_parent), per partition rule. A code may sum into itself: the delivered T&D total and its loss leg both carry transmission_distribution.

rule parent relation children
en15804_modules cradle_to_gate sums_to_parent A1, A2, A3
en15804_modules cradle_to_gate reported_beside_parent D
en15804_modules cradle_to_grave_embodied sums_to_parent cradle_to_gate, A4, A5, end_of_life
en15804_modules cradle_to_grave_embodied reported_beside_parent D
en15804_modules end_of_life sums_to_parent C1, C2, C3, C4
en15804_modules end_of_life reported_beside_parent D
en15804_modules cradle_to_grave sums_to_parent cradle_to_grave_embodied, B1, B2, B3, B4, B5, B6, B7
en15804_modules cradle_to_grave reported_beside_parent D
en15804_modules epd_total sums_to_parent cradle_to_gate, A4, A5, B1, B2, B3, B4, B5, B6, B7, end_of_life
en15804_modules epd_total reported_beside_parent D
delivered_energy transmission_distribution sums_to_parent transmission_distribution, transmission_distribution_upstream
delivered_energy well_to_use sums_to_parent generation, upstream_fuel, generation_and_upstream, transmission_distribution, generation_and_network
fuel_total generation_and_upstream sums_to_parent generation, upstream_fuel
fuel_total well_to_use sums_to_parent combustion, upstream_fuel
food_chain cradle_to_farm_gate sums_to_parent inputs, agriculture, land_use_change, energy_use, amortization
food_chain cradle_to_processing_gate sums_to_parent cradle_to_farm_gate, processing
food_chain cradle_to_packaging_gate sums_to_parent cradle_to_processing_gate, packaging
food_chain cradle_to_distribution_gate sums_to_parent cradle_to_packaging_gate, transport
food_chain cradle_to_store_gate sums_to_parent cradle_to_distribution_gate, distribution
food_chain cradle_to_consumer sums_to_parent cradle_to_store_gate, consumption

system_boundary.chain_ordinal: 63 positions#

One global reading order for every stage, 1-based, unknown last: parts before the whole they build, each gate of a ladder just before the slice that widens it. Any set of siblings sorts the same way everywhere (chain_sorted in ingest/boundary_relations.py).

inputs, A1, A2, A3, cradle_to_gate, A4, A5, cradle_to_grave_embodied, B1, B2, B3, B4, B5, B6, B7, C1, C2, C3, C4, end_of_life, D, cradle_to_grave, epd_total, agriculture, land_use_change, cradle_to_farm_gate, processing, cradle_to_processing_gate, packaging, cradle_to_packaging_gate, transport, cradle_to_distribution_gate, distribution, cradle_to_store_gate, consumption, cradle_to_consumer, gate_to_gate, manufacturing, cradle_to_plant_gate, cbam_embedded, own_operations, domestic_supply_chain, generation, combustion, fugitive, aviation_non_co2, process_direct, upstream_fuel, generation_and_upstream, transmission_distribution, transmission_distribution_upstream, generation_and_network, energy_use, well_to_use, amortization, energy_lifecycle, useful_heat_lifecycle, collection, treatment, incineration, avoided_credit, other, unknown

classification_scheme: 82 schemes#

is_standard is the join rule: a published standard means the same thing across publishers, so it is a legitimate cross-library key. A publisher's own tree is meaningful inside that library only.

code name authority standard publisher means
nace_rev1_1 NACE Rev. 1.1 Eurostat yes EU statistical classification of economic activities, revision 1.1 (2002). Level 1 = section letter, level 2 = two-digit division. The classification EXIOBASE 3's product aggregation is built on. NOT interchangeable with NACE Rev. 2.
nace_rev2 NACE Rev. 2 Eurostat yes Statistical classification of economic activities in the European Community, revision 2 (2008). The national versions (France's NAF rév. 2, Denmark's DB07, Norway's SN2007) are identical to it down to the 4-digit class, so one scheme carries them all. Level 1 = section letter, level 2 = two-digit division.
naics_2017 NAICS 2017 US Census Bureau yes North American Industry Classification System, 2017 revision. Level 6 = the six-digit national industry; a USEEIO commodity maps to one or more of them.
naics_canada_2022 NAICS Canada 2022 Statistics Canada yes North American Industry Classification System, Canadian 2022 version (Statistics Canada's national implementation). Level 5 = the five-digit industry, the deepest trilaterally-harmonised layer, so a level-5 code is comparable with the US and Mexican revisions; level 6 = the six-digit Canadian national industry, where the three countries diverge. The REVISION is part of the scheme code for the same reason it is in naics_2017: a code is only interpretable against a stated revision, and the two are not interchangeable at level 6.
snap97 SNAP 97 European Environment Agency (EMEP/CORINAIR) yes Selected Nomenclature for Air Pollution, the EMEP/CORINAIR source nomenclature of 1997 that national inventories key their emission sources on. Three levels, two digits each: level 1 the sector (01 combustion in energy industries ... 08 other mobile sources), level 2 the sub-sector (0101 public power), level 3 the activity (010101 combustion plants >= 300 MW). Prefix-derivable, so a factor carries the whole chain; a code printed with a trailing 00 (010100) names the level above and is stored at that level (0101). National inventories extend it inside unused ranges, and an extension code is stored as printed: DCE (dce_denmark) splits manufacturing industry by branch under 0304 to 0320, and adds 010510 biogas upgrading and 0811 commercial and institutional machinery. The revision is part of the code for the same reason as NACE: SNAP 94 numbered differently.
ademe_category Base Carbone catégorie ADEME ademe ADEME's own category path for a Base Carbone element (the '>'-separated 'Code de la catégorie'), kept level by level. Segment names are the codes: the tree carries none.
ademe_base_impacts_category Base IMPACTS category ADEME ademe ADEME's own category tree for a Base IMPACTS process data set (the four English 'Category' levels of the export's details sheet), kept level by level. A separate tree from Base Carbone's: the two corpora are co-hosted on Base Empreinte but classified independently.
agribalyse_food_group AGRIBALYSE groupe d'aliment ADEME agribalyse AGRIBALYSE's two-level food classification: 'Groupe d'aliment' (level 1) and 'Sous-groupe d'aliment' (level 2). Segment names are the codes.
agribalyse_simapro_category AGRIBALYSE SimaPro category (agricultural production) ADEME agribalyse The SimaPro process category AGRIBALYSE's farm-gate workbooks print per row ('Catégorie', e.g. Agricultural\Plant production\Cereals\Transformation). Levels are the backslash segments, minus the constant 'Transformation' SimaPro folder, which marks no processing. The code is the path down to that level joined with '', not the bare segment, because 'Others' is both a top-level folder and a sub-folder of Animal production; the segment is the label.
okobaudat_category ÖKOBAUDAT Kategorie BBSR The ÖKOBAUDAT (OEKOBAU.DAT) classification path an EPD declares in its ILCD classificationInformation, level by level: the classId is the code (1 > 1.1 > 1.1.01), the German segment name the label. Owned by no single publisher: ÖKOBAUDAT defines the tree, and EPD Danmark, Kiwa-Ecobility Experts and EPD-Norge ship it on their own EPDs too (IMP-0028), so one code means the same category whichever of them published the factor.
epd_norge_category EPD-Norge kategori EPD-Norge epd_norge The EPDNorge classification path an EPD-Norge EPD declares in its ILCD classificationInformation: two levels, the product group (Byggevarer) then its sub-group (Asfalt og pukk). The codes are the opaque classId UUIDs the node ships, the Norwegian segment name the label.
epd_hub_category EPD Hub (One Click LCA) category EPD Hub epd_hub The 'One Click LCA' classification path every EPD Hub EPD declares in its ILCD classificationInformation: three levels, the classId as code (2 > 2.26 > 2.26.01) and the English segment name as label (Material > Construction > All Constructions).
desnz_activity DESNZ conversion-factor activity path DESNZ desnz The DESNZ conversion-factor workbook's own hierarchy: GHG-Protocol scope (level 1) then Level 1-4 of the flat file (levels 2-5). Segment names are the codes.
epa_emission_category EPA GHG Emission Factors Hub emission category US EPA epa The Hub's own 'Emission Category' column: the GHG-Protocol scope/category a factor belongs to ('Stationary Combustion', 'Scope 3 Category 4: Upstream Transportation and Distribution'). One level; the printed string is the code, the workbook ships none.
ceda_sector CEDA sector Watershed Technology openceda Open CEDA's own sector code and name (the workbook's sector-code header row). Level 1; the code is CEDA's, not a NAICS/IXI code.
cn_2026 Combined Nomenclature 2026 European Commission yes EU Combined Nomenclature, 2026 edition: the customs goods nomenclature of Council Regulation (EEC) No 2658/87, re-issued every year. Level 2 = 4-digit HS heading, level 3 = 6-digit HS subheading, level 4 = 8-digit CN code. The first customs nomenclature in open_ef; the YEAR is part of the scheme code because CN is re-published annually and editions are not interchangeable (cn_2026 != cn_2027).
hs_2022 Harmonized System 2022 World Customs Organization yes Harmonized Commodity Description and Coding System, 2022 edition: the 6-digit international goods nomenclature the EU Combined Nomenclature extends. Level 1 = 2-digit chapter, level 2 = 4-digit heading, level 3 = 6-digit subheading. Editions are revised roughly every five years and are NOT interchangeable.
cbam_sector CBAM sector European Commission cbam The Annex I goods sector a CBAM default value is printed under (the banner row of the default-values tables: cement, fertilisers, iron and steel, aluminium, hydrogen). Level 1; the printed sector name is the code. A rollup OVER the publisher's own partition: gas coverage and system boundary are stated per cbam_goods_category, never per sector.
cbam_goods_category CBAM aggregated goods category European Commission cbam The 'aggregated goods category' of Implementing Regulation (EU) 2025/2547, Annex I point 2 Table 1: a complete, official CN-code-to-category map. Level 2, nesting under cbam_sector. This is the grain at which the Commission itself states gas coverage and the production-process system boundary, so category-level annotations hang here and never on the sector.
cbam_production_route CBAM production route European Commission cbam The lettered production route determining the CBAM benchmark for a good ('(C) Carbon steel based on BF/BOF'), as printed in the default-values tables. Level 1; the bare letter is the code. A route is a property of the modelled process, not a separate good.
co2emissiefactoren_nl_category Lijst CO2-emissiefactoren categorie Rijkswaterstaat / Stichting Stimular co2emissiefactoren_nl The Dutch list's own two-level category band, keyed on the site's URL 'category_id'. Level 1 = section (Brandstoffen, Afval, ...), level 2 = the subsection node the category_id identifies. Three level-2 nodes carry no printed label but do carry an id, so the tree stays uniform. No published standard code (NACE, NAICS, CPA) appears anywhere in this source.
uba_at_energy_domain UBA AT Bereich (Energieträger) Umweltbundesamt GmbH (Austria) uba_at The 'Bereich' each energy-carrier table of REP-0989 is printed under: level 1 is raumwaerme (space heating, Tabelle 1), strom (electricity, Tabelle 4) or mobilitaet (mobility, Tabelle 7); level 2 is the carrier label itself. Load-bearing, not decorative: the same carrier is published three times with three different factors (Erdgas 201 / 315 / 202 g CO2-eq per kWh direct), so the Bereich is the only thing that tells them apart, and it is part of the factor's identity for the same reason. The report carries no NACE, NAICS, CPA or CN code anywhere.
uba_at_transport_mode_group UBA AT Verkehrsträger (Emissionskennzahlen) Umweltbundesamt GmbH (Austria) uba_at The mode band each row of UBA AT's 'Emissionskennzahlen Verkehrsmittel' tables is printed under: level 1 is strasse (road), bahn (rail) or flug (air); level 2 is the printed vehicle label. The band is drawn as a rotated spine label beside the rows rather than as a column, so it is read from the page and not from a field. Load-bearing in the same way the energy tree is: the three tables publish the same vehicle on three denominators (Fkm / Pkm / Tkm), and the band is what groups them into a mode. The tables carry no NACE, NAICS, CPA, CN or GLEC code anywhere.
ember_electricity_source Ember electricity source Ember ember Ember's electricity-source taxonomy, the only hierarchy the release ships. Four levels: level 1 is the headline series (total_generation, demand, net_imports), level 2 the fossil/clean split of total generation, level 3 the fuel branches (coal, gas, other_fossil, nuclear, renewables), level 4 the individual renewables. The nesting is not a shipped column (the file ships only an 'Is aggregated source' boolean), so it is our reading of Ember's published aggregate definitions: the node matching the printed label carries origin='source', its ancestors origin='mapped'. The five aggregate nodes (fossil, clean, renewables, wind_and_solar, hydro_bioenergy_other_renewables) are described here but deliberately not imported as factors: they overlap rather than partition, so loading them un-flagged would be a double-count trap. The release carries no NACE, NAICS, ISIC, CPA, CN or HS code anywhere.
co2emissiefactoren_be_section CO2emissiefactoren.be sectie EnergieID / BENOR co2emissiefactoren_be The Belgian list's own published section: the tab headings of /factoren and, one-to-one, the CSV members of the release zip: Brandstoffen energieopwekking, Brandstoffen voertuigen, Warmtelevering, Elektriciteit, Koudemiddelen, Personenvervoer, Afval. One level; the printed section name is the code, the source ships none. Load-bearing rather than decorative: the section decides what a value column means (the same 'EF productie' header is fuel-production upstream in the vehicle-fuel section and plant generation in the heat section), and it is part of factor identity for that reason. A published eighth tab, Goederenvervoer, carries prose only and refers the reader to co2emissiefactoren.nl: it ships no table, no CSV and no factor, so it is not a node here. No NACE, NAICS, CPA, CN or HS code appears anywhere in this source.
wrap_gpc WRAP product classification (GS1 GPC names) WRAP (Waste and Resources Action Programme) wrap WRAP's three-level product tree, carried in the gpc_class / gpc_brick / gpc_classification columns. The level names are GS1 Global Product Classification class and brick NAMES, but the workbook ships no GS1 numeric codes at all, so this is registered as a publisher tree and NOT as the gs1_gpc standard: the segment name is the code. Registering it as a standard would invite a join against another publisher's numeric GPC bricks that cannot succeed. Level 1 = gpc_class, level 2 = gpc_brick (blank on 922 of the loaded spine rows, so level 3 then hangs off the class), level 3 = gpc_classification.
ipcc_1996_category IPCC 1996 Guidelines source/sink category IPCC Task Force on National Greenhouse Gas Inventories ipcc The source/sink category tree of the Revised 1996 IPCC Guidelines, as carried in EFDB's 'IPCC 1996 Source/Sink Category' column. Levels are CONCATENATED without separators (1, 1A, 1A3, 1A3b), which is why it cannot share a scheme with the 2006 tree. Not a standard product or activity classification: it is an inventory reporting structure, and its category 5 (Land-Use Change and Forestry) is not the 2006 tree's category 3 (AFOLU) under another number.
ipcc_2006_category IPCC 2006 Guidelines source/sink category IPCC Task Force on National Greenhouse Gas Inventories ipcc The source/sink category tree of the 2006 IPCC Guidelines (and its 2019 Refinement), as carried in EFDB's 'IPCC 2006 Source/Sink Category' column. Levels are DOT-SEPARATED (1, 1.A, 1.A.3, 1.A.3.b, 1.A.3.b.i). Registered separately from ipcc_1996_category because the two are different decompositions, not two encodings of one tree. Not a standard product or activity classification.
open_ef_category open_ef category taxonomy open_ef yes Our own cross-library category axis: the first scheme authored here rather than read from a source. Two levels over the closed registry in ingest/category_taxonomy.py: level 1 is one of 13 branches (fuels, electricity, heat_cooling, water, materials, food_agriculture, manufactured_goods, buildings_infrastructure, transport, services, waste, direct_emissions, land_use_removals), level 2 one of 82 flat mint-frozen leaf slugs whose branch parentage is registry data, not part of the code. A node says what the factor MEASURES: never its lifecycle stage (system_boundary's axis) and never the buyer's sector. Registered as a standard with no publisher because the code means the same thing whoever published the factor: per-publisher category maps derive it from the source's own labels (origin='mapped'), and an unmappable source value halts the load rather than guessing a node.
nfr_crt NFR / CRT inventory source category UNFCCC / UNECE yes The source-category codes of the UNFCCC Common Reporting Tables (CRT, the CRF numbering) as UNECE's Nomenclature For Reporting (NFR) aligns them: energy 1 (1A fuel combustion, 1B fugitive), industrial processes 2, agriculture 3, LULUCF 4, waste 5. Not the IPCC 2006 tree (ipcc_2006_category puts LULUCF at 3B). Codes are concatenated without separators (1A2b, 3B1a). The code is the text before the first underscore of the NFR/CRT Group cell, since the publisher truncates the label. One level as loaded: the printed code itself, no ancestry minted. First loaded by naei_uk (IMP-0083).
nga_table NGA Factors table DCCEEW nga_australia The numbered table a factor was published in, in the National Greenhouse Accounts Factors workbook (level 1 = the table, e.g. Table 5). NGA ships no standard industry code of any kind, and the table number is the only classification the publisher itself asserts: it is what the NGER legislation cites and what a reporter looks up. Meaningful inside this library only: never a cross-library join key, which is why it is a publisher tree and not a standard.
isic_rev4 ISIC Rev. 4 United Nations Statistics Division yes International Standard Industrial Classification of All Economic Activities, revision 4: the UN activity classification ecoinvent classifies a dataset under according to its main output. Level 1 = section letter (the source's own 'ISIC Section' column), level 2 = two-digit division, level 3 = three-digit group, level 4 = four-digit class; the level is derivable from the code length. The REVISION is part of the scheme code for the reason stated on naics_2017: ISIC Rev. 3.1 and Rev. 4 codes are not interchangeable. ecoinvent additionally mints letter-suffixed sub-codes of its own (3510a, 3510b, 19a) that are NOT ISIC codes; those are truncated to their numeric stem, never emitted verbatim under this scheme.
cpc_v21 CPC Ver. 2.1 United Nations Statistics Division yes Central Product Classification, version 2.1: the UN product classification ecoinvent classifies a reference product under according to its product name. Level 1 = one-digit section, level 2 = two-digit division, level 3 = three-digit group, level 4 = four-digit class, level 5 = five-digit subclass; the level is derivable from the code length. The VERSION is part of the scheme code: CPC 1.1, 2.0 and 2.1 renumber, and a code is only interpretable against a stated version.
hs_2017 Harmonized System 2017 World Customs Organization yes Harmonized Commodity Description and Coding System, 2017 edition: the 6-digit international goods nomenclature, as ecoinvent assigns it to a reference product from the product name and product information. Level 1 = 2-digit chapter, level 2 = 4-digit heading, level 3 = 6-digit subheading, identical in structure to hs_2022. Registered SEPARATELY from hs_2022 because the WCO revises the HS roughly every five years and the editions are NOT interchangeable: the 2022 edition split, merged and renumbered subheadings the 2017 edition assigns differently.
ecoinvent_sector ecoinvent sector ecoinvent Association ecoinvent ecoinvent's own sector label, published from v3.8 onwards in the 'Sector' column and, in the publisher's words, 'defined by ecoinvent' from the dataset's ISIC number and its main output. One level; the printed sector name is the code, the source ships none. Deliberately MULTI-VALUED: a dataset may carry several sectors in one semicolon-separated cell (19.4% of v3.12 rows), so it partitions nothing and must never be summed over. 21 tokens as of v3.12; 'Batteries' was added in v3.11 and no token has ever been retired.
bea_2017 BEA 2017 Detail Input-Output commodities US Bureau of Economic Analysis yes The commodity codes of the BEA 2017 benchmark Input-Output accounts, Detail level (1111A0 oilseed farming, 111200 vegetable and melon farming, S00500 federal general government defense). The identifier two US spend libraries key on without either naming it: USEEIO ships it as 'Reference USEEIO Code' and Open CEDA as its 'Sector Code' header row, which is why nodes carry origin='mapped': the digits are the publisher's, the reading that they are BEA codes is ours. Level 3 = Detail, stated rather than derived because the code string cannot tell Detail from BEA's coarser Sector (1) and Summary (2) levels; no parent node is emitted, since Detail -> Summary is a published crosswalk and not a prefix rule (1111A0 and 1111B0 both roll up to summary 111CA). The BENCHMARK YEAR is part of the scheme code for the reason stated on naics_2017: BEA re-benchmarks every five years and redefines commodities across vintages. Labels are Open CEDA's sector names, which are the BEA commodity descriptions verbatim; USEEIO ships a 2017 NAICS title beside the code and no BEA one, so its nodes carry no label rather than a NAICS title masquerading as a BEA one. Two publisher-side caveats: a USEEIO reference naming several commodities at once ('230301, 233210, 233262, 2332A0') is an average over them and yields no node, so one code resolves to at most one factor per library; and USEEIO extends the Detail list with model-specific codes of its own (the seven-way split of BEA 562000 into 562111/562212/562213/562910/562920/562HAZ/562OTH, plus 335220 and 33131B), which are emitted verbatim as the publisher's own reference identifiers and collide with nothing.
rvo_energy_carriers Nederlandse energiedragerlijst: sections Rijksdienst voor Ondernemend Nederland / Nederlandse Emissieautoriteit rvo The seven section headings the Dutch energy-carrier list prints its 56 fuels under. Two levels: level 1 is the part letter (A liquid fossil, B solid fossil, C gaseous fossil, D other, plus the Biomass part), level 2 the section label itself (Liquid Fossil Primary / Secondary, Solid Fossil Primary / Secondary, Gaseous Fossil, Biomass, Other). Segment names are the codes; the source ships none. 56/56 coverage, so sector = the section label and sub_sector stays NULL. No standard scheme is printed anywhere in the document: no NACE, no CN, and in particular no IPCC 2006 source-category code: the fuel names do align with the IPCC list, but that alignment is an enrichment we would be authoring, not a classification the publisher shipped, so it is deliberately not registered here.
statfi_fuel Statistics Finland fuel classification Tilastokeskus (Statistics Finland) statfi Statistics Finland's own fuel tree, the only hierarchy the fuel-classification release ships, and the rare publisher tree that carries real native codes rather than borrowing its labels as codes. Three levels, measured on the 2026-01-01 edition: level 1 is 10 two-digit groups (11 Petroleum products through 40 Other energy sources), level 2 is 36 four-digit classes, level 3 is 123 six-digit fuels: the leaves that carry the factors. Every node is origin='source': both the digits and the labels are the publisher's. No standard scheme is shipped: the file has no NACE, CN or SIEC column and none is invented. The separate 'Previous fuel code' column is this same publisher's pre-2021 tree and is kept in source_record as a crosswalk key, never registered as a second scheme, because its codes are retired and would collide in meaning with the live ones.
iocc_2022 Input-Output Commodity Classification, Detail 2022 Statistics Canada openio_canada The commodity axis of Statistics Canada's supply-and-use accounts, Detail level, 2022 vintage, as vendored by the Open IO-Canada release in doc/OpenIO-Canada-classification-structure.xlsx. One level, one node per commodity: a 9-character code whose leading family is MPG / MPS / IMG / IMS / ENE / NGS / NNP, labelled with the published description. 473 codes to 473 descriptions, a strict bijection; 469 of the 473 labels match the emission-factor workbook exactly and the remaining 4 differ only in trivial orthography (', and' vs 'and', works vs work, alloys vs alloy), reconciled by a four-entry table in the adapter rather than by fuzzy matching, because a near-match on a commodity label is how two different commodities get merged. Registered as a publisher tree and NOT as a standard: the codes are Statistics Canada's, which argues the other way, but the list we actually load is the one Open IO-Canada vendored, and only that library uses it: promoting it later is a one-line change, while demoting it after other libraries have joined on it is not.
japan_moe_register Japan MoE/METI coefficient register 環境省 / 経済産業省 (Ministry of the Environment / METI) japan_moe The statutory register a coefficient is published in, under Japan's 算定・報告・公表制度 (calculation, reporting and publication scheme). One level, thirteen nodes: electricity_retail (電気事業者別 retail suppliers, menu by menu), electricity_tso (一般送配電事業者, the ten network operators), gas (ガス事業者別 city-gas suppliers), heat (熱供給事業者別 district-heat suppliers) and fuel (the 参考1 fuel-combustion table of the 排出係数一覧), plus the eight 号 of 政令第7条第1項 the statutory list 算定方法・排出係数一覧 files each gas under (政令第7条第1項第1号 to 第8号, energy-origin CO2 of purchased heat to NF3; IMP-0078). The register is what determines which columns a row has, which reporting obligation it discharges and even which registration_no namespace it lives in (A0002 is eRex in the electricity register and TEPCO Energy Partner in the gas one), so it is identity-adjacent rather than decorative. The five register nodes carry origin='mapped' and is_standard=False: the split is the publisher's, but the slugs are ours: the source ships no code for it, only separate workbooks and a PDF section heading. The eight clause nodes carry origin='source': the clause is printed in each block's 【根拠条文】 line. Japan publishes no JSIC/NACE/CN code anywhere in this release, and inventing one would be a cross-library join key we made up.
mfe_activity MfE NZ measuring-emissions workbook path New Zealand Ministry for the Environment mfe_nz MfE's own three-level workbook hierarchy: Page (level 1, 9 nodes), Section (level 2, 33) and SubSection (level 3, 69). Codes are the FULL PATH joined with ' > ', not the bare segment name that desnz_activity uses, and the difference is measured rather than stylistic: MfE reuses segment literals across branches, so segment codes would merge nodes the publisher keeps apart. '2010-2015 Fleet' is a SubSection under three different Sections (heavy goods vehicles, light commercial vehicles, light passenger vehicles), 'Transmission and distribution losses' is a Section under two Pages, and 14 of the 74 triples repeat the Section literal as their SubSection (109 of 902 rows) - which the loader's per-factor de-dupe on (scheme, code) would silently collapse into a single node, dropping the level-3 row. Level 3 is 69 rather than the 74 the file prints because two SubSection distinctions are lifted out of the tree and onto typed columns where they belong: the eight radiative-forcing spellings become emission_factor_value.radiative_forcing (4 fewer), and the three electricity series become reference_year (1 fewer). Nodes carry origin='source': the tree, the segment names and the order are all the publisher's, only the ' > ' joiner is ours. MfE ships no ANZSIC, NACE or CN code anywhere in the release, so no standard scheme is claimed.
glec_mode GLEC Framework transport mode Smart Freight Centre glec The transport mode a GLEC default-value table is printed under, plus the two non-transport families the Framework ships alongside them. Level 1 is the eight-way split the document's own module structure asserts: air, inland_waterway, rail, road, sea, logistics_hub (Module 2), fuel (Module 1 energy carriers) and refrigerant (Module 3). Level 2 is the sub-family a table separates rather than a column: air splits freighter from belly freight, rail splits diesel from electric traction, sea splits non-container from container vessels, and logistics_hub splits the five hub types of Table 3 (transshipment, storage + transshipment, warehouse, liquid bulk terminal, intermodal terminal) - which is load-bearing because the intermodal row is the one hub published per container while the other four are per tonne of throughput. road, inland_waterway, fuel and refrigerant have no level 2: what would fill it is the vehicle band or the carrier, which is activity_detail and part of the identity, not a classification. Nodes carry origin='mapped': the split is the publisher's, the slugs are ours, because GLEC prints a caption and a module footer, never a code. The Framework carries no NACE, NAICS, CPA or CN code anywhere, so no standard scheme is claimed.
waste_stream open_ef waste stream open_ef Groups the rows of a route-fanned waste table by the material they treat, so the default-route election (open_ef.route_default) can compare them. Level 1 is the stream: the publisher's own material label, verbatim (the DESNZ Level 2-4 path, the ADEME category path plus base name, the EPA WARM material). Level 2 is the row's role under that stream: route (one treatment route), publisher_mix (the publisher's own average end-of-life row, which the election prefers) or excluded (re-use and recycling-excluded scenarios, which answer a narrower question than 'route unknown' and never win). A library need not emit all three: every one of epa's 183 WARM rows is a route, so each of its streams is decided by comparison rather than by a published average. Nodes carry origin='mapped': the grouping is ours, the labels are the publisher's. Not a standard, and owned by no single publisher: a stream code is one library's label and is only ever compared within that library, so two libraries' streams never join. Emitted by the libraries that fan a material out by treatment route, which today means desnz, ademe and epa.
open_ef_end_use open_ef end use open_ef Marks a grid electricity factor the publisher scoped to one end use (ventilation, lighting, space heating, an electric car) rather than to a grid as a whole. One level-1 node, end_use_specific, origin='mapped': the reading is ours, the evidence is the publisher's own classification (ademe's 'Découpage par usages', ÖKOBAUDAT 8.6 'Nutzung', KBOB group 61, UBA's heat, cold and road-transport sheets). Emitted only beside open_ef_category electricity_grid, by the rule table in ingest/end_use.py (MOD-0094). Not a standard and owned by no publisher.
no_state_chart_of_accounts Standard kontoplan for statlige virksomheter - artskonto Direktoratet for forvaltning og økonomistyring (DFØ) dfo The Norwegian state's standard chart of accounts as DFØ keys its emission factors for state purchases on it. Two levels: level 1 is the account class (the first digit; classes 1, 4, 5, 6 and 7 carry factors), level 2 the three-digit account (artskonto), 166 of them in the 2025-10 edition. The account digits and names are the publisher's (origin='source'); the class rung is our prefix truncation and carries no label, because the factor workbooks print none. A publisher tree, not a standard: the chart is a national public-sector bookkeeping standard, but no other library keys on it, so it joins nothing across libraries.
ssb_fuel SSB emission inventory fuel code Statistisk sentralbyrå (Statistics Norway) ssb The fuel code Statistics Norway's emission model keys its combustion factors on (V01 coal ... V52 special waste, B17 bio marine gas oil), as printed in 'Emission factors used in the estimations of emissions from combustion'. One level: the code, labelled with the document's English fuel name (origin='source'). A cell the tables print for two fuels at once (V14/V26, V17/B17) is split into one factor per fuel. A publisher tree, not a standard: no other library keys on these codes.
ssb_combustion_source SSB emission inventory combustion source Statistisk sentralbyrå (Statistics Norway) ssb The combustion source (technology or vehicle class) Statistics Norway's emission model keys its factors on, beside the fuel. One level, 25 codes: the printed stationary codes S.01-S.07 and S.1B2C, the aviation codes M.1A3A.11-.32, the other-mobile codes M.1A3C and M.1A3E.*, all origin='source'; the five road classes M.1A3B.PC / LDV / HDV / Moped / Motorcycle, tokens minted from the vehicle-class name that stand for the printed codes M.1A3B.1 (passenger car), M.1A3B.2 (other light duty cars), M.1A3B.3 (heavy duty vehicles), M.1A3B.41 (moped) and M.1A3B.42 (motorcycle), stored origin='source' and kept as frozen identity; and 'navigation', the one node the document prints no code for (origin='mapped'). A publisher tree, not a standard.
ssb_klass_90 SSB KLASS 90 - Variant of SIC, environmental accounts 2012 Statistisk sentralbyrå (Statistics Norway) ssb The industry grouping Statistics Norway's environmental accounts key StatBank table 09298 on: KLASS classification 90 ('Variant of SIC - Environmental accounts 2012'), version 361, 91 items on three levels. Codes are KLASS's own (01, 01.01, 01.01.00), and the parent of each item is KLASS's parentCode (origin='source'); StatBank prints the same codes prefixed 'N.', which the adapter strips. The codes are SIC2007-based although the KLASS text still says NACE rev. 1.1. A publisher tree, not a standard: no other library keys on it, and a KLASS version change re-keys the stream.
dst_industry Statistics Denmark national-accounts industry grouping (117 industries) Danmarks Statistik (Statistics Denmark) dst The industry codes Statistics Denmark keys its environmental-economic multiplier tables on (StatBank EMM1MU1N, variable BRANCHE): the national accounts' 117-industry grouping and its aggregates, 234 codes on up to five levels (V the total, the lettered sections such as VA, the lettered sub-sections such as VCA where the publisher prints one, the 69-grouping such as V01000, and the 117-grouping leaves such as V010000). The code and its English label are the publisher's (origin='source'). The parent of each code is read from the publisher's own row order, because a digit-prefix rule finds only 63 of the 117 leaf parents and sections L and S print no one-letter row. A publisher tree, not a standard: the leaves map onto NACE Rev. 2 divisions, but the key is not stamped.
fineli_igclass Fineli ingredient class (IGCLASS) Luonnonvarakeskus (Luke) / THL Fineli luke The ingredient class (IGCLASS) of THL's Fineli food composition database, as Luke's FoodGWP prints it beside every ingredient. One level: the trimmed Finnish class label is both code and label (origin='source'), because the file prints no Fineli short code. Luke assigns an ingredient without a result of its own the mean of its class; that mean is served once, as its own factor keyed on this code. A publisher tree, not a standard: no other library keys on Fineli classes.
fineli_fuclass Fineli food-use class (FUCLASS) Luonnonvarakeskus (Luke) / THL Fineli luke The food-use class (FUCLASS) of THL's Fineli food composition database, as Luke's FoodGWP prints it beside every ingredient. One level: the trimmed Finnish class label is both code and label (origin='source'), because the file prints no Fineli short code. Where Luke averages over a substitute class (its FUCLASS_subsitute column), the substitute is the class the mean is served under. A publisher tree, not a standard: no other library keys on Fineli classes.
cpv_2008 Common Procurement Vocabulary (CPV 2008) European Commission yes The EU public-procurement vocabulary of Regulation (EC) No 2195/2002 as amended by Commission Regulation (EC) No 213/2008: an eight-digit code plus a check digit (09310000-5). One level: the code as the publisher prints it, labelled with the publisher's own (Swedish) CPV wording (origin='source'). No prefix ancestry is claimed, because a CPV code's trailing zeros mark its depth but the publisher prints a flat list, not the tree. The YEAR is part of the scheme code because CPV revisions renumber. First loaded by upphandlingsmyndigheten, which keys every indicator on a CPV code and carries a category default's member codes as its rows.
unspsc_v2011 UNSPSC (2011 version) GS1 US (UNSPSC code manager) yes The United Nations Standard Products and Services Code, in the version the publisher's sheet header names ('UNSPSC version 2011'): an eight-digit segment, family, class, commodity code. One level: the code as printed, labelled with the publisher's own (Swedish) wording (origin='source'). No prefix ancestry is claimed, because the publisher prints commodity codes beside a CPV code, not the tree. The VERSION is part of the scheme code because UNSPSC versions re-use and retire codes.
upphandlingsmyndigheten_kategoritrad Upphandlingsmyndigheten Miljöspendanalys kategoriträd Upphandlingsmyndigheten upphandlingsmyndigheten The procurement category tree the Swedish National Agency for Public Procurement keys its Miljöspendanalys climate indicators on. Three levels from the workbook's kat 1 / kat 2 / kat 3 numbers, 7 / 29 / 174 nodes in version 5. The level-1 code is the kat 1 number, level 2 'kat1.kat2', level 3 'kat1.kat2.kat3', because the kat 3 numbers repeat under different parents (and some are sub-numbers such as 1.5). Labels are the publisher's Swedish wording; where a node's label is printed two ways, the most frequent spelling is kept (origin='source'). A publisher tree, not a standard.
foodex2 FoodEx2 European Food Safety Authority (EFSA) yes EFSA's standardised food classification and description system: the five-character base-term code (A001R) a food is described by. One level: the code as the publisher prints it, with no label (origin='source'), because one code reaches the corpus under several names (SAFAD prints A001N as both 'Common wheat grain' and 'Wheat grain soft') and a standard code must mean one thing across libraries; the publisher's own name is the factor's activity text. No hierarchy is claimed: the FoodEx2 hierarchies are separate views over the same terms, not a prefix tree. The catalogue revision is not stated by the first publisher. First loaded by slu (SAFAD, IMP-0037).
fao_sua FAO Supply Utilization Accounts item codes Food and Agriculture Organization of the United Nations (FAO) yes The commodity codes of FAOSTAT's Supply Utilization Accounts: a CPC Ver. 2.1 subclass or class, optionally extended by FAO with a two-digit suffix after a dot (01342.02 Quinces under CPC 01342). One level: the code as the publisher prints it, with no label (origin='source'), because publishers reword FAO's item names ('Wheat, average') and a standard code must mean one thing across libraries. Only FAO-shaped codes are emitted under this scheme; a publisher's own placeholders (SAFAD's BF-, MI-, NF- codes) are not FAO codes and stay in the source record. The cpc_v21 chain is derivable from the part before the dot and is emitted beside it as origin='mapped'. First loaded by slu (SAFAD, IMP-0037).
siec SIEC energy-product codes (Eurostat energy balances) Eurostat yes The energy-product codes of Eurostat's energy balances (the siec dimension of nrg_bal), after the UN Standard International Energy product Classification, including the composite aggregates Eurostat itself prints (R5110-5150_W6000RI, O4671XR5220B). One level: the code as the publisher prints it, with no label (origin='source'), because publishers word the products their own way and a standard code must mean one thing across libraries; the publisher's own name is the factor's activity text. No hierarchy is emitted: the codes are not prefix-derivable and the composite aggregates name ranges of codes. First loaded by jrc_idees (IMP-0040).
jrc_idees_transport JRC-IDEES transport tree European Commission, Joint Research Centre jrc_idees JRC-IDEES-2023's own dotted transport path (Tr.Road.Passenger.Car...), one node per dot-prefix with parent_code set. A publisher tree, not a standard, and not prefix-derivable by digit length.
com_secap_category Covenant of Mayors SECAP energy-source tree European Commission, Joint Research Centre covenant_of_mayors The Covenant of Mayors' own grouping of its local-energy default factors (JRC, 2024 edition). Level 1 is the SECAP energy source as the workbook prints it (Natural gas, Liquid gas, Heating Oil, Diesel, Coal, Other biomass, Wind, ...); level 2 is the IPCC 2006 fuel name printed beside it, with parent_code set, emitted only when it differs from the level-1 text. One fuel can sit under two sources (Gas/diesel oil under Heating Oil and under Diesel), so a node's parent is per factor. A publisher tree, not a standard; the IPCC names are fuel names, not codes of ipcc_2006_category.
com_country_group Covenant of Mayors partner-country group European Commission, Joint Research Centre covenant_of_mayors The banner under which the Covenant of Mayors' national-electricity workbook (2024 edition, Tables 4-5, IEA data) groups its non-EU countries: CoM East countries, Clima-MED countries, Western Balkans & Türkiye, Other European countries, Other countries. One level, the banner text as printed; the EU block (Tables 1-2) has no banner and carries no node.
talo2000 Talo 2000 building-part nomenclature Rakennustieto Oy yes The Finnish building-part and project nomenclature (Talo 2000 -hankenimikkeistö): a dotted code such as 271.114, one level, with the label the publisher prints beside it (origin='source'). The codes mean the same in every library that prints them; a code printed with two labels is folded to its commonest one after ingest. First loaded by syke (CO2data.fi construction, IMP-0052).
infra2015 INFRA 2015 nomenclature Rakennustieto Oy yes The Finnish infrastructure building-part nomenclature (INFRA 2015 -rakennusosa- ja hankenimikkeistö): a four-digit code such as 1320, one level, with the label the publisher prints beside it (origin='source'). A cell may list several classes; each becomes its own node. The codes mean the same in every library that prints them; a code printed with two labels is folded to its commonest one after ingest. First loaded by syke (CO2data.fi infrastructure, IMP-0052).
syke_co2data_category CO2data.fi construction product groups Finnish Environment Institute (Syke) syke The construction database's own product-group titles (the Base category system of CO2data.fi), one level, code = label = the printed English title; a resource filed under several groups carries each. A publisher tree, not a standard.
syke_infra_group CO2data.fi infrastructure groups Finnish Environment Institute (Syke) syke The infrastructure database's own Finnish group and subgroup titles: the group (and every further group the data table lists under 'muut ryhmät') at level 1, code = label = the printed title; the subgroup at level 2, coded group/subgroup with parent_code set. A publisher tree, not a standard.
boverket_category Boverkets klimatdatabas - kategorier Boverket (Swedish National Board of Housing, Building and Planning) boverket Boverket's own two-level category tree for its generic climate database (klimatdatabas), as the GetAllResources envelope prints it. Level 1 is the tree top (13 Byggprodukter, construction products; 14 Energislag, energy), level 2 the leaf (eleven under 13, one under 14; 12 leaves in edition 02.07.000). Codes are the publisher's node ids, labels its Swedish titles (origin='source'). A publisher tree, not a standard: no other library keys on it, so it joins nothing across libraries.
turkstat_crt_category UNFCCC CRT category codes (Türkiye's submission) UNFCCC Common Reporting Tables, as submitted by TurkStat turkstat The category codes of the UNFCCC Common Reporting Tables (CRT, decision 5/CMA.3) as Türkiye's submission prints them in the sectoral background tables 1 to 5 (1.A.1.a.i, 3.B.1.a, 5.D.1), one node per code with parent_code set to the code one level up. A publisher tree, not a standard: CRT numbering departs from IPCC 2006 numbering below sector 2 (CRT 3.C is rice cultivation, IPCC 3.C aggregate sources; CRT 5.A is solid waste disposal, IPCC 5.A indirect N2O). Not prefix-derivable by digit length. First loaded by turkstat (IMP-0049).
gemis_sheet GEMIS results workbook sheets IINAS (International Institute for Sustainability Analysis and Strategy) gemis The two-level grouping of IINAS's GEMIS results workbook: level 1 is the sector prefix of the GEMIS-Szenario-Name in row 3 of each data sheet (Energie, Verkehr, Stoffe, Ernährung); level 2 is /, the data sheet the option is printed on with its vintage dropped (Energie/Strom-mix DE, Energie/Heizen (en), Stoffe/Metalle). GEMIS 5.2 prints 4 sectors and 11 data sheets. A publisher tree, not a standard. First loaded by gemis (IMP-0063).
probas_uba_category UBA ProBas process categories Umweltbundesamt (German Environment Agency) probas The Umweltbundesamt's own process tree on the ProBas soda4LCA node, up to six levels deep (Energie, Transport, Materialien und Produkte at level 1); the code is the node's numeric classId. Carried by the 116 IFEU datasets last revised 2014-11-22, beside their NACE 1.1 class. A publisher tree, not a standard. First loaded by probas (IMP-0081).
tgo_cfp_group TGO CFP emission factor groups Thailand Greenhouse Gas Management Organization (TGO) tgo_thailand The 22 numbered product groups of TGO's CFP emission factor list (Carbon Footprint of Products), one level: code = the printed group number, label = the group title as printed in Thai. A publisher tree, not a standard (IMP-0055).
tgo_cfo_section TGO CFO emission factor sections Thailand Greenhouse Gas Management Organization (TGO) tgo_thailand The printed sections of TGO's CFO emission factor list (Carbon Footprint for Organization): stationary, mobile, electricity and refrigerants at level 1, mobile's off_road and on_road parts at level 2 with parent_code set; label = the printed section title. A publisher tree, not a standard (IMP-0055).
nevo NEVO food codes (Nederlands Voedingsstoffenbestand) Rijksinstituut voor Volksgezondheid en Milieu (RIVM) rivm The food codes of NEVO, the Dutch food composition database (Nederlands Voedingsstoffenbestand) RIVM maintains, as RIVM's Database milieubelasting voedingsmiddelen prints them beside each food. One level: code = the printed integer NEVO code, label = the English NEVO name as printed (origin='source'). A NEVO code is not a food's identity here: one code spans the packaging variants of a food, the consumption gate changes it with the preparation, and a factor carries every code its rows print (three on the returnable-PET mineral water); 30 factors print none. A publisher tree, not a standard: no other loaded library keys on NEVO codes, and no crosswalk to CPC or HS is published.
rivm_food_group RIVM food groups (Voedingsmiddelengroep-indeling) Rijksinstituut voor Volksgezondheid en Milieu (RIVM) rivm RIVM's own food grouping, as the group sheet (Voedingsmiddelengroep-indeling) of its Database milieubelasting voedingsmiddelen prints it. Level 1 is the Hoofdgroep (4 values), level 2 the Voedingsmiddelengroep (24 values) with parent_code set to its Hoofdgroep; the Dutch titles are both code and label (origin='source'). The two foods the sheet prints without a Hoofdgroep (Insects and Mustard seed, both Diversen) carry the level-2 node alone. A publisher tree, not a standard: no other library keys on it.
auslci_category AusLCI process classification ALCAS (Australian Life Cycle Assessment Society) / Lifecycles auslci The four labels the AusLCI Carbon Emission Factors workbook prints beside each process (Process type, Catergory (sic), Subcategory, Subcategory 2), one node per printed level; every process prints at least two. A code is the path, each label slugged and joined to its parents' with '/', because the same label (Others, Market) sits under different parents; the label is the printed one (origin='source') and parent_code the level above. V48 prints 5, 25, 42 and 37 nodes per level. A publisher tree, not a standard. First loaded by auslci (IMP-0069).
kbob_group KBOB group KBOB / ecobau / IPB kbob The 33 two-digit groups of the KBOB Ökobilanzdaten im Baubereich list (00 to 21 building materials, 31 to 34 building services, 41 to 46 energy, 61 to 64 transport, 91 and 92 disposal), one level: the code is the group number, the label the printed German group name (origin='source'). Every record's ID starts with its group. A publisher tree, not a standard. First loaded by kbob (IMP-0075).
concito_category Big Climate Database food categories CONCITO concito CONCITO's own food grouping: the English Category the Big Climate Database workbook prints beside every food, 13 values in v1.2, one per Danish DSK Kategori (the Danish title stays in each value's source record). One level: the English title, whitespace folded, is both code and label (origin='source'). A publisher tree, not a standard: no other library keys on it. First loaded by big_climate_database (IMP-0073).
rtoc_chemical_series RTOC refrigerant chemical series (Annex Table 3.I-1) UNEP Refrigeration, Air Conditioning and Heat Pumps Technical Options Committee (RTOC) unep The ten series headings under which Table 3.I-1 of the RTOC 2022 Assessment groups its single-component refrigerants (Methane Series, Ethane Series, Ethers, Propane Series, Cyclic Organic Compounds, Hydrocarbons, Oxygen compounds, Nitrogen Compounds, Inorganic Compounds, Unsaturated Organic Compounds). One level: code = the heading in snake_case, label = the heading as printed (origin='source'). The blend tables (3.I-2, 3.I-3) print no series, so blends carry none. A publisher tree that describes the molecule, not the emitting activity, so it is never an open_ef_category node; no other library keys on it.
warm_material_type WARM material types U.S. EPA epa_warm EPA WARM's own two-level material tree: the 11 material groups of the v16 workbook's Analysis Inputs sheet (column C, carried down) over its 61 materials (column D, spelled as the Landfilling EFs sheet prints them). The English names, whitespace folded, are both code and label (origin='source'); a material named as its group (Food Waste, Glass, Mixed Plastics, Tires, Yard Trimmings) is the group node alone. A publisher tree, not a standard: no other library keys on it. First loaded by epa_warm (IMP-0076).
reg_2150_2002_waste_category Reg. (EC) 2150/2002 waste categories, ARC numbering Agència de Residus de Catalunya (ARC) occc_catalonia The waste categories of Regulation (EC) No 2150/2002 on waste statistics as the Agència de Residus de Catalunya numbers them in its industrial-waste carbon-footprint tables: the Categoria number the OCCC guide prints in Annex 3.4 A and B (1 Dissolvents usats to 45 Residus de combustió (perillosos)). One level: code = the printed number (origin='source'). The ordinal is ARC's, not the regulation's EWC-Stat code, so it is a publisher tree: no other library keys on it. First loaded by occc_catalonia (IMP-0082).
arc_management_route ARC waste management routes (vies de gestió) Agència de Residus de Catalunya (ARC) occc_catalonia The Catalan waste-management route codes of the Agència de Residus de Catalunya: a V code is a recovery route (valorització, e.g. V21 solvent regeneration, V83 composting), a T code a treatment or disposal route (tractament, e.g. T12 controlled landfill, T21 incineration), as the OCCC guide's Annex 3.4 A prints them beside each industrial-waste factor. One level: code = the printed route code (origin='source'). A publisher tree, not a standard: no other library keys on it. First loaded by occc_catalonia (IMP-0082).
es_waste_operation_ley_7_2022 Spanish waste recovery and disposal operations (Ley 7/2022) Government of Spain (Ley 7/2022 de residuos y suelos contaminados) yes The recovery (R) and disposal (D) operations of Annexes II and III of Spain's Ley 7/2022 on waste and contaminated soils, at the four-digit grain the law lists (e.g. R0201 solvent regeneration, R0301 composting, D1001 incineration on land), as the OCCC guide's Annex 3.4 A prints them beside each industrial-waste factor. One level: code = the printed operation code (origin='source'). A national statutory code list, so the same code denotes the same operation whoever publishes the factor. First loaded by occc_catalonia (IMP-0082).
cornerstone_eeio_sector Cornerstone EEIO sector Cornerstone Sustainability Data Initiative cornerstone_eeio Cornerstone EEIO's own sector code and name (the workbook's Code and Name columns, 405 codes in 2026-rc). One level; the code reuses BEA 2017 detail codes plus Cornerstone's own (562HAZ, S00402), and 330 of the shared codes carry a re-worded name, so the publisher's name is kept here and bea_2017 is emitted label-less. First loaded by cornerstone_eeio (IMP-0084).
veglca_category VegLCA category Statens vegvesen statens_vegvesen Statens vegvesen's own two-level material tree in the VegLCA workbook: level 1 the group (column 2, 14 groups), level 2 the category (column 102, 37 in scope). Codes are the printed names (origin='source'); no standard code is printed. First loaded by statens_vegvesen (IMP-0099).

open_ef_category: 13 branches, 82 leaves defined#

Our own category tree, one over every library, so two publishers' own categories line up. A node says what a factor measures: never its life-cycle stage, which is system_boundary, and never the buyer's sector.

The 82 leaves below are every leaf the registry defines, which is not the same as every leaf in use: a leaf no library has mapped onto yet is still part of the axis, so a count taken from the data is the smaller number.

Every factor carries a branch at level 1. Most carry a leaf at level 2 as well, and some do not: where a source genuinely does not tell a branch's leaves apart, its map assigns the branch alone and sub_category_code stays NULL. That is deliberate coarseness, never an unmapped value. Both levels are ordinary activity_classification rows under this scheme, served as category / category_code and sub_category / sub_category_code. Leaf slugs are flat and frozen at mint, so a leaf never carries its branch as a prefix and re-parenting one never re-codes it.

The filter takes the English label, not the code. The API and the explorer read category=Fuels; category=fuels matches nothing. The codes below are what a SQL reader finds in category_code and sub_category_code, and the join key back into activity_classification.

Nothing lands here by guess: a source value that maps to no node halts the load rather than falling back, so coverage of level 1 is total by construction and an unclassified factor is not a state the data can reach. An absent leaf is the coarseness above, never a catch-all.

Two leaves are deliberate umbrellas, named under their branch below. An umbrella match is weaker evidence than a specific leaf: it says the tree had no better home for the activity, not that the activity resembles the others beside it.

fuels: Fuels (6 leaves)#

Fuel commodities: solid, liquid and gaseous fuels supplied or combusted.

code label measures
fuel_fossil_liquid Liquid fossil fuels Measures liquid fossil fuels: diesel, petrol, fuel oil, LPG, kerosene.
fuel_fossil_gaseous Gaseous fossil fuels Measures gaseous fossil fuels: natural gas, CNG, LNG.
fuel_fossil_solid Solid fossil fuels Measures solid fossil fuels: coal, coke, peat.
biofuel Biofuels Measures biofuels and biomass fuels: biodiesel, bioethanol, biogas, wood fuels.
hydrogen Hydrogen Measures hydrogen as a fuel or energy carrier.
waste_derived_fuel Waste-derived fuels Measures fuels derived from waste (RDF, SRF, used oils) as fuel commodities; treating the waste itself is a waste leaf.

electricity: Electricity (3 leaves)#

Electricity supply: grid electricity, generation technologies, distribution and trade.

code label measures
electricity_grid Grid electricity Measures electricity drawn from the grid: a region's average, a residual mix, a supplier's mix or a certified green product; the accounting mix is the value's grid_mix and a named seller is the factor's supplier, never a separate leaf.
electricity_generation Electricity by generation technology Measures electricity from a specific generation technology (wind, solar PV, hydro, coal, gas CCGT), including electricity from waste incineration.
electricity_distribution_trade Electricity distribution and trade Measures electricity transmission, distribution and trade margins.

heat_cooling: Heat and cooling (3 leaves)#

Purchased district heat, steam and cooling.

code label measures
district_heat_steam District heat and steam Measures heat and steam bought from a network. Heat produced on site or by a dedicated installation is heat_generation: a Fernwaerme filter must not return a heat pump.
cooling Cooling Measures purchased cooling and chilled water.
heat_generation Heat generation Measures heat produced on site or by a dedicated installation rather than bought from a network: solar thermal, heat pumps, shallow and deep geothermal, ambient heat. Combusting a fuel to raise that heat is a fuels leaf; the heat delivered by a network is district_heat_steam.

water: Water (1 leaf)#

Mains water supply.

code label measures
water_supply Water supply Measures mains water supply and its treatment for delivery; wastewater treatment is a waste leaf.

materials: Materials (9 leaves)#

Raw and semi-finished materials and construction products, per unit of material.

code label measures
metals Metals Measures metals and metal semi-products (steel, aluminium, copper), virgin or recycled.
polymers_rubber Polymers and rubber Measures plastics, polymers and rubber materials, virgin or recycled.
paper_wood Paper and wood Measures paper, board, pulp and wood materials.
glass_ceramics Glass and ceramics Measures glass and ceramic materials.
minerals_aggregates Minerals and aggregates Measures cement, lime, aggregates, stone and other mineral materials.
chemicals Chemicals Measures chemical products and preparations, including fertilisers and industrial gases.
textiles_fibres Textiles and fibres Measures textile fibres, yarns and fabrics as materials; finished garments are manufactured goods.
construction_products Construction products Measures manufactured construction products: insulation, bricks, windows, coatings.
packaging_materials Packaging Measures packaging materials and formats: films, containers, pallets.

food_agriculture: Food and agriculture (6 leaves)#

Food, beverages, feed and primary agricultural products and operations.

code label measures
plant_products Plant products Measures primary plant products: crops, fruit, vegetables, grains. The seam with processed_food is the first transformation, not the farm gate: cleaning, drying, sorting and storage leave the commodity here, while milling, crushing, extraction and refining move it on. So wheat is plant_products and wheat flour is not.
animal_products Animal products Measures animal husbandry and primary animal products: meat, milk, eggs, fish. A fresh cut, deboned or not, is still the commodity and stays here; cured meat and dairy products are processed_food.
processed_food Processed food Measures food and feed that has undergone at least a first transformation, through to prepared meals: flour and milled cereals, crude and refined vegetable oil, sugar, starch, dairy products, cured meat, canned and frozen goods. The untransformed commodity is plant_products or animal_products; a drink is beverages.
beverages Beverages Measures beverages, alcoholic and non-alcoholic.
animal_feed Animal feed Measures animal feed and fodder.
agricultural_operations Agricultural operations Measures agricultural operations priced per activity: machinery work, irrigation, greenhouse operation.

manufactured_goods: Manufactured goods (9 leaves)#

Finished manufactured goods.

Umbrella leaf: other_goods.

code label measures
electronics_ict Electronics and ICT equipment Measures electronic and ICT devices: computers, phones, displays, network hardware.
electrical_equipment Electrical equipment Measures electrical equipment: motors, transformers, cables, lighting.
machinery Machinery Measures industrial machinery and mechanical equipment as goods.
vehicles Vehicles Measures vehicles as purchased goods: cars, trucks, ships, aircraft, bicycles.
furniture Furniture Measures furniture and furnishings.
appliances Appliances Measures household and commercial appliances.
apparel_footwear Apparel and footwear Measures garments, footwear and accessories as finished goods; fibre and fabric are material leaves.
medical_precision_instruments Medical and precision instruments Measures medical, dental, surgical, laboratory, optical, measuring and control instruments as goods. Pharmaceuticals and reagents are chemicals; the care itself is health_social.
other_goods Other manufactured goods Measures manufactured goods not covered by a sibling leaf.

buildings_infrastructure: Buildings and infrastructure (2 leaves)#

Construction of buildings and civil infrastructure as built works.

code label measures
building_construction Building construction Measures construction of buildings as whole works (per m2 or per building).
civil_infrastructure Civil infrastructure Measures civil engineering works: roads, bridges, rail track, pipelines as works.

transport: Transport (15 leaves)#

Movement of freight or passengers.

code label measures
freight_road Road freight Measures road freight transport (trucks, vans) per tonne-km or vehicle-km.
freight_rail Rail freight Measures rail freight transport.
freight_air Air freight Measures air freight transport.
freight_sea Sea freight Measures sea freight: container, bulk and tanker shipping.
freight_inland_waterway Inland waterway freight Measures inland waterway freight (barges).
freight_pipeline Pipeline transport Measures pipeline transport of goods.
freight_multimodal Multimodal freight Measures multimodal or unspecified-mode freight chains.
logistics_warehousing Logistics and warehousing Measures logistics services, storage and warehousing.
passenger_car Car travel Measures passenger travel by car, taxi or ride-hailing.
passenger_rail Rail travel Measures passenger travel by train, metro or tram.
passenger_air Air travel Measures passenger travel by air.
passenger_bus_coach Bus and coach travel Measures passenger travel by bus or coach.
passenger_ferry Ferry travel Measures passenger travel by ferry.
passenger_two_three_wheeler Motorcycle and scooter travel Measures passenger travel by motorcycle, scooter or similar.
passenger_multimodal Multimodal passenger travel Measures multimodal or unspecified-mode passenger travel: public transport in general, mixed commuting and business-travel averages. The passenger twin of freight_multimodal.

services: Services (14 leaves)#

Purchased services.

Umbrella leaf: other_services.

code label measures
professional Professional services Measures professional and business services: consulting, legal, engineering, marketing.
ict_digital ICT and digital services Measures ICT and digital services: software, cloud, telecom, AI services.
financial_insurance Financial and insurance services Measures financial and insurance services.
hospitality_catering Hospitality and catering Measures restaurant, catering and food services.
accommodation Accommodation Measures hotel stays and other accommodation.
health_social Health and social care Measures health and social care services.
education_public Education and public services Measures education and public administration services.
real_estate_rent Real estate and rent Measures real estate services and the rent or lease of real property: land, buildings, floor space. Renting movable equipment or vehicles is equipment_rental_leasing.
repair_maintenance_cleaning Repair, maintenance and cleaning Measures repair, maintenance and cleaning services.
trade_retail Trade and retail Measures wholesale and retail trade margins and services.
equipment_rental_leasing Equipment rental and leasing Measures rental and leasing of movable goods: machinery, vehicles, tools, IT equipment, and lessors of non-financial intangible assets. Rent or lease of land and buildings is real_estate_rent; buying the equipment outright is a manufactured-goods leaf.
media_publishing Media and publishing Measures publishing, broadcasting, motion picture, sound recording, news and advertising-funded media services. Software publishing is ict_digital; printing a physical run is a materials leaf.
teleworking Homeworking Measures an employee's working from home, per hour or day worked: the home office's equipment and the heating it adds. Reported with employee commuting (GHG Protocol Scope 3 category 7), not as a purchased service; the household's own energy bought for itself is an electricity or heat leaf.
other_services Other services Measures services not covered by a sibling leaf.

waste: Waste treatment (8 leaves)#

Treatment and disposal of waste, by treatment route, per unit of waste treated.

code label measures
collection_sorting Waste collection and sorting Measures collection, transfer and sorting of waste.
landfill Landfill Measures landfilling of waste.
incineration Incineration Measures incineration of waste, with or without energy recovery; the electricity output is an electricity leaf.
recycling Recycling Measures the recycling process treating a waste material, per unit of waste treated: sorting, shredding, reclamation, materials recovery. A recycled-content material is a material leaf and never this one. Recycled PET granulate is polymers_rubber and a secondary aluminium ingot is metals, because recycled is a grade of a material rather than a category of its own. One exception: under a cut-off convention a secondary-material flow published burden-free stays here, since it is inventory bookkeeping carrying a near-zero value rather than a grade anybody buys, and on a material leaf it would answer a recycled-material question with almost no emissions at all.
composting Composting Measures composting of organic waste.
anaerobic_digestion Anaerobic digestion Measures anaerobic digestion of organic waste.
wastewater_treatment Wastewater treatment Measures treatment of wastewater and sewage.
hazardous_treatment Hazardous waste treatment Measures treatment of hazardous or clinical waste where the source defines the factor by that stream and names no route. It is the one stream-based node in an otherwise route-based set, so it narrows its siblings rather than competing with them: where the source does name a route, the route wins. Incineration of clinical waste is incineration, and hazardous landfill is landfill.

direct_emissions: Direct emissions (3 leaves)#

Direct emission processes: fugitive releases, industrial process and agricultural emissions.

code label measures
refrigerants_fugitives Fugitive emissions and refrigerants Measures fugitive releases of gas to atmosphere, whether or not a refrigerant: refrigerant leakage from cooling equipment, and unintended or vented releases from fuel extraction, processing and distribution, such as well venting, pipeline and distribution-network leakage, flaring, coke ovens, charcoal kilns and coal-mine methane.
industrial_process Industrial process emissions Measures industrial process emissions: calcination, chemical reactions, solvent use.
agriculture_soils_livestock Agricultural process emissions Measures agricultural emission processes: enteric CH4, manure management, soil N2O; food products are food leaves.

land_use_removals: Land use and removals (3 leaves)#

Land-use change, forestry management and carbon removals.

code label measures
land_use_change Land-use change Measures emissions from land-use and land-cover change.
forestry_management Forestry management Measures forestry and land management activities.
carbon_removals Carbon removals Measures carbon removals and sequestration.

Units: 65 codes (norm_version 6)#

normalize_unit returns None for anything unlisted rather than guessing; the loader's UnknownUnitCode guard rejects the factor. A no-result is recoverable, a wrong conversion silently corrupts totals.

Canonical (38): self-describing, safe to convert within the dimension: cad, dkk, eur, fte_hour, gbp, guest_night, hour, jpy, kg, kg_day, km, km_yr, kwh, kwh_storage_capacity, kwp, l, m, m2, m2_day, m2_era_yr, m2_hour, m2_nfa_yr, m_yr, mbyte, meal, nok, nzd, p.km, person_hour, room_night, seat.km, sek, service_transaction, t.km, teu.km, unit, usd, visit.

Basis-qualified (27): deliberately NOT the bare dimension. kg_n is a mass of nitrogen, not of the purchased product; matching it as plain kg applies a silent x1 error: count_item, ha_yr, kg_active_substance, kg_dry_solids, kg_k2o, kg_n, kg_p2o5, kg_reference_mass, kg_throughput, kwh_gross_output, kwh_hhv, kwh_primary, kwh_produced, m2_burnt, m2_collector, m2_era, m2_floor, m2_forest, m2_nfa, m2_pv_panel, m2_r1, m2_roof, m2_treated, m2_wall, m3.km, m3_solid_under_bark, m3_throughput.

reference_basis.kind: 12 kinds#

basis_kind is canonical, context_dependent. Each kind below names what a query-time bridge must supply to put a line quantity on that basis.

kind what the bridge needs
nutrient_content Basis is a mass of a nutrient/active constituent (per kg of N, P2O5, K2O, active substance), not of the purchased product. Bridge needs the constituent fraction of the product (content_factor).
product_mass_qualified Basis is a genuine product mass the source qualifies by product name (per kg of treated leather, per tonne of clinker). Bridge is identity to the mass dimension once the product is confirmed.
product_volume_qualified Basis is a genuine product volume the source qualifies by a measurement convention (per m3 solid under bark of roundwood). Bridge needs the line's volume on the same convention: stacked or over-bark volumes differ by tens of percent.
treated_throughput_mass Basis is a mass of a substance PROCESSED/removed, not of a purchasable product (per kg of removed COD, per kg NTK). No safe procurement bridge: kept context-dependent.
heating_value Energy basis on a stated calorific reference (higher heating value / PCS / SCV) that differs ~11% from the unqualified-kWh (lower heating value) default. Bridge needs the per-fuel HHV->LHV ratio.
area Basis is a physical area with a product-specific qualifier (net floor area / wall / roof). Bridge needs the line item's area.
land_occupation Basis is area x time (per hectare.year). Bridge needs both an area and a duration.
length Basis is a physical length (per metre, per metre of road). Bridge needs the line item's length.
count_item Basis is a count of a specific item/service the source names (per meal, per plant, per person.month). Bridge needs the items-per-line-unit.
volumetric_density Basis needs a density or a second dimension to reduce to a purchasable quantity (per m3.km). Bridge needs the density/second axis.
gas_volume Basis is a plain canonical volume (unit_code l) of a GAS, metered at the publisher's reference conditions: {temperature_c, pressure_kpa}, or 'unstated' where the source names none. The only kind a canonical factor may carry: the volume converts by rule like any litre, and the conditions ride along for the per-factor bridge to energy or mass, which uses the publisher's own calorific value at those conditions.
energy_accounting_point Basis is a kWh METERED AT A DIFFERENT POINT of the energy chain than the unqualified default (gross generator output / primary energy, versus final energy delivered to the buyer). Distinct from heating_value, which qualifies how a fuel's energy content is counted, not where it is measured: a gross-output kWh and a final-energy kWh differ by generation and network losses, 1.8-3.0x apart in UBA DE's tables while both print the bare label 'g/kWh'. Bridge needs the conversion efficiency and the network-loss factor.

Value axes#

axis codes reading
value_status published, pending Read it first. A pending row is a factor of a served release whose value is withheld from every caller, entitled or not: every value column is NULL (not a zero), while the GWP fields name the method its edition scores on. Filter published before you sum, convert or rank; the coverage value_count counts published rows only, and values_total counts a pending row like a licence-withheld value. Only ecoinvent may hold one today.
data_quality_normalized high, medium, low, very_low, problematic The one ordinal comparable across publishers, best first. problematic is set explicitly by an adapter for a value that must not be used naively; factors_flat excludes it. data_quality_rating_native is NOT served by factors_flat: it is only meaningful with its data_quality_scheme_native, so read both off emission_factor_value or not at all.
data_quality_reason_normalized 38 tokens, see below Machine-readable reason the tier is what it is, or why a 0 is real: a closed registry, table below.
co2e_basis fossil_only, biogenic_co2_excluded, net_total, io_total WHICH CO2e the headline counts (biogenic and LULUC in or out). Two factors with different bases are not comparable, however close their numbers look.
data_type average, generic, specific How specific the number is to the thing you bought. specific is the ILCD specific dataset: ONE product from one named plant; a supplier link never implies it, since an industry EPD's declarant is a trade association and a retailer's coefficient is its average across all its customers. generic is a default standing in for a measurement, no producer attached: a generic construction database, a restated IPCC default, a national LCI default. average is a mean over producers: a market, national, sector or operator-wide figure, a grid, heat or market mix, a supermarket basket. A publisher's own fourth word folds onto one of the three and survives verbatim in source_row.raw.
characterization_model cml_1999, cml_1999_baseline, cml_2001_baseline, ef_3.0, ef_3.1, houghton_net_max, houghton_net_min, impact_world_plus_2_1, impact_world_plus_2_2_1, ipcc_2021, ipcc_ar5_direct, recipe_2016_midpoint_h The impact-assessment method the publisher NAMES for this number: what separates an EF 3.1 figure from a CML one, and the only thing telling EXIOBASE's seven values on one factor apart. NULL wherever the source names no method: the vintage already lives in gwp_method_native, so a vintage token here would invent a source claim. Never prose: a sentence restating a GWP choice lands in its own bucket under any GROUP BY.
price_basis basic, producer, purchaser Monetary factors only: producer (ex-margins) / purchaser (incl. trade + transport margins) / basic (producer less product taxes plus subsidies).
grid_mix → calculation_approach production → location_based, consumption → location_based, marginal → location_based, residual → market_based, total_supplier_mix → market_based, supplier_specific → market_based, green → market_based GHG-Protocol scope 2 duality; the pair is enforced, they can never disagree. production is the mix of the plants generating in the territory, consumption the mix of what is consumed there (imports in, exports out), marginal a margin construct such as the CDM Tool 07 operating margin.
value_qualifiers keys averaging_window, driving_cycle, electricity_input_mix, feedstock, flag_split, google_cfe_share, io_table, lca_method, luc_amortisation_years, luc_discounting, luc_method, margins, mass_basis, oxidation_basis, policy_year, preliminary, recovered_heat_allocation, rfi_multiplier, scenario, statistical_correction A closed registry, not a dumping ground: a cross-library concept becomes a typed column instead. luc_method is one of dluc, excluded, iluc, sluc (excluded is 0LUC). flag_split is one of derived_from_gases, published: published when the publisher states the FLAG buckets, derived_from_gases when the adapter computed them from the publisher's own per-gas, per-process legs. luc_amortisation_years is the period the FLAG LUC leg is amortised over, a positive integer (20 under SBTi). luc_discounting is how it is spread over that period, one of equal, linear: linear weighs the years nearest the conversion most, as SBTi FLAG and the GHG Protocol Land Sector and Removals Standard require; equal gives every year the same share. All three are annotations: they never tell two values apart.
publisher.kind commercial, government, intergovernmental, nonprofit, research What kind of body publishes the library; one value per publisher.
publisher.tags construction, conversion_factors, electricity, epd, food, grid_mix, ict, lci, spend, trade, transport, waste What the library is, many-valued (conversion factors and spend at once); the portal derives its library groups from kind + tags.
publisher.scope generalist, specialist Measured, not declared: a generalist has at least 4 Categories each holding 5% of its top-level factors; NULL while it serves nothing. Rebuilt with the year index.

data_quality_reason_normalized: 38 tokens#

Machine-readable reason the tier is what it is, or why a 0 is real. A token outside this registry halts the ingest: an adapter coining a new one adds it to CONFIDENCE_REASONS in ingest/models.py. It never forces a tier by itself: data_quality_normalized_override floors, and several tokens here name a contractual zero MOD-0015 serves at whatever tier its own quality signal derives (never floored for being zero) rather than a fixed ceiling: see the module docstring.

The last two columns are what the API serves beside the token, from quality_reasons.py (FRN-0030): the token is the stable identifier and tells a reader nothing on its own, so the withheld disclosure carries this prose with it. The English is below; a lang the registry is written in is served that language instead, and a client holding its own translations renders the token.

token meaning served label served explanation
allocation_share_outlier a value derived by allocating a national emission total across products by a share, where the share breaks down on a small producer: below zero, or more than 10x the World value of the same item and year; problematic and withheld, the printed value and the rule kept in source_record (faostat EI, FAOSTAT-1 A). Distorted by how emissions were split The publisher splits a country's farm emissions between its products by a share. Where a country produces very little of a product, that split can put the figure below zero or more than ten times the world value for the same product and year, which no farm system explains. We keep it as printed and do not serve it.
biogenic_excluded_zero a headline 0 on a fuel whose combustion CO2 is biogenic and left out by the value's co2e_basis, the leg printed beside it or not printed at all: an artefact of the basis rather than the world; always problematic, loader-enforced where the leg is printed (ingest/biogenic_zero.py, plan MOD-0009; widened by MOD-0023 step 8). Zero, beside CO2 that is actually released The headline reads 0 because the accounting convention leaves out the biogenic CO2 the fuel releases when burned; the zero describes the convention, not the fuel.
context_dependent_basis a value stated on a basis a plain unit does not carry (a kilogram of nitrogen, net floor area, a higher-heating-value kWh), so a quantity fits only when measured on that same basis, checked line by line: floored so it never outranks a rated canonical match (ademe, co2emissiefactoren_be/_nl). The unit's basis depends on context The value is stated on a basis that a plain unit does not carry, such as a kilogram of nitrogen rather than of fertiliser, a square metre of net floor area or a kilowatt-hour on the higher heating value, so a quantity fits it only when it is measured on that same basis, which has to be checked line by line.
estimated_from_broader_region an estimated leg whose input comes from a larger region that contains this one: for an electricity leg, the nearest ancestor region that has one, hops recorded in source_record (rungs L2 and U2, MOD-0042); for a fuel's well-to-tank leg, the European Union's average supply chain for a member state (rung W2, MOD-0043). Capped at very_low. Estimated from a broader region The region has no figures of its own for this leg, so open-climate.ai used those of a larger region that contains it: for electricity, the nearest one with a statistic; for a fuel's supply chain (well-to-tank), the European Union's average. The result is rated very low for that reason.
estimated_from_proxy_region a fuel's well-to-tank leg open-climate.ai estimated from another country's supply chain standing in for the region's: the United Kingdom's same-fuel ratio (rung W3, MOD-0043, E5). Not a broader region, since the stand-in does not contain the region. Capped at very_low. Estimated from another country's supply chain open-climate.ai estimated this fuel's supply-chain leg (well-to-tank) from another country's supply chain, such as the United Kingdom's, standing in for the region's own, and the result is rated very low for it.
estimated_from_regional_model a leg open-climate.ai estimated from a model of the region, not a measurement of it: for an electricity fuel-chain leg, the region's own generation mix weighted by per-fuel upstream factors (rung U1, MOD-0042); for a fuel's well-to-tank leg, a supply-chain model of the region such as NETL's for the United States or New Zealand's inventory (rung W1, MOD-0043). Capped at low. Estimated from a model of the region open-climate.ai estimated this upstream leg from a model of the region rather than a measurement of it: for electricity, the region's own generation mix and per-fuel upstream factors; for a fuel's supply chain (well-to-tank), a published model of that supply chain in the region.
estimated_from_regional_statistic a leg the publisher never printed that open-climate.ai estimated from published figures for the region itself: for an electricity leg, the publisher's own printed figures (rung L0) or a regional loss statistic such as the grid loss rate (rung L1, MOD-0042); for a fuel's well-to-tank leg, another publisher's figures for the same country (rung W0, MOD-0043). Capped at medium by ESTIMATE_REASON_CEILING; the inputs, formula and year sit in source_record. Estimated from figures for the region The publisher prints the generation or combustion figure but not this leg, so open-climate.ai estimated it from published figures for the region itself: for electricity, the publisher's own figures or a statistic such as the region's grid loss rate; for a fuel's supply chain (well-to-tank), another publisher's figures for the same country.
foreground_only_uncertainty the publisher prints a +/- that is a foreground-only Monte Carlo deviation: the background database is held fixed and the sampled sites can be a few percent of capacity, so the tier the shared handler derives from that +/- overstates confidence. The +/- stays in uncertainty_pct; a reviewed override sets the tier, medium (plastics_recyclers_europe, IMP-0064). Uncertainty covers the recycler's own step only The publisher's printed margin samples only the recycling plants' own data and holds the background databases fixed, so it reads tighter than the number is; open-climate.ai keeps the margin but rates the value medium.
generic_spend_category an EEIO product/spend category too generic to price sharply: very_low (exiobase's overly-generic code numbers). Too broad to be precise The spending category covers too much ground to price any one purchase sharply.
green_electricity_zero a Guarantee-of-Origin or supplier-specific green tariff's zero: contractual, served at the tier its market-based residual sibling derives, never floored for being zero (MOD-0015). Zero under a green tariff The zero is what the contract certifies, a Guarantee of Origin or a supplier's green tariff, rather than a gap in the data.
hestia_aggregated_quality the tier is carried verbatim from HESTIA's own 1-5 pedigree scale rather than claimed as a data_quality_rating_native under a scheme it does not belong to (WRAP). Rated on the source's own scale The rating is carried straight from the source's own 1 to 5 pedigree scale rather than restated under a scheme it does not belong to.
implausible_estimated_loss_share an estimated electricity loss leg whose loss share, derived from the publisher's own consumption and generation figures (rung L0, MOD-0042), is above the 0.20 ceiling: above it the gap between the two series is mostly electricity traded with neighbouring regions, not grid loss (the full-rights reference table's highest measured share is 0.1726, Montenegro 2015). Kept and withheld: problematic. Estimated loss share implausible open-climate.ai estimated this grid loss leg from the publisher's own consumption and generation figures, but the loss share they imply is above 20%, beyond the highest share in the loss statistics we hold (17.26%, Montenegro in 2015); a gap that wide is mostly electricity traded with neighbouring regions rather than lost in the grid, so we keep the estimate and do not serve it.
implausible_gwp_split an EPD that files at least 80% of its product stage's GWP-total under biogenic carbon or land use and at most 20% under fossil, on a product neither its category nor its name makes bio-based (land use: grown on land): every module serves the publisher's total in place of the misfiled fossil leg, the legs are not served, the printed split stays in source_record; served at its derived tier (the shared ILCD+EPD adapter, IMP-0028). Carbon split misfiled by the publisher The publisher filed nearly all of this product's fossil impact under biogenic carbon or land use, which a product that is not bio-based cannot have, so we serve the publisher's total in place of the fossil figure and keep the printed split in the source record.
implausible_mass_intensity a value above a plausibility ceiling for its module and unit: per kilogram for a mass-basis value or a per-piece value divided by its stated weight per piece, per metre, square metre, litre or kWh for a measure-basis one outside B6 and B7; a declared-unit or reference-flow error candidate (ÖKOBAUDAT and the EPD programme nodes), problematic. Impossibly high for its unit The emissions per kilogram, metre, square metre, litre or kilowatt-hour sit far above anything plausible for this kind of product, which usually means the declared unit or the reference amount in the source is wrong.
implausible_printed_zero a zero the source prints that cannot be true of what it prices and would silently zero every line it matched: a zero intensity in a computed spend matrix (exiobase), a single-gas zero in a national-inventory default (ipcc EFDB): artefact, problematic and withheld (MOD-0023 step 8). A zero that is not really zero The source prints 0 for this row, but the zero comes from how the dataset was built rather than from something that genuinely emits nothing, so anything matched to it would come out at zero emissions.
implausible_reference_flow a module of an EPD whose production stage (A1-A3, A1, A2 or A3) is above the plausibility ceiling of its flow (per kilogram, metre, square metre, litre or kWh): every module is declared per the one reference flow, so when the production stage cannot be per that unit no module is (a per-km cable or a per-m3 concrete on a 1 kg flow, a per-km pipe on a 1 m flow): problematic, the production-stage cell named in source_record (the shared ILCD+EPD adapter: ÖKOBAUDAT and the EPD programme nodes, IMP-0028). A module itself above its ceiling keeps implausible_mass_intensity. Also every module of a per-m3 EPD whose stated gross (else bulk) density is below 1 kg/m3, lighter than air: the figures are per kilogram, the density field holds m3/kg or g/cm3, and source_record names the density (density_floor). Also TGO's CFP row 477, a knapsack sprayer printed at 5.59x10-10 kg CO2e per m2, ten orders of magnitude below its group's other per-m2 rows: served as printed, problematic, the defect named in source_record (IMP-0055). Declaration's unit in doubt This declaration's figures do not fit its stated unit. Either its production stage is far too high for it, such as a kilogram or a metre, which usually means the source states every figure for another quantity, such as a kilometre of cable or a cubic metre of concrete. Or it is declared per cubic metre with a density lighter than air, which means the figures are per kilogram. All stages of a declaration share that quantity, so we do not serve this stage either.
implausible_sibling_outlier a value an order of magnitude or more away from its documented siblings of the same kind, with nothing in the data set that explains it: served as printed, floored to problematic and withheld, the finding named in source_record (Base IMPACTS' undocumented world grid mix at 0.022 kg CO2e/kWh against 0.50 for its EU-28 sibling, CLN-0053; AusLCI's expanded vermiculite at -1.85 kg CO2e/kg and the potting mix and seedling built on it, and its peanuts market, the only rows outside Waste treatment whose fossil column is below zero, every value floored, MOD-0089; ademe's recycled polystyrene, 20840, printing its virgin twin's 2.83 kg CO2e/kg, 7 to 14x every other recycled resin, MOD-0089). Far from its documented siblings This value is ten times or more away from the publisher's own documented values for the same kind of activity, and the source gives no description, technology or year that could explain it, so we keep it as printed and do not serve it.
library_prior the loader's floor when a value carries no native quality signal: a reviewed per-library prior tier (ValueSpec.library_prior) in place of the silent no_native_signal floor. Rated by us, not by the source The source publishes no quality rating for this row, so it carries the tier we reviewed for the library as a whole.
mixed_fossil_biogenic_unsplit a computed total that mixes fossil and biogenic municipal solid waste with no split available: floored to problematic (EPA). Fossil and biogenic mixed together The total combines fossil and biogenic waste with no way to split them, so it cannot be counted as either.
mixed_gwp_vintage a derived total whose legs were published on different IPCC GWP tables: a faithful sum of what the publisher printed, standing on no single vintage, so the mint drops it one rung below its weakest leg (MOD-0039). Built from different GWP tables The total adds up parts the publisher issued under different IPCC global-warming-potential tables, so no single vintage describes it.
netted_credit a value the publisher netted a credit into on a boundary that counts only a burden: a headline more than 5% below the sum of its own printed gases (uba_de), an EPD module of A4-A5, B2-B7 or C1-C4 whose fossil GWP is below zero by more than 10% of its A1-A3 (the shared ILCD+EPD adapter), a gas or heat menu's adjusted zero under a basic coefficient above zero (japan_moe), a Waste treatment process whose fossil column is below zero, the credit of the grid power or the virgin material it substitutes (auslci, every value of the row labelled, MOD-0089). Below zero: problematic and withheld, it would credit the line it matched; at or above zero: served at its derived tier with the label (MOD-0081). Lowered by a netted credit The publisher subtracted a credit, such as avoided emissions, an offset or a recycling benefit, inside a figure that should count only emissions, so it reads lower than the emissions themselves. A figure below zero would credit whatever it is matched to, so we keep it as printed and do not serve it.
netted_removal a total the publisher netted a genuine removal into (carbon it counts as stored in a landfill or a soil) that falls below zero; problematic and withheld, since the GHG Protocol reports removals apart and a total below zero would credit the line it matched. The removal itself serves on its own part (epa_warm's landfill envelopes, IMP-0076). Lowered below zero by stored carbon The publisher subtracted carbon it counts as stored, in a landfill or in soil, from the emissions of the same figure, which takes it below zero. The GHG Protocol reports removals apart from emissions, and a figure below zero would credit whatever it is matched to, so we keep it as printed and do not serve it. The stored carbon is shown on its own.
no_longer_loaded a value an earlier load of this same release served that the latest load no longer produces: the row is now folded into another, skipped by a rule or dropped by the publisher. Problematic and withheld rather than deleted; the trace names the run that retired it and the tier it had (CLN-0072). Withdrawn: no longer in the source as loaded An earlier load of this edition served this figure, but the latest load no longer produces it: the row is now merged into another one, left out by a rule, or dropped by the publisher. We keep it on record, with the load that withdrew it, and do not serve it.
no_native_signal the loader's silent floor when a value has neither a native quality signal nor a declared library_prior: artefact of missing signal, not a statement about the world. MOD-0015 withholds it (problematic) on a zero-valued row; a nonzero value floored only for the missing signal is the ordinary low/very_low floor, and is served. A zero with nothing behind it The source gives this row no quality rating at all and the value is zero, so a genuine zero cannot be told apart from a gap in the data.
other_form_proxy the publisher's value for another form of the food or a neighbouring food (dry for drink, dried for cooked, formula for breast milk), printed as this row's own; kept, tier set by the adapter (very_low on a row, low or very_low on a class mean that averages such rows) with an applicability sentence naming the stand-in (luke, MOD-0054 D2). Value of another form of the food The publisher prints for this food the number it measured for another form of it or a close neighbour, such as roasted beans for a cup of coffee or dried pulses for cooked ones, so it may be far from this food's own footprint.
outside_kyoto_basket_zero a Kyoto headline of 0 on a refrigerant whose gases are all outside the Kyoto basket, its warming stated in value_non_kyoto_native beside it: contractual, served at its derived tier (desnz, MOD-0063). Zero within the Kyoto basket The refrigerant's gases are controlled by the Montreal Protocol, not counted in the Kyoto basket, so the Kyoto total is 0; their warming effect is given beside it as the non-Kyoto value.
partial_gas_vector a computed total whose CO2 leg is absent on a CO2-emitting fuel: floored to problematic so it never wins a match over a full-vector factor (EPA's CH4+N2O-only non-road mobile rows). Missing its CO2 The total leaves out the CO2 from a fuel that certainly releases CO2, so it counts only part of what is emitted.
publisher_arithmetic_corrected a published cell replaced with the number the publisher's own arithmetic determines, because its own identity, sibling row or next edition fixes it (co2emissiefactoren_be): served at its derived tier, printed number kept in source_record, correction stated on the factor's description (ingest/published_corrections.py, CLN-0031). Corrected using the publisher's own arithmetic The printed cell disagreed with the publisher's own identity or sibling row, so we serve the number their arithmetic determines and keep the printed one in the source record.
publisher_arithmetic_unresolved a published cell the publisher's own arithmetic falsifies where the right number is not knowable (co2emissiefactoren_nl): kept exactly as printed and floored to problematic, with the finding stated on the factor's description; same registry. Also an EPD module whose printed GWP-fossil is more than a third away from total minus biogenic minus land use and is not the total either (the shared ILCD+EPD adapter: ÖKOBAUDAT and the EPD programme nodes, IMP-0028), the split kept in source_record. The source contradicts itself The publisher's own arithmetic disagrees with this cell and there is no way to tell which number was meant, so we keep it exactly as printed and do not serve it.
publisher_forbids_inventory_use the publisher's own methodology forbids using this value for inventory accounting (eGRID's non-baseload/marginal family): withheld. The publisher says not to use it The publisher's own method states that this number must not be used for greenhouse-gas accounting.
publisher_repeated_value a value the publisher printed twice for one activity under two identifiers, every number equal on one unit (ademe's verbatim re-issues and per-energy-basis zero legs): the copy that is not its year's default is kept as published and floored to problematic, so one factor serves one number. Printed twice by the source The publisher printed this same number twice for one activity under two references, so we serve it once and keep this copy as printed without serving it.
regulatory_default_zero_implausible a regulation-mandated default of 0 where 0 cannot be physically true (cbam's Hydrogen embedded factor): kept, because it is the number the regulation publishes, and floored to very_low so it can never win a generic match. A regulator's zero that cannot be true The regulation mandates a default of 0 where 0 is not physically possible; we serve the number the regulation publishes and rate it as low as the scale allows.
rounded_to_zero a value the publisher itself prints as 0 at its own precision: contractual, served at its derived tier (ipcc's AR6 GWP layer). Rounds to zero The publisher itself prints 0 at the precision it works to.
source_restatement_divergence a factor-year overridden to low because its emission-weighted aggregate diverges from the publisher's own printed annual figure by more than 1%: the publisher restated one input without the other (EPPO Thailand). Does not match the publisher's own annual figure Re-adding this year's inputs diverges by more than 1% from the annual number the publisher prints, which means one of the two was restated without the other.
statutory_zero a zero a mandatory reporting programme prescribes as the figure its reporters must use (Japan's statutory list: recovered incineration heat, a flare-free well's N2O; IMP-0078): contractual, served at its derived tier, like structural_zero. Zero set by law A mandatory reporting programme prescribes 0 as the figure its reporters must use for this activity, such as heat recovered from waste incineration under Japan's reporting law.
structural_zero a genuine zero the source itself prints, never a blank: a zero-emission leg (wind/hydro/solar/nuclear/geothermal/heat-pump) or a carbon-free fuel like hydrogen: contractual, served at its derived tier (MOD-0015). The artefact zeros it once also carried are implausible_printed_zero and biogenic_excluded_zero (MOD-0023 step 8). Genuinely zero The source prints 0 and the zero is real: the activity emits nothing at this stage, as with wind or solar power at the point of generation or a carbon-free fuel such as hydrogen.
superseded_by_source_model a republished extract of a model another library loads from the model itself, which serves instead: floored to problematic (the EPA Hub's WARM rows, superseded by epa_warm). Served from the source model instead This row repeats figures from a model that is also loaded directly, so the model's own row is served instead.
tiny_denominator_extreme an intensity implausibly large because its denominator does not match its numerator, most often a near-zero denominator: problematic (exiobase's kgCO2e-per-EUR ceiling; jrc_idees' ten times the EU27 value of the same transport activity and year, where a small activity or fuel sold to traffic that burns it elsewhere breaks the ratio). Impossibly large The value is emissions divided by an amount of spending or activity that does not match them, most often one far too small, so the result lands far above what the activity can emit.

GWP normalization#

Every stored measure is _native: as the publisher characterized it. The _normalized twin re-characterizes to AR6 GWP100, the one vintage on which a cross-library sum is arithmetically honest.

gwp_normalization_basis is native, invariant, recharacterized, unconverted: native is a verbatim copy (already the target), invariant is a value no vintage can change (pure CO2), recharacterized applies the per-gas differences as a delta to the published headline, never a re-sum (a publisher's headline is not guaranteed to equal the sum of its legs).

A NULL twin means not exactly derivable: a non-100-year horizon, an unknown vintage, a basket leg (HFCs / PFCs / other / non-Kyoto), or a row split only by carbon origin. Treat those rows as rows you cannot add, not as rows to fall back to native for. The non-Kyoto part stands beside the headline, never inside it. The per-gas legs it reads: value_ch4_biogenic_native, value_ch4_native, value_co2_biogenic_native, value_co2_fossil_native, value_co2_luluc_native, value_co2_native, value_hfcs_native, value_n2o_native, value_nf3_native, value_non_kyoto_native, value_other_native, value_pfcs_native, value_removals_native, value_sf6_native.

It does not land on re-ingest (an unchanged content_hash skips the value row), so it has its own verb: db-open-ef normalize-gwp.

Text surfaces: 10 fields#

emission_factor_text.field, kept apart rather than concatenated because each answers a different consumer question: activity_detail, activity_full, activity_main, applicability, description, included_processes, part_label, tags, unit_label, usage_definition.

activity_full is derived by the loader (never shipped by an adapter) and is the search keyword; usage_definition is ours, no longer generated since 2026-10-27 (stored values frozen), and is the one link a re-ingest purge deliberately keeps. part_label is the publisher's name for one part of a decomposed factor, set only on a part and never inherited by a parent.

Licence tiers: 4 values#

release.license_tier, closed by the release_license_tier_valid CHECK. The one vocabulary here whose typo is silent: the serving gate fails CLOSED, so an unrecognised tier hides a library rather than raising. The database now refuses one outright.

tier an anonymous caller sees why
open the row and its values public-domain or attribution-only; redistribution is granted
copyleft the row and its values redistribution granted, but the share-alike obligation travels with the rows
restricted the row, with every value field withheld server-side no redistribution right established - coverage is citable, the number is not
prohibited absent entirely - a 404, never a 403 redistribution positively forbidden by the publisher's terms

A pending value (emission_factor_value.value_status) is withheld at every visibility, whatever its tier: no caller is served the number. The response says why (value_withheld_reason = pending).

license_code: a convention, not a registry#

Deliberately an open string rather than a closed list: a new publisher arrives with a new licence, and halting an ingest over an unseen code would be the wrong failure. The convention is lowercase kebab-case, held by review rather than by the schema.

It is not an SPDX identifier field. Where an SPDX identifier exists the code is derived from it, lowercased (cc0-1.0, cc-by-4.0, cc-by-sa-4.0); where none exists (the majority of them) the code is minted locally and names the terms it points at (co2emissiefactoren-nl-terms, us-gov-public-domain). Read license_url for those terms and attribution_text for the string that must be reproduced verbatim.

license_terms: what each code lets a reader do, 88 codes#

One row per license_code (MOD-0038), mirrored from ingest/license_terms_registry.py by db-open-ef seed-license-terms; the gating license_code_without_terms check refuses a release whose code has no row. Each right answers yes, yes_if (the listed conditions), ask (the terms reserve it; the holder grants it), no, or unclear (no written grant settles it). A plain reading, not legal advice: the publisher's terms at the linked page prevail.

code own footprint publish results share with customers embed in a product modify / combine conditions basis permission holder verified
ademe-base-empreinte-terms yes yes_if unclear unclear yes_if attribution published_terms ADEME 2026-10-07
adnetzero-terms yes_if ask ask ask ask attribution published_terms Ad Net Zero Limited 2026-10-07
aib-attribution yes yes_if unclear unclear yes_if attribution published_terms Association of Issuing Bodies (AIB) 2026-07-20
apache-2.0 yes yes_if yes_if yes_if yes_if attribution, state_changes, no_endorsement named_licence - 2026-10-14
au-web-copyright-notice yes yes_if unclear unclear ask attribution owner_risk_decision Aarhus University, DCE - Danish Centre for Environment and Energy 2026-10-07
auslci-terms yes yes_if unclear unclear unclear no_endorsement published_terms ALCAS (Australian Life Cycle Assessment Society) 2026-10-14
boverket-klimatdatabas-terms yes yes_if unclear unclear unclear attribution published_terms Boverket 2026-10-12
cc-by-4.0 yes yes_if yes_if yes_if yes_if attribution, state_changes named_licence - 2026-08-02
cc-by-4.0-fao-db-terms yes yes_if yes_if yes_if yes_if attribution, state_changes, no_endorsement named_licence - 2026-10-16
cc-by-nd-3.0 yes yes_if yes_if yes_if no attribution, keep_unchanged named_licence - 2026-10-07
cc-by-sa-4.0 yes yes_if yes_if yes_if yes_if attribution, state_changes, share_alike named_licence - 2026-07-17
cc-unspecified-iinas yes yes_if unclear unclear yes_if attribution, state_changes, share_alike published_terms IINAS GmbH 2026-08-17
cc0-1.0 yes yes yes yes yes - named_licence - 2026-08-17
ch-urg-art5 yes yes_if yes_if yes_if yes_if attribution, no_endorsement statute - 2026-10-13
co-actos-administrativos yes yes yes_if yes_if yes_if attribution statute - 2026-11-03
co2emissiefactoren-be-terms yes yes_if unclear unclear unclear attribution owner_risk_decision EnergieID & BENOR 2026-10-07
co2emissiefactoren-nl-terms yes yes_if yes_if yes_if yes_if attribution, notify_publisher written_confirmation Stichting Stimular, for the Green Deal partners 2026-09-15
crs-green-e-no-stated-licence yes yes_if unclear unclear unclear attribution owner_risk_decision Center for Resource Solutions (CRS) 2026-09-14
dapcons-terms yes_if unclear ask ask ask non_commercial published_terms Cateb (Col·legi de l'Arquitectura Tècnica de Barcelona) 2026-10-02
dewa-no-stated-terms yes yes_if unclear unclear unclear attribution owner_risk_decision Dubai Electricity and Water Authority (DEWA PJSC) 2026-10-14
dffe-za-website-terms yes_if yes_if ask ask ask attribution published_terms Department of Forestry, Fisheries and the Environment (DFFE), South Africa 2026-11-03
dfo-exiobase-notice yes yes_if unclear ask ask attribution, non_commercial published_terms Direktoratet for forvaltning og økonomistyring (DFØ); for the EXIOBASE input, XIO SA AS 2026-10-01
dixi-gto-terms yes yes_if unclear unclear unclear attribution owner_risk_decision DiXi Group / Green Transition Office 2026-10-14
dk-ophavsretsloven-9 yes yes_if yes_if yes_if yes_if attribution, no_endorsement statute - 2026-11-10
egovg-12a yes yes_if yes_if yes_if yes_if attribution, state_changes statute - 2026-10-02
electricity-info-uk-no-stated-terms yes yes_if unclear unclear unclear attribution owner_risk_decision ElectricityInfo.org 2026-11-09
energimyndigheten-anvandarvillkor yes yes_if unclear unclear yes_if attribution, state_changes, no_endorsement published_terms Statens energimyndighet (Swedish Energy Agency) 2026-11-10
energinet-eldeklaration-unstated yes yes_if unclear unclear unclear attribution statute Energinet 2026-10-01
ens-attribution yes yes_if unclear unclear yes_if attribution, keep_unchanged published_terms Energistyrelsen (Danish Energy Agency) 2026-10-12
epd-danmark-terms yes yes_if unclear unclear unclear attribution published_terms Teknologisk Institut (EPD Danmark) 2026-10-02
epd-hub-terms yes unclear ask ask ask - published_terms EPD Hub 2026-10-02
epd-ireland-terms yes yes_if unclear unclear unclear attribution published_terms Irish Green Building Council (EPD Ireland) 2026-10-02
epd-italy-nofield-terms yes yes_if unclear unclear unclear attribution published_terms ICMQ S.p.A. (EPD Italy programme operator) 2026-10-02
epd-italy-terms yes yes_if unclear unclear unclear attribution published_terms ICMQ S.p.A. (EPD Italy programme operator) 2026-10-02
epd-norge-digi-terms yes yes_if ask ask no attribution published_terms EPD-Norge (Næringslivets Stiftelse for Miljødeklarasjoner) 2026-10-02
eppo-open-data-common yes yes_if unclear unclear unclear attribution owner_risk_decision Energy Policy and Planning Office (EPPO), Thailand 2026-09-14
etalab-2.0 yes yes_if yes_if yes_if yes_if attribution named_licence - 2026-07-17
gencat-reutilitzacio yes yes_if yes_if yes_if yes_if attribution, keep_unchanged named_licence - 2026-10-19
ghgp-india-terms yes yes_if unclear unclear yes_if attribution, state_changes, no_endorsement published_terms GHG Platform India 2026-10-14
glec-sfc-notice yes_if yes_if ask ask ask attribution published_terms Smart Freight Centre 2026-08-08
globalepd-terms yes yes_if ask ask ask attribution published_terms AENOR (GlobalEPD programme) 2026-10-02
gobmx-terminos-condiciones yes_if no no no no non_commercial published_terms - 2026-09-24
huellachile-no-stated-terms yes yes_if unclear unclear unclear attribution owner_risk_decision Ministerio del Medio Ambiente, Programa HuellaChile 2026-11-03
iges-citation yes yes_if unclear unclear unclear attribution published_terms Ministry of the Environment, Japan (compiled by IGES) 2026-10-16
ipcc-copyright-notice yes_if yes_if unclear unclear ask attribution owner_risk_decision IPCC Secretariat 2026-10-28
itb-epd-terms yes yes_if unclear unclear unclear attribution published_terms Instytut Techniki Budowlanej (ITB) 2026-10-02
kbob-terms yes yes_if unclear unclear unclear attribution owner_risk_decision Trägerschaft Plattform Ökobilanzdaten im Baubereich (KBOB / ecobau / IPB) 2026-10-15
keiti-lci-terms yes yes_if unclear unclear unclear attribution published_terms 한국환경산업기술원 (KEITI) 2026-11-10
kiwa-ee-terms yes yes_if unclear unclear unclear attribution written_confirmation Kiwa GmbH, Ecobility Experts 2026-10-21
kr-copyright-act-24-2 yes yes_if yes_if yes_if yes_if attribution statute - 2026-11-10
kr-copyright-act-7 yes yes yes_if yes_if yes_if attribution statute - 2026-11-09
kr-public-data-act-3 yes yes yes yes yes - statute - 2026-10-02
ley-37-2007 yes yes_if yes_if yes_if yes_if attribution, keep_unchanged statute - 2026-07-20
log-45-2018 yes yes_if yes_if yes_if yes_if attribution, no_endorsement statute Umhverfis- og orkustofnun (UOS), for its Losunarstuðlar workbook 2026-10-05
mee-cn-site-statement yes yes yes_if yes_if yes_if attribution statute Ministry of Ecology and Environment of the People's Republic of China (生态环境部) 2026-10-04
mrpi-terms yes yes_if unclear unclear unclear attribution published_terms Stichting MRPI 2026-10-02
mx-gobierno-publico yes yes_if yes_if yes_if yes_if attribution statute - 2026-08-17
naturvardsverket-no-stated-licence yes yes_if unclear unclear unclear attribution owner_risk_decision Naturvårdsverket (Swedish Environmental Protection Agency) 2026-10-04
no-copyright-asserted yes yes unclear unclear yes - published_terms UNEP Ozone Secretariat 2026-10-15
norsk-fjernvarme-unstated yes yes_if unclear unclear unclear attribution owner_risk_decision Norsk Fjernvarme 2026-11-09
odbl-1.0 yes yes_if yes_if yes_if yes_if attribution, state_changes, share_alike named_licence - 2026-10-05
offentleglova-7 yes yes yes yes yes - statute - 2026-10-01
ogdl-tw-1.0 yes yes_if yes_if yes_if yes_if attribution named_licence - 2026-10-02
ogl-3.0 yes yes_if yes_if yes_if yes_if attribution, no_endorsement named_licence - 2026-07-20
ogl-canada-2.0 yes yes_if yes_if yes_if yes_if attribution, no_endorsement named_licence - 2026-08-16
oid-site-terms yes_if ask no no ask attribution published_terms Observatoire de l'Immobilier Durable (OID) 2026-10-07
okobaudat-terms yes yes_if unclear unclear unclear attribution published_terms BBSR (Federal Institute for Research on Building, Urban Affairs and Spatial Development) 2026-11-17
opendata-swiss-by yes yes_if yes_if yes_if yes_if attribution statute - 2026-09-24
pdl-1.0 yes yes_if yes_if yes_if yes_if attribution, state_changes named_licence - 2026-08-16
probas-nutzungsbedingungen yes yes_if yes_if yes_if yes_if attribution, keep_unchanged owner_risk_decision - 2026-10-04
proprietary-ecoinvent-eula-v3 yes_if yes_if no ask yes_if hold_licence, attribution published_terms ecoinvent Association 2026-08-18
rightsstatements-inc-1.0 yes_if yes_if ask ask ask attribution published_terms Umweltbundesamt (UBA) 2026-08-26
rmi-ociplus-terms yes_if yes_if unclear no yes_if attribution, state_changes published_terms RMI (Rocky Mountain Institute) 2026-10-07
rts-epd-terms yes yes_if ask ask ask attribution published_terms Rakennustieto Oy (RTS EPD) 2026-10-02
se-url-9 yes yes_if yes_if yes_if yes_if attribution, no_endorsement statute - 2026-11-09
seai-site-terms yes yes_if unclear unclear ask attribution owner_risk_decision Sustainable Energy Authority of Ireland (SEAI) 2026-11-03
slu-safad-repo-mit-data-unstated yes yes_if unclear unclear unclear attribution published_terms Department of Energy and Technology, Swedish University of Agricultural Sciences (SLU) 2026-10-01
sodl-1.0 yes yes_if yes_if yes_if yes_if attribution, no_endorsement named_licence - 2026-10-12
syke-co2data-terms yes yes_if unclear unclear unclear attribution owner_risk_decision Suomen ympäristökeskus (Syke) 2026-10-01
tgo-website-policy yes_if yes_if ask ask ask attribution published_terms Thailand Greenhouse Gas Management Organization (TGO); for the CFP list's underlying data also TIIS-MTEC-NSTDA (Thai National LCI Database) 2026-10-04
uba-de-written-consent yes yes_if yes_if yes_if yes_if attribution, state_changes written_confirmation Umweltbundesamt (UBA) 2026-11-09
unfccc-tou-official-documents yes yes_if unclear unclear yes_if attribution, keep_unchanged published_terms UNFCCC secretariat 2026-10-12
upme-terminos-condiciones yes yes_if unclear unclear ask attribution owner_risk_decision Unidad de Planeación Minero Energética (UPME) 2026-11-03
upphandlingsmyndigheten-terms yes yes_if unclear unclear yes_if attribution, state_changes published_terms Upphandlingsmyndigheten 2026-10-01
us-gov-public-domain yes yes yes yes yes - statute - 2026-08-05
vn-ip-law-art15 yes yes yes_if yes_if yes_if attribution statute - 2026-11-03
worldsteel-site-terms yes_if yes_if ask no no attribution, keep_unchanged written_confirmation World Steel Association AISBL 2026-10-27
wrap-terms yes yes_if unclear unclear ask attribution, no_endorsement owner_risk_decision WRAP (Waste and Resources Action Programme) 2026-10-07