cafein.lca 0.1.0__tar.gz

cafein_lca-0.1.0/.coveragerc

@@ -0,0 +1,6 @@
+[run]
+branch = true
+source = cafein.lca
+
+[report]
+show_missing = true

cafein_lca-0.1.0/.flake8

@@ -0,0 +1,4 @@
+[flake8]
+max-line-length = 88
+extend-ignore = E203
+exclude = .git,__pycache__,build,dist,docs

cafein_lca-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+plans/
+__pycache__/
+*.egg-info/
+dist/
+build/
+cache/
+docs/_build/
+docs/generated/
+
+
+CLAUDE.md
+.DS_Store
+# local working files
+resource-docs/
+scripts/extract_workbook.py

cafein_lca-0.1.0/.zenodo.json

@@ -0,0 +1,26 @@
+{
+    "title": "cafein.lca: Life-cycle assessment of urban passenger transport in Python",
+    "description": "Life-cycle energy use and greenhouse-gas emissions per passenger-km, vehicle-km and vehicle for 56 urban transport modes, decomposed into manufacturing, delivery, use, operational services and infrastructure. The calculation model and default coefficients are adapted from the life-cycle assessment model published by the International Transport Forum with Cazzola & Crist (2020), 'Good to Go? Assessing the Environmental Performance of New Mobility'. This library is an adaptation of an original work by the OECD/ITF; the opinions expressed and arguments employed in it should not be reported as representing the official views of the OECD or of its Member countries.",
+    "license": "MIT",
+    "upload_type": "software",
+    "creators": [
+        {
+            "name": "Tenkanen, Henrikki",
+            "affiliation": "Aalto University"
+        }
+    ],
+    "keywords": [
+        "life-cycle assessment",
+        "transport",
+        "shared mobility",
+        "micromobility",
+        "GHG emissions"
+    ],
+    "related_identifiers": [
+        {
+            "identifier": "https://www.itf-oecd.org/good-go-assessing-environmental-performance-new-mobility",
+            "relation": "isDerivedFrom",
+            "scheme": "url"
+        }
+    ]
+}

