Add data descriptions for materials & transport

message_ix_models/data/edits/transport-materials-0.yaml

@@ -0,0 +1,124 @@
+format: 1
+
+title: Materials + transport representation in MESSAGEix
+description: |-
+  These are the data required to parametrize a representation of materials use
+  in the transport sector, i.e. the integration of MESSAGEix-Materials and
+  MESSAGEix-Transport.
+
+provider:
+  organisation: International Institute for Applied Systems Analysis (IIASA)
+  contact: [email protected]; [email protected]; [email protected]
+
+classifiers:
+- "Kind :: Model input"
+
+dimension:
+  time:
+    scope: 1990 to 2100
+    resolution: 5- or 10-year periods or annual
+    description: >-
+      Up until 2022, data reflect real-world measurements. From 2022 (or other
+      start year) onwards, data are projections.
+  space:
+    scope: global
+    resolution: country or vehicle market/manufacturing region.
+    description: It would be best if the Chinese data could be included.
+  vehicle_type:
+    scope: all classification of vehicles
+    resolution: : >-
+      3-point scale: Passenger LDV, bus, truck
+    description: >-
+      More detailed classification of the above 3 types is welcomed, e.g.
+      separating size classes of LDVs (cars, small or large; SUVs, etc.),
+      trucks, etc.
+  make_model:
+    scope: any available
+    resolution: any specific make and model
+    description: >-
+      Specific manufacturer and model of vehicle.
+  fuel_type:
+    scope: all classification of vehicles by the fuel & technology they use
+    resolution: : >-
+      10-point scale: gasoline, diesel, electricity, hydrogen,
+      compressed natural gas, liquefied natural gas, coal-derived methanol,
+      bio-diesel, coal-to-liquids, bio-ethanol
+    description: >-
+      Not all fuel types are necessarily included for each specific model.
+      Materials intensities of specific components may be the same across
+      different fuel_type if these components are essentially the same.
+  powertrain_type:
+    scope: all classification of vehicles by the powertrain
+    resolution: ICE, PHEV, BEV, etc.
+    description: Different fuel_type may eventually correspond to one powertrain_type
+  material_type:
+    scope: all common materials used in vehicles
+    resolution: : >-
+      14-point scale: steel, copper, aluminum, lithium, cobalt, nickel,
+      neodymium, dysprosium, platinum, plastics, composite material, coal, crude oil, natural gas.
+    description: >-
+      Other material can also be added depend on the available data.
+  component:
+    scope: all major components in vehicles
+    resolution: : >-
+      7-point scale: body structure, wheels and tires, chassis,
+      powertrain system, energy storage battery, hydrogen on-board storage,
+      fuel cell
+    description: >-
+      Vehicles of a particular type and fuel type do not have to contain all of
+      the above components, e.g. “hydrogen on-board storage” is not relevant for
+      “electric vehicle”.
+
+measure:
+  material_intensity_1:
+    description: >-
+      Mass of a given material required for one unit of component production defined by 
+      vehicle_type and powertrain_type.
+
+  material_intensity_2:
+    description: >-
+      Mass of a given material required for one unit of component production defined by 
+      make_model.
+
+  material_intensity_energy:
+    description: >-
+      Mass of upstream materials required to provide different
+      types of fuels used in vehicles.
+
+  sales:
+    description: >-
+      Vehicle sales for certain make_model.
+
+
+quantity:
+- measure: material_intensity_1
+  dimensions: [time, space, vehicle_type, powertrain_type, material_type, component]
+  units: tons per vehicle
+  description: >-
+    With these dimensions, this data captures the material intensity of major
+    components of certain vehicle type and powertrain type.
+    If a vehicle includes more than one of a certain component, then this is
+    the total across the components in a single vehicle.
+
+- measure: material_intensity_2
+  dimensions: [time, space, make_model, material_type, component]
+  units: tons per unit component
+  description: >-
+    With these dimensions, this data captures the material intensity of major
+    components of certain make_model.
+    If a vehicle includes more than one of a certain component, then this is
+    the total across the components in a single vehicle.
+
+- measure: material_intensity_energy
+  dimensions: [time, space, fuel_type, material_type]
+  units: tons per unit energy
+  description: >-
+    This captures the upstream requirements for materials to provide different
+    types of fuels used in vehicles.
+
+- measure: sales
+  dimensions: [time, space, make_model]
+  units: vehicles per year
+  description: >-
+    This would be used to calculate a sales-weighted average across materials
+    intensities that are specific to different make_model.

