Metadata¶
Metadata (i.e. data that describe iTEM data) are stored in the public transportenergy/metadata repository. This page displays some of these metadata files.
To make use of these files:
Install
itemand use its methods to retrieve the files in useful Python data formats.Include this repository as a git submodule—as is done in the transportenergy/database repo used to build the
itempackage and this documentation.
SDMX metadata (structure.xml)¶
<mes:Structure xmlns:com="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/common" xmlns:data="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/data/structurespecific" xmlns:str="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/structure" xmlns:mes="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/message" xmlns:gen="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/data/generic" xmlns:footer="http://www.sdmx.org/resources/sdmxml/schemas/v2_1/message/footer" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<mes:Header>
<mes:Test>false</mes:Test>
<mes:Sender id="iTEM">
<com:Name xml:lang="en">International Transport Energy Modeling</com:Name>
</mes:Sender>
</mes:Header>
<mes:Structures>
<str:OrganisationSchemes>
<str:AgencyScheme version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="iTEM" urn="urn:sdmx:org.sdmx.infomodel.base.AgencyScheme=iTEM:iTEM(0.1)">
<str:Agency id="iTEM">
<com:Name xml:lang="en">International Transport Energy Modeling</com:Name>
</str:Agency>
</str:AgencyScheme>
</str:OrganisationSchemes>
<str:Codelists>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_AUTOMATION" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_AUTOMATION(0.1)">
<str:Code id="HUMAN">
<com:Name xml:lang="en">Human</com:Name>
<com:Description xml:lang="en">Vehicle operated by a human driver.</com:Description>
</str:Code>
<str:Code id="AV">
<com:Name xml:lang="en">Automated</com:Name>
<com:Description xml:lang="en">Fully-automated (self-driving) vehicle.</com:Description>
</str:Code>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_FLEET" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_FLEET(0.1)">
<str:Code id="ALL">
<com:Description xml:lang="en">All vehicles in use in the reporting period.</com:Description>
</str:Code>
<str:Code id="NEW">
<com:Description xml:lang="en">Only newly-sold vehicles in the reporting period.</com:Description>
</str:Code>
<str:Code id="USED">
<com:Description xml:lang="en">Only used vehicles that were not manufactured in the reporting period.</com:Description>
</str:Code>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_FUEL" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_FUEL(0.1)">
<str:Code id="ALL">
<com:Description xml:lang="en">All fuels.</com:Description>
</str:Code>
<str:Code id="LIQUID">
<com:Name xml:lang="en">All liquid</com:Name>
</str:Code>
<str:Code id="DIESEL">
<str:Parent>
<Ref id="LIQUID"/>
</str:Parent>
</str:Code>
<str:Code id="GASOLINE">
<str:Parent>
<Ref id="LIQUID"/>
</str:Parent>
</str:Code>
<str:Code id="BIOFUEL">
<com:Name xml:lang="en">Liquid biofuel</com:Name>
<str:Parent>
<Ref id="LIQUID"/>
</str:Parent>
</str:Code>
<str:Code id="SYNTHETIC">
<com:Description xml:lang="en">a.k.a. synfuels, electrofuels.</com:Description>
<str:Parent>
<Ref id="LIQUID"/>
</str:Parent>
</str:Code>
<str:Code id="NG">
<com:Name xml:lang="en">Natural gas</com:Name>
</str:Code>
<str:Code id="HYDROGEN"/>
<str:Code id="ELECTRICITY"/>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_LCA_SCOPE" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_LCA_SCOPE(0.1)">
<str:Code id="TTW">
<com:Name xml:lang="en">Tank-to-wheels</com:Name>
</str:Code>
<str:Code id="WTT">
<com:Name xml:lang="en">Well-to-tank</com:Name>
</str:Code>
<str:Code id="WTW">
<com:Name xml:lang="en">Well-to-wheels</com:Name>
</str:Code>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_MODE" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_MODE(0.1)">
<str:Code id="ALL">
<com:Name xml:lang="en">All</com:Name>
<com:Description xml:lang="en">All transport modes.</com:Description>
</str:Code>
<str:Code id="AIR">
<com:Name xml:lang="en">Aviation</com:Name>
</str:Code>
<str:Code id="LAND">
<com:Name xml:lang="en">Land transport</com:Name>
</str:Code>
<str:Code id="ROAD">
<com:Name xml:lang="en">Road</com:Name>
</str:Code>
<str:Code id="RAIL">
<com:Name xml:lang="en">Rail</com:Name>
</str:Code>
<str:Code id="WATER">
<com:Name xml:lang="en">Water</com:Name>
</str:Code>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_OPERATOR" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_OPERATOR(0.1)">
<str:Code id="OWN">
<com:Name xml:lang="en">Own-supplied</com:Name>
<com:Description xml:lang="en">Transport by a vehicle owned and operated for private use by a household or individual.</com:Description>
</str:Code>
<str:Code id="HIRE">
<com:Name xml:lang="en">Hired</com:Name>
<com:Description xml:lang="en">Transport by a vehicle (and driver) hired through a firm or commercial service.</com:Description>
</str:Code>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_POLLUTANT" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_POLLUTANT(0.1)">
<str:Code id="GHG">
<com:Name xml:lang="en">GHG</com:Name>
<com:Description xml:lang="en">Greenhouse gases. Where used for totals, all GHGs are conveted to an equivalence basis.</com:Description>
</str:Code>
<str:Code id="CO2">
<com:Name xml:lang="en">CO₂</com:Name>
<com:Description xml:lang="en">Carbon dioxide.</com:Description>
<str:Parent>
<Ref id="GHG"/>
</str:Parent>
</str:Code>
<str:Code id="AQ">
<com:Description xml:lang="en">Air quality-related pollutant species.</com:Description>
</str:Code>
<str:Code id="BC">
<com:Name xml:lang="en">BC</com:Name>
<com:Description xml:lang="en">Black carbon.</com:Description>
<str:Parent>
<Ref id="AQ"/>
</str:Parent>
</str:Code>
<str:Code id="NOX">
<com:Name xml:lang="en">NOx</com:Name>
<com:Description xml:lang="en">Air quality-related nitrogen oxides, i.e. NO, NO₂, and N₂O.</com:Description>
<str:Parent>
<Ref id="AQ"/>
</str:Parent>
</str:Code>
<str:Code id="PM25">
<com:Name xml:lang="en">PM2.5</com:Name>
<com:Description xml:lang="en">Particulate matter smaller than 2.5 μm.</com:Description>
<str:Parent>
<Ref id="AQ"/>
</str:Parent>
</str:Code>
<str:Code id="SO2">
<com:Name xml:lang="en">SO₂</com:Name>
<com:Description xml:lang="en">Sulfur dioxide.</com:Description>
<str:Parent>
<Ref id="AQ"/>
</str:Parent>
</str:Code>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_TYPE" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_TYPE(0.1)">
<str:Code id="P">
<com:Name xml:lang="en">Passenger</com:Name>
</str:Code>
<str:Code id="F">
<com:Name xml:lang="en">Freight</com:Name>
</str:Code>
</str:Codelist>
<str:Codelist version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="CL_VEHICLE" urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=iTEM:CL_VEHICLE(0.1)">
<str:Code id="ALL">
<com:Description xml:lang="en">All vehicle types.</com:Description>
</str:Code>
<str:Code id="LDV">
<com:Description xml:lang="en">Light-duty road vehicle, including cars, SUVs, and light trucks.</com:Description>
</str:Code>
<str:Code id="BUS"/>
<str:Code id="TRUCK"/>
<str:Code id="2W+3W">
<com:Description xml:lang="en">Two- and three-wheeled road vehicles.</com:Description>
</str:Code>
</str:Codelist>
</str:Codelists>
<str:Concepts>
<str:ConceptScheme version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="TRANSPORT" urn="urn:sdmx:org.sdmx.infomodel.conceptscheme.ConceptScheme=iTEM:TRANSPORT(0.1)">
<com:Description xml:lang="en">Concepts used as dimensions or attributes for transport data.</com:Description>
<str:Concept id="TYPE">
<com:Name xml:lang="en">Objects being transported, e.g. passengers or freight</com:Name>
</str:Concept>
<str:Concept id="MODE">
<com:Name xml:lang="en">Mode or medium of transport</com:Name>
</str:Concept>
<str:Concept id="VEHICLE">
<com:Name xml:lang="en">Type of transport vehicle</com:Name>
</str:Concept>
<str:Concept id="FUEL">
<com:Name xml:lang="en">Fuel or energy carrier for transport</com:Name>
</str:Concept>
<str:Concept id="TECHNOLOGY">
<com:Name xml:lang="en">Powertrain technology</com:Name>
<com:Description xml:lang="en">Energy conversion technology used to power a motorized vehicle</com:Description>
</str:Concept>
<str:Concept id="AUTOMATION">
<com:Name xml:lang="en">Degree of automation in operation of transport vehicles</com:Name>
</str:Concept>
<str:Concept id="OPERATOR">
<com:Name xml:lang="en">Entity operating a transport vehicle</com:Name>
</str:Concept>
<str:Concept id="POLLUTANT">
<com:Name xml:lang="en">Species of environmental pollutant</com:Name>
</str:Concept>
<str:Concept id="LCA_SCOPE">
<com:Name xml:lang="en">LCA scope</com:Name>
<com:Description xml:lang="en">Scope of analysis covered by a transport life-cycle measure</com:Description>
</str:Concept>
<str:Concept id="FLEET">
<com:Description xml:lang="en">Part of a fleet of transport vehicles, e.g. new versus used.</com:Description>
</str:Concept>
</str:ConceptScheme>
<str:ConceptScheme version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="MODELING" urn="urn:sdmx:org.sdmx.infomodel.conceptscheme.ConceptScheme=iTEM:MODELING(0.1)">
<com:Description xml:lang="en">Concepts related to model-based research & assessment.</com:Description>
<str:Concept id="MODEL">
<com:Name xml:lang="en">Model</com:Name>
<com:Description xml:lang="en">Name or other identifier of a model used to generate data.</com:Description>
</str:Concept>
<str:Concept id="SCENARIO">
<com:Name xml:lang="en">Scenario</com:Name>
<com:Description xml:lang="en">Name or other identifier of a specific configuration of a model.</com:Description>
</str:Concept>
</str:ConceptScheme>
<str:ConceptScheme version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="TRANSPORT_MEASURE" urn="urn:sdmx:org.sdmx.infomodel.conceptscheme.ConceptScheme=iTEM:TRANSPORT_MEASURE(0.1)">
<com:Description xml:lang="en">Concepts used as measures in transport data.</com:Description>
<str:Concept id="ACTIVITY">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">{'TYPE == passenger': '10⁹ passenger-km / yr', 'TYPE == freight': '10⁹ tonne-km / yr'}</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Transport activity</com:Name>
<com:Description xml:lang="en">Amount of travel or transport by a person, vehicle, or collection of these.</com:Description>
</str:Concept>
<str:Concept id="ENERGY">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">'PJ / yr'</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Energy</com:Name>
</str:Concept>
<str:Concept id="ENERGY_INTENSITY">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">'MJ / vehicle-km'</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Energy intensity of activity</com:Name>
</str:Concept>
<str:Concept id="EMISSION">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">{'POLLUTANT == CO2': '10⁶ t CO₂ / yr', 'POLLUTANT == GHG': '10⁶ t CO₂e / yr', 'POLLUTANT == BC': '1O³ t BC / yr', 'POLLUTANT == PM25': '1O³ t PM2.5 / yr'}</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Emission</com:Name>
<com:Description xml:lang="en">Mass of a pollutant emitted.</com:Description>
</str:Concept>
<str:Concept id="GDP">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">'10⁹ USD(2005) / year'</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Gross Domestic Product</com:Name>
</str:Concept>
<str:Concept id="LOAD_FACTOR">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">{'TYPE == PASSENGER': 'passenger / vehicle', 'TYPE == FREIGHT': 'tonne / vehicle'}</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Load factor</com:Name>
<com:Description xml:lang="en">Amount of activity provided per vehicle</com:Description>
</str:Concept>
<str:Concept id="POPULATION">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">'10⁶ persons'</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Population</com:Name>
<com:Description xml:lang="en">i.e. of people.</com:Description>
</str:Concept>
<str:Concept id="PRICE">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">{'POLLUTANT == CO2': 'USD(2005) / t CO₂', 'POLLUTANT == GHG': 'USD(2005) / t CO₂e', 'FUEL == GASOLINE': 'USD(2005) / litre', 'FUEL == DIESEL': 'USD(2005) / litre', 'FUEL == NG': 'USD(2005) / litre', 'FUEL == ELECTRICITY': 'USD(2005) / kW-h'}</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Price</com:Name>
<com:Description xml:lang="en">Market or fixed price for commodity.</com:Description>
</str:Concept>
<str:Concept id="SALES">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">'10⁶ vehicle / yr'</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Sales</com:Name>
<com:Description xml:lang="en">New sales of vehicles in a period.</com:Description>
</str:Concept>
<str:Concept id="STOCK">
<com:Annotations>
<com:Annotation id="preferred_unit">
<com:AnnotationText xml:lang="en">'10⁶ vehicle'</com:AnnotationText>
</com:Annotation>
</com:Annotations>
<com:Name xml:lang="en">Stock</com:Name>
<com:Description xml:lang="en">Quantity of transport vehicles.</com:Description>
</str:Concept>
</str:ConceptScheme>
</str:Concepts>
<str:DataStructures>
<str:DataStructure version="0.1" isExternalReference="false" isFinal="none" agencyID="iTEM" id="HISTORICAL" urn="urn:sdmx:org.sdmx.infomodel.datastructure.DataStructureDefinition=iTEM:HISTORICAL(0.1)">
<com:Description xml:lang="en">Structure of the 'unified' iTEM historical transport data. This DSD has all possible dimensions, regardless of whether a particular measure (represented in the 'VARIABLE' dimension) is relevant for that measure. In the future, the historical data will be provided via multiple data flows, each with a distinct structure that reflects the dimensions that are valid for the relevant measure(s).</com:Description>
<str:DataStructureComponents>
<str:DimensionList id="">
<str:Dimension id="TYPE">
<str:ConceptIdentity>
<Ref id="TYPE" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_TYPE" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="MODE">
<str:ConceptIdentity>
<Ref id="MODE" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_MODE" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="VEHICLE">
<str:ConceptIdentity>
<Ref id="VEHICLE" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_VEHICLE" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="FUEL">
<str:ConceptIdentity>
<Ref id="FUEL" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_FUEL" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="TECHNOLOGY">
<str:ConceptIdentity>
<Ref id="TECHNOLOGY" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
</str:Dimension>
<str:Dimension id="AUTOMATION">
<str:ConceptIdentity>
<Ref id="AUTOMATION" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_AUTOMATION" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="OPERATOR">
<str:ConceptIdentity>
<Ref id="OPERATOR" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_OPERATOR" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="POLLUTANT">
<str:ConceptIdentity>
<Ref id="POLLUTANT" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_POLLUTANT" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="LCA_SCOPE">
<str:ConceptIdentity>
<Ref id="LCA_SCOPE" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_LCA_SCOPE" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:Dimension id="FLEET">
<str:ConceptIdentity>
<Ref id="FLEET" maintainableParentID="TRANSPORT" maintainableParentVersion="0.1" agencyID="iTEM" version="0.1" package="conceptscheme" class="Concept"/>
</str:ConceptIdentity>
<str:LocalRepresentation>
<str:Enumeration>
<Ref id="CL_FLEET" agencyID="iTEM" version="0.1" package="codelist" class="Codelist"/>
</str:Enumeration>
</str:LocalRepresentation>
</str:Dimension>
<str:MeasureDimension id="VARIABLE"/>
</str:DimensionList>
<str:AttributeList id=""/>
<str:MeasureList id=""/>
</str:DataStructureComponents>
</str:DataStructure>
</str:DataStructures>
</mes:Structures>
</mes:Structure>