cafein_lca-0.1.0/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+## 0.1.0 (2026-09-09)
+
+NEW
+
+- Initial release: the ITF "Good to go?" (Cazzola & Crist 2020) urban
+  transport LCA model as a Python library.
+- 56 transport modes with typed, immutable scenario parameters
+  (`cafein.lca.mode()` + `.replace()`, or keyword overrides on
+  `TransportLCA.calculate()`).
+- Session-level electricity generation mix: packaged region presets from the
+  workbook plus fully custom mixes; propagates to use phase, hydrogen
+  electrolysis and shared-fleet servicing vehicles.
+- Scenario bundles: `Scenario.load()` reads a TOML file of per-mode
+  parameter overrides plus an electricity mix, with `best`/`central`/`worst`
+  cases, and `TransportLCA(scenario=...)` applies it to every mode.
+- Scenario values carry provenance (evidence type, geography, source,
+  confidence, note), validated on load and exposed by
+  `Scenario.provenance()`.
+- Packaged scenarios `india_metropolitan` (Delhi/Mumbai operating
+  conditions, provenance per value) and `finland_2020` (electricity mix),
+  listed by `list_scenarios()`; tutorial page.
+- Results per pkm/vkm/vehicle decomposed into the five life-cycle
+  components, as pandas objects; `TransportLCA.summary()` for all modes.
+- Optional `cafein` extra (`pip install cafein.lca[cafein]`) pinning cafein
+  0.25.0, for use alongside the cafein routing package; the core install
+  stays dependency-light.
+- Export helpers `TransportLCA.transit_factors()` and `.street_factors()`
+  return cafein-ready factor tables: the mode's four life-cycle components
+  (vehicle, fuel, infrastructure, operations), their `total`, an explicit
+  per-passenger-km or per-vehicle-km `basis`, and scenario provenance, for
+  use with the `cafein` routing package through `factors=`. `Scenario`
+  records its `name` and file `sha256` for that provenance. cafein 0.25.0
+  keeps the `total` column without warning and computes from the components.
+- Named coefficient sets: the packaged tables are the set `itf-2020` under
+  `cafein/lca/data/itf-2020/` with a `manifest.toml`.
+  `TransportLCA(coefficients=...)` selects a set (default `itf-2020`, else a
+  scenario file's `coefficients` key), `available_coefficient_sets()` lists
+  the packaged sets, and `Result.coefficient_set` records which set produced
+  a result. 0.1.0 ships one set.
+
+TESTS
+
+- Golden-master suite: all 128 reproducible workbook columns match the
+  published workbook within 1e-9 relative tolerance (56 canonical modes,
+  48 sensitivity variants expressed as parameter overrides, 24 as column
+  fixtures).
+- Acceptance test reproducing the repository's Finland-2020 GHG/pkm table.
+- Formula-deviation audit of the workbook documented in
+  docs/workbook-audit.md.
+- Integration job installing `cafein.lca[cafein]` and checking that
+  cafein.lca coexists with the cafein routing package under the shared
+  namespace; skipped when cafein is not installed.
+- Export-helper tests: `tests/test_export.py` covers the schema, the 5->4
+  component mapping, the basis rule and provenance; the cafein round-trip in
+  `tests/test_integration.py` checks cafein loads the exported tables and
+  honours their `basis`.

cafein_lca-0.1.0/CITATION.cff

@@ -0,0 +1,29 @@
+cff-version: 1.2.0
+message: >-
+  If you use this software, please cite both the software and the underlying
+  model (Cazzola & Crist 2020).
+type: software
+title: "cafein.lca: Life-cycle assessment of urban passenger transport in Python"
+authors:
+  - family-names: Tenkanen
+    given-names: Henrikki
+    affiliation: Aalto University
+license: MIT
+repository-code: "https://github.com/cafein-py/cafein.lca"
+keywords:
+  - life-cycle assessment
+  - transport
+  - shared mobility
+  - GHG emissions
+references:
+  - type: report
+    title: "Good to Go? Assessing the Environmental Performance of New Mobility"
+    authors:
+      - family-names: Cazzola
+        given-names: Pierpaolo
+      - family-names: Crist
+        given-names: Philippe
+    year: 2020
+    institution:
+      name: International Transport Forum
+    url: "https://www.itf-oecd.org/good-go-assessing-environmental-performance-new-mobility"

cafein_lca-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 Henrikki Tenkanen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+The datasets packaged under cafein/lca/data/ are extracted from the
+International Transport Forum workbook accompanying Cazzola, P. and P. Crist
+(2020), "Good to Go? Assessing the Environmental Performance of New Mobility"
+(© OECD/ITF 2020) and are used and adapted with citation under the OECD terms
+and conditions; several coefficients derive from Argonne National
+Laboratory's GREET model.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cafein_lca-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.5
+Name: cafein.lca
+Version: 0.1.0
+Summary: Life-cycle assessment of urban passenger transport in Python
+Project-URL: Homepage, https://github.com/cafein-py/cafein.lca
+Project-URL: Documentation, https://cafein-lca.readthedocs.io
+Project-URL: Repository, https://github.com/cafein-py/cafein.lca
+Project-URL: Issue Tracker, https://github.com/cafein-py/cafein.lca/issues
+Project-URL: Changelog, https://github.com/cafein-py/cafein.lca/blob/main/CHANGELOG.md
+Author-email: Henrikki Tenkanen <henrikki.tenkanen@aalto.fi>
+License: MIT
+License-File: LICENSE
+Keywords: GHG emissions,LCA,cafein,life-cycle assessment,micromobility,mobility,ridesourcing,shared mobility,transport
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=1.5
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Provides-Extra: cafein
+Requires-Dist: cafein==0.25.0; extra == 'cafein'
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: flake8; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: matplotlib; extra == 'docs'
+Requires-Dist: myst-nb; extra == 'docs'
+Requires-Dist: sphinx; extra == 'docs'
+Requires-Dist: sphinx-book-theme==1.2.0; extra == 'docs'
+Requires-Dist: sphinx-design; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# cafein.lca
+
+**Life-cycle assessment of urban passenger transport in Python.**
+
+`cafein.lca` computes life-cycle energy use and greenhouse-gas emissions
+of urban transport modes per passenger-km and per vehicle-km, decomposed
+into vehicle and battery manufacturing, delivery, use, the servicing of
+shared fleets, and infrastructure; the first four are also available per
+vehicle. It covers 56 modes, from
+private e-scooters to metro trains. The main assumptions behind a result
+are named parameters (electricity mix, vehicle lifetime, mileage,
+occupancy, battery size, servicing logistics), while the per-mode
+technical data and the shared coefficient tables ship as packaged data.
+
+The calculation is a standard attributional life-cycle assessment. The
+default coefficient set, `itf-2020`, is extracted from the International
+Transport Forum's *Good to Go?* study (see the attribution below) and is
+held to that source by the test suite; `TransportLCA(coefficients=...)`
+names the set, so later sets can coexist. Regional scenarios replace selected
+assumptions, such as occupancy, lifetimes and mileage, with sourced local
+values while the remaining defaults stay in force; each scenario carries
+best, central and worst cases with the evidence and source behind every
+value, and an Indian metropolitan scenario is packaged.
+
+`cafein.lca` is part of the [cafein](https://github.com/cafein-py) family
+of packages. It installs and runs on its own and does not require the
+`cafein` core package.
+
+## Installation
+
+Until the first release is on PyPI, install from the repository:
+
+```
+pip install git+https://github.com/cafein-py/cafein.lca.git
+```
+
+Once 0.1.0 is released, `pip install cafein.lca` will do the same.
+
+## Example
+
+A session holds the electricity mix, and a calculation returns the
+result for one mode. This computes the life-cycle emissions of a
+battery-electric car on the EU 28 grid, in g CO₂e per passenger-km:
+
+```python
+from cafein.lca import TransportLCA
+
+lca = TransportLCA(power_mix="EU 28")
+car = lca.calculate("private_car_bev")
+round(car.ghg_per_pkm, 1)
+```
+
+That number is the whole-life total; `car.per_pkm` breaks it into the
+five components, and `lca.summary()` runs every mode at once. Changing
+assumptions, custom electricity mixes and scenarios are covered in the
+documentation below.
+
+## Documentation
+
+The documentation at https://cafein-lca.readthedocs.io covers:
+
+- [Getting started](https://cafein-lca.readthedocs.io/en/latest/getting_started/installation.html):
+  installation and a first calculation.
+- [User guide](https://cafein-lca.readthedocs.io/en/latest/user_guide/reading_results.html):
+  reading results, modes and parameters, the electricity mix, sensitivity
+  analysis.
+- [Scenarios](https://cafein-lca.readthedocs.io/en/latest/scenarios/scenarios.html):
+  reusable, evidence-tagged assumption bundles.
+- [The model](https://cafein-lca.readthedocs.io/en/latest/model/model.html):
+  scope, stages, normalisation, provenance of the coefficients, and the
+  [audit](docs/model/workbook_audit.md) of the source model.
+- [API reference](https://cafein-lca.readthedocs.io/en/latest/reference.html).
+
+## Related tools
+
+- **[carculator](https://github.com/romainsacchi/carculator)** (Paul Scherrer
+  Institut) and its siblings provide fully parameterised vehicle LCA over
+  ecoinvent-style background databases, with many midpoint indicators,
+  prospective scenarios and Monte Carlo. `cafein.lca` instead packages its
+  own coefficients for greenhouse gas and energy only, and covers the
+  mobility-services layer that vehicle LCAs usually omit: servicing of
+  shared fleets, deadheading of taxis and ridesourcing, and infrastructure
+  for every mode.
+- **Brightway2 / lca_algebraic** — general LCA frameworks; this library
+  deliberately stays a lightweight domain model on plain pandas.
+
+## Data attribution and license
+
+The Python code is MIT-licensed. The packaged datasets are extracted from the
+ITF workbook © OECD/ITF 2020, used and adapted with citation under the OECD
+terms and conditions; several coefficients within it derive from Argonne
+National Laboratory's [GREET](https://greet.anl.gov/) model. This is an
+adaptation of OECD/ITF work and is not endorsed by the OECD. Cite the
+original work when using the numbers:
+
+> Cazzola, P. and P. Crist (2020), *Good to Go? Assessing the Environmental
+> Performance of New Mobility*, International Transport Forum, Paris.
+> https://www.itf-oecd.org/good-go-assessing-environmental-performance-new-mobility

cafein_lca-0.1.0/README.md

@@ -0,0 +1,98 @@
+# cafein.lca
+
+**Life-cycle assessment of urban passenger transport in Python.**
+
+`cafein.lca` computes life-cycle energy use and greenhouse-gas emissions
+of urban transport modes per passenger-km and per vehicle-km, decomposed
+into vehicle and battery manufacturing, delivery, use, the servicing of
+shared fleets, and infrastructure; the first four are also available per
+vehicle. It covers 56 modes, from
+private e-scooters to metro trains. The main assumptions behind a result
+are named parameters (electricity mix, vehicle lifetime, mileage,
+occupancy, battery size, servicing logistics), while the per-mode
+technical data and the shared coefficient tables ship as packaged data.
+
+The calculation is a standard attributional life-cycle assessment. The
+default coefficient set, `itf-2020`, is extracted from the International
+Transport Forum's *Good to Go?* study (see the attribution below) and is
+held to that source by the test suite; `TransportLCA(coefficients=...)`
+names the set, so later sets can coexist. Regional scenarios replace selected
+assumptions, such as occupancy, lifetimes and mileage, with sourced local
+values while the remaining defaults stay in force; each scenario carries
+best, central and worst cases with the evidence and source behind every
+value, and an Indian metropolitan scenario is packaged.
+
+`cafein.lca` is part of the [cafein](https://github.com/cafein-py) family
+of packages. It installs and runs on its own and does not require the
+`cafein` core package.
+
+## Installation
+
+Until the first release is on PyPI, install from the repository:
+
+```
+pip install git+https://github.com/cafein-py/cafein.lca.git
+```
+
+Once 0.1.0 is released, `pip install cafein.lca` will do the same.
+
+## Example
+
+A session holds the electricity mix, and a calculation returns the
+result for one mode. This computes the life-cycle emissions of a
+battery-electric car on the EU 28 grid, in g CO₂e per passenger-km:
+
+```python
+from cafein.lca import TransportLCA
+
+lca = TransportLCA(power_mix="EU 28")
+car = lca.calculate("private_car_bev")
+round(car.ghg_per_pkm, 1)
+```
+
+That number is the whole-life total; `car.per_pkm` breaks it into the
+five components, and `lca.summary()` runs every mode at once. Changing
+assumptions, custom electricity mixes and scenarios are covered in the
+documentation below.
+
+## Documentation
+
+The documentation at https://cafein-lca.readthedocs.io covers:
+
+- [Getting started](https://cafein-lca.readthedocs.io/en/latest/getting_started/installation.html):
+  installation and a first calculation.
+- [User guide](https://cafein-lca.readthedocs.io/en/latest/user_guide/reading_results.html):
+  reading results, modes and parameters, the electricity mix, sensitivity
+  analysis.
+- [Scenarios](https://cafein-lca.readthedocs.io/en/latest/scenarios/scenarios.html):
+  reusable, evidence-tagged assumption bundles.
+- [The model](https://cafein-lca.readthedocs.io/en/latest/model/model.html):
+  scope, stages, normalisation, provenance of the coefficients, and the
+  [audit](docs/model/workbook_audit.md) of the source model.
+- [API reference](https://cafein-lca.readthedocs.io/en/latest/reference.html).
+
+## Related tools
+
+- **[carculator](https://github.com/romainsacchi/carculator)** (Paul Scherrer
+  Institut) and its siblings provide fully parameterised vehicle LCA over
+  ecoinvent-style background databases, with many midpoint indicators,
+  prospective scenarios and Monte Carlo. `cafein.lca` instead packages its
+  own coefficients for greenhouse gas and energy only, and covers the
+  mobility-services layer that vehicle LCAs usually omit: servicing of
+  shared fleets, deadheading of taxis and ridesourcing, and infrastructure
+  for every mode.
+- **Brightway2 / lca_algebraic** — general LCA frameworks; this library
+  deliberately stays a lightweight domain model on plain pandas.
+
+## Data attribution and license
+
+The Python code is MIT-licensed. The packaged datasets are extracted from the
+ITF workbook © OECD/ITF 2020, used and adapted with citation under the OECD
+terms and conditions; several coefficients within it derive from Argonne
+National Laboratory's [GREET](https://greet.anl.gov/) model. This is an
+adaptation of OECD/ITF work and is not endorsed by the OECD. Cite the
+original work when using the numbers:
+
+> Cazzola, P. and P. Crist (2020), *Good to Go? Assessing the Environmental
+> Performance of New Mobility*, International Transport Forum, Paris.
+> https://www.itf-oecd.org/good-go-assessing-environmental-performance-new-mobility

cafein_lca-0.1.0/RELEASING.md

@@ -0,0 +1,19 @@
+# Releasing
+
+1. Update `CHANGELOG.md`: move the unreleased items under the new version
+   heading with the release date.
+2. Set the version in `pyproject.toml` and `cafein/lca/__init__.py`
+   (`__version__`) — they must match the tag.
+3. Commit, push, and wait for CI to go green on the full matrix.
+4. Dry run: trigger the *Release* workflow manually (`workflow_dispatch`) —
+   it runs tests and builds the sdist/wheel without publishing.
+5. Tag and push: `git tag v0.1.0 && git push origin v0.1.0`. The tag-driven
+   run tests, checks the tag against the package version, builds, publishes
+   to PyPI via Trusted Publishing (OIDC; the `pypi` environment must be
+   configured in the repo settings and the project registered as a trusted
+   publisher on PyPI), and creates the GitHub release.
+6. Post-release: bump to the next `.dev0` version; check the Zenodo record
+   (if the GitHub–Zenodo integration is enabled, the release is archived
+   automatically using `.zenodo.json`).
+7. conda-forge: after the first PyPI release, submit a feedstock to
+   conda-forge/staged-recipes.

cafein_lca-0.1.0/cafein/lca/__init__.py

@@ -0,0 +1,23 @@
+"""cafein.lca: Life-cycle assessment of urban passenger transport in Python.
+
+Adapted from the life-cycle assessment model published with Cazzola & Crist
+(2020), "Good to Go? Assessing the Environmental Performance of New
+Mobility", International Transport Forum, Paris.
+"""
+
+from .config import available_coefficient_sets
+from .lca import TransportLCA
+from .modes import list_modes, mode
+from .scenarios import Scenario, list_scenarios
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "TransportLCA",
+    "Scenario",
+    "list_scenarios",
+    "available_coefficient_sets",
+    "mode",
+    "list_modes",
+    "__version__",
+]

cafein_lca-0.1.0/cafein/lca/config.py

@@ -0,0 +1,187 @@
+"""Packaged assumption datasets (the environment layer of the model).
+
+Loads the CSVs of a named coefficient set under ``cafein/lca/data/<set>/``
+(extracted from the ITF workbook by ``scripts/extract_workbook.py``) into
+plain dictionaries, lazily and once. The default set is ``itf-2020``.
+"""
+
+import csv
+import functools
+import pathlib
+
+DATA_DIR = pathlib.Path(__file__).parent / "data"
+
+#: The default coefficient set; its directory under ``DATA_DIR`` holds the
+#: environment tables and ``modes.csv`` plus a ``manifest.toml``.
+DEFAULT_COEFFICIENTS = "itf-2020"
+
+#: Directory of the coefficient set the module-level ``conf`` reads from.
+COEFFICIENTS_DIR = DATA_DIR / DEFAULT_COEFFICIENTS
+
+
+def available_coefficient_sets():
+    """Names of the coefficient sets packaged under ``DATA_DIR``.
+
+    A set is a directory holding a ``manifest.toml`` (so ``scenarios/`` is not
+    one).
+    """
+    return sorted(d.name for d in DATA_DIR.iterdir() if (d / "manifest.toml").is_file())
+
+
+POWER_SOURCES = ["oil", "natural_gas", "coal", "nuclear", "biomass", "other_renewables"]
+MATERIALS = [
+    "steel",
+    "stainless_steel",
+    "cast_iron",
+    "wrought_aluminum",
+    "cast_aluminum",
+    "copper_brass",
+    "glass",
+    "plastics",
+    "carbon_fiber",
+    "rubber",
+    "others",
+]
+DELIVERY_LEGS = [
+    "air",
+    "ship",
+    "train_a",
+    "train_b",
+    "heavy_truck_a",
+    "heavy_truck_b",
+    "medium_truck_a",
+    "medium_truck_b",
+    "van_a",
+    "van_b",
+]
+
+# 0_Total R12 / 1_Manufacturing helper row 37 region labels -> CSV suffix.
+PRODUCTION_REGIONS = {
+    "With Al smelting mostly form coal": "coal_al",
+    "Default": "default",
+}
+
+
+def _read(name):
+    with open(COEFFICIENTS_DIR / name, newline="") as f:
+        return list(csv.DictReader(f))
+
+
+def _num(value):
+    if value in (None, ""):
+        return 0.0
+    return float(value)
+
+
+class _Conf:
+    """Namespace of packaged datasets, loaded on first attribute access."""
+
+    @functools.cached_property
+    def power_mix_catalog(self):
+        return {
+            r["region"]: [_num(r[s]) for s in POWER_SOURCES]
+            for r in _read("power_gen_mix.csv")
+        }
+
+    @functools.cached_property
+    def electricity_pathways(self):
+        rows = _read("electricity_pathways.csv")
+        return {
+            "wtt_energy_factor": [_num(r["wtt_energy_factor"]) for r in rows],
+            "ghg_g_per_kwh": [_num(r["ghg_g_per_kwh"]) for r in rows],
+        }
+
+    @functools.cached_property
+    def fuel_wtt_energy(self):
+        return {
+            r["fuel"]: _num(r["wtt_energy_factor"])
+            for r in _read("fuel_wtt_energy.csv")
+        }
+
+    @functools.cached_property
+    def fuel_ghg(self):
+        return {r["fuel"]: _num(r["ghg_wtw_g_per_l"]) for r in _read("fuel_ghg.csv")}
+
+    @functools.cached_property
+    def hydrogen_pathways(self):
+        rows = _read("hydrogen_pathways.csv")
+        named = {
+            r["pathway"]: (_num(r["wtt_energy_factor"]), _num(r["ghg_g_per_mj"]))
+            for r in rows
+        }
+        # Rows 2-7 of the workbook table are the per-power-source electrolysis
+        # factors, in POWER_SOURCES order (3_Use R29/R33 SUMPRODUCT).
+        per_source = rows[1:7]
+        return {
+            "named": named,
+            "electrolysis_energy": [_num(r["wtt_energy_factor"]) for r in per_source],
+            "electrolysis_ghg": [_num(r["ghg_g_per_mj"]) for r in per_source],
+        }
+
+    @functools.cached_property
+    def material_intensities(self):
+        return {r["material"]: r for r in _read("material_intensities.csv")}
+
+    @functools.cached_property
+    def assembly_disposal(self):
+        return {r["step"]: r for r in _read("assembly_disposal_intensities.csv")}
+
+    @functools.cached_property
+    def battery_chemistries(self):
+        return {r["chemistry"]: r for r in _read("battery_chemistries.csv")}
+
+    @functools.cached_property
+    def delivery_legs(self):
+        rows = {r["leg"]: r for r in _read("delivery_legs.csv")}
+        return {
+            "energy_mj_per_tkm": [
+                _num(rows[leg]["energy_mj_per_tkm"]) for leg in DELIVERY_LEGS
+            ],
+            "ghg_g_per_mj": [_num(rows[leg]["ghg_g_per_mj"]) for leg in DELIVERY_LEGS],
+        }
+
+    @functools.cached_property
+    def service_vehicles(self):
+        return {
+            r["vehicle"]: {
+                "fuel_mj_per_km": _num(r["fuel_mj_per_km"]),
+                "electricity_mj_per_km": _num(r["electricity_mj_per_km"]),
+                "fuel": r["fuel"],
+                "electric_share": _num(r["electric_share"]),
+                "low_carbon_electricity": r["low_carbon_electricity"] == "1",
+                "energy_mj_per_km_world": _num(r["energy_mj_per_km_world"]),
+                "ghg_g_per_km_world": _num(r["ghg_g_per_km_world"]),
+            }
+            for r in _read("service_vehicles.csv")
+        }
+
+    @functools.cached_property
+    def fuel_ghg_ttw(self):
+        return {r["fuel"]: _num(r["ghg_ttw_g_per_l"]) for r in _read("fuel_ghg.csv")}
+
+    @functools.cached_property
+    def infrastructure_types(self):
+        return {r["infrastructure"]: r for r in _read("infrastructure_types.csv")}
+
+    @functools.cached_property
+    def constants(self):
+        return {r["name"]: r["value"] for r in _read("constants.csv")}
+
+    def constant(self, name):
+        return float(self.constants[name])
+
+    def material_intensity(self, material, production_region, metric):
+        """Energy [MJ/kg] or GHG [g/kg] of material production (1_Mfg R38-51,
+        R86-99)."""
+        suffix = PRODUCTION_REGIONS[production_region]
+        unit = "mj_per_kg" if metric == "energy" else "g_per_kg"
+        return _num(self.material_intensities[material][f"{metric}_{unit}_{suffix}"])
+
+    def assembly_disposal_intensity(self, step, production_region, metric):
+        """Vehicle assembly/disposal intensity per kg (1_Mfg R55-56/R103-104)."""
+        suffix = PRODUCTION_REGIONS[production_region]
+        unit = "mj_per_kg" if metric == "energy" else "g_per_kg"
+        return _num(self.assembly_disposal[step][f"{metric}_{unit}_{suffix}"])
+
+
+conf = _Conf()

cafein_lca-0.1.0/cafein/lca/data/itf-2020/assembly_disposal_intensities.csv

@@ -0,0 +1,3 @@
+step,energy_mj_per_kg_coal_al,energy_mj_per_kg_default,ghg_g_per_kg_coal_al,ghg_g_per_kg_default
+assembly,8.224625841912632,8.224625841912632,538.6328307374549,538.6328307374549
+disposal,2.265756636805004,2.265756636805004,153.35318310942364,153.35318310942364

cafein_lca-0.1.0/cafein/lca/data/itf-2020/battery_chemistries.csv

@@ -0,0 +1,10 @@
+chemistry,specific_energy_kwh_per_kg,mfg_energy_mmbtu_coal_al,mfg_energy_mmbtu_default,mfg_ghg_g_coal_al,mfg_ghg_g_default
+LMO,0.12123932196229183,17.550913251476587,14.53187694051551,1473442.404116315,982470.2863481897
+NMC111,0.14262303541417382,26.534854451874825,23.515818140913748,2102479.095876358,1611506.9781082333
+LFP: hydrothermal,0.1159133798267138,18.38705948608153,15.368023175120452,1498720.0654745686,1007747.9477064431
+LFP: solid state,0.1159133798267138,17.23866559275126,14.219629281790183,1426779.775985455,935807.6582173294
+NMC622,0.15504780647427463,26.682490257730674,23.663453946769597,2109288.564353485,1618316.4465853602
+NMC811,0.14922041422599697,26.986728378511966,23.96769206755089,2108573.3561928202,1617601.2384246956
+LMR-NMC:Gr,0.175,20.70821432697536,17.689178016014278,1715155.7425372568,1224183.6247691314
+LMR-NMC:Gr-SI,0.2,20.70821432697536,17.689178016014278,1715155.7425372568,1224183.6247691314
+NCA,0.15857163037285157,27.979802847890866,24.96076653692979,2174508.7671961817,1683536.649428057