message_ix_models/data/edits/transport-materials.yaml

@@ -0,0 +1,22 @@
+format: 1
+
+title: Materials + transport representation in MESSAGEix
+description: |-
+  These are the data required to parametrize a representation of materials use
+  in the transport sector, i.e. the integration of MESSAGEix-Materials and
+  MESSAGEix-Transport.
+
+provider:
+  organisation: International Institute for Applied Systems Analysis (IIASA)
+  contact: [email protected]; [email protected]; [email protected]
+
+classifiers:
+- "Kind :: Model input"
+
+dimension:
+  time: {}
+  space: {}
+
+measure: {}
+
+quantity: []

message_ix_models/data/edits/transport-materials_LU.yaml

@@ -0,0 +1,78 @@
+format: 1
+
+title: Materials + transport representation in MESSAGEix
+description: |-
+  These are the data required to parametrize a representation of materials use
+  in the transport sector, i.e. the integration of MESSAGEix-Materials and
+  MESSAGEix-Transport.
+provider:
+  organisation: International Institute for Applied Systems Analysis (IIASA)
+  contact: [email protected]; [email protected]; [email protected]
+
+classifiers:
+- "Kind :: Model input"
+
+dimension:
+  time: 
+    scope: 1990 to 2100
+    resolution: 5- or 10-year periods
+    description: |-
+      Historical data (1990-2020) + projections. This is aligned with XM's approach.
+      In this case, from 1990 to 2010 the additions, capacity etc., will be 0
+      due to the lack of EVs and PHEVs in the fleet. Data from 2010 to 2020 based on 
+      historical yearly statistics. 
+  space: 
+    scope: global
+    resolution: R11
+    description: |-
+      See https://docs.messageix.org/projects/models2/en/latest/pkg-data/node.html
+      or https://github.com/iiasa/message-ix-models/blob/main/message_ix_models/data/node/R11.yaml 
+  powertrain_type:
+    scope: All powertrain technologies  
+    resolution: Powertrain technologies included in MESSAGEix (ICEV,BEV,PHEV,FCEV) 
+    description: |-
+      Even though for this analysis only PHEV and BEVs are relevant, 
+      we should probably take into account all powertrain technologies
+  battery_technology: 
+    scope: BEVs and PHEVs
+    description: Battery technology/chemistry that can be used by electric vehicles
+    resolution: |-
+      Three families of battery chemistries for current fleet of vehicles (NCA, NMC, LFP)
+      Possibly, think about two battery chemistries that may be used in the future. Candidates:
+        - Li-air
+        - Li-S 
+  vehicle_segment: 
+    scope: size of ELDVs
+    description: The vehicle class , which will affect the battery size 
+    resolution: |-
+      Confirm with Paul which vehicle segments are available in MESSAGEix-Transport
+      I suppose: micro, medium, SUV. I might be wrong. To each vehicle segment
+      a given battery size has to be assigned, based on current real fleet data
+      and then projected until 2050
+  material_type: 
+    scope: Relevant materials used in Li-ion batteries
+    resolution: |-
+      4-point scale: Lithium, Cobalt, Nickel, Graphite. These are the 4 materials
+      of interest, however it may be necessary to include also copper, since in one pathway
+      Co is a by-product of Cu extraction. 
+
+measure: 
+  battery_size:
+    description: size of battery per vehicle segment and battery technology
+material_intensity:
+  description: Amount of material required per kWh of storage capacity in each battery type
+
+quantity:
+- measure: battery_size
+  dimensions: [time,space,powertrain_type,vehicle segment]
+  units: kWh
+  description: |-
+    Size of the battery, measured in kWh, for a given combination of powertrain technology
+    and vehicle size.
+
+- measure: material_intensity
+  dimensions: [time, battery_technology, material_type]
+  units: kg/kWh
+  description: |- 
+    This captures the material intensity (Li,Co,Ni,C) of the different battery technologies 
+    analysed per kWh of storage capacity.