Generic EPD Aggregator

Features

• Parse ILCD process and flow XMLs
• Normalize material properties and LCIA modules
• Aggregate impacts and compute weighted averages
• Write new ILCD XML datasets

Installation

Install via PyPI:

pip install materia-epd

Requires Python 3.10+.

Documentation

Full documentation is hosted on Read the Docs.

It covers the EPD pipeline, module reference, contributing guidelines, and the changelog.

Usage

Run the aggregator

python -m materia_epd <generic_processes_dir> <epd_processes_dir> -o <output_dir> -v

Note that you need to point to the root processes folders and need to provide a matches folder in the generic data folder to link generic products and EPDs. Add the flag --v or -v for verbosity. Logs files with details will be automatically created in <output_dir>.

Run for specific processes only

By default, the pipeline runs for all processes with defined matches. To run only for specific processes, provide a JSON file containing an array of UUIDs via the --process-list or -p option:

python -m materia_epd <generic_processes_dir> <epd_processes_dir> -p process_list.json -o <output_dir>

Example process_list.json:

[
  "8a3b1c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p",
  "2d4e6f8a-9b1c-2d3e-4f5g-6h7i8j9k0l1m"
]

The <generic_processes_dir> folder should be structured like this:

<generic_process_dir>
├── flows
│   ├── <flow-uuid-1>.xml   # Reference flow of generic-uuid-1
│   ├── <flow-uuid-2>.xml
│   └── ...
├── matches
│   ├── <generic-uuid-1>.json   # Source EPDs for generic-uuid-1
│   ├── <generic-uuid-2>.json
│   └── ...
├── PDFs
├── processes
│   ├── <generic-uuid-1>.xml   # Skeleton process for generic-uuid-1
│   ├── <generic-uuid-2>.xml
│   └── ...
└── templates
    ├── GenPro_template.xml # Template with the EPD schema
    └── GenRef_template.xml # Template with the flow schema

Source EPDs (<epd_processes_dir>)

<epd_process_dir>
├── flows       # Reference flows for all source EPDs
└── processes   # All potential source EPD process XMLs

Matches JSON

Files in matches/ are named after the corresponding generic product UUID:

{
  "type": "<aggregation_type>",
  "uuids": [
    "<uuid-1>",
    "<uuid-2>",
    "<uuid-3>",
    "... more UUIDs ..."
  ]
}

type is "average", "market-average", "assembled" or "regression". The uuids list links to process files in the source EPD processes/ folder.

Development / running tests

See DEVELOP.md for local setup, versioning, and PyPI release instructions.

For local development, install the package in editable mode with developer dependencies:

python -m pip install -e ".[dev]"

Then run tests:

pytest