Skip to content
This repository has been archived by the owner on Aug 22, 2024. It is now read-only.

ocni-dtu/epdx

Repository files navigation

EPDx is Deprecated

Since the first release of EPDx and LCAx a lot of changes have gone into the projects.

Some of that development have required that the functionality in LCAx and EPDx should have a tighter coupling. I have therefore decided that LCAx should adopt the functionality of EPDx.

In practical terms it means that everything from EPDx is now inside LCAx.

No new development will be carried out for EPDx, but the packages and GitHub repository are still available for everyone, however they are now considered legacy and the GitHub repository will be archived.

However, development on LCAx is very active!

EPDx

EPDx is a library for parsing EPD files into a common exchange format.

The library is written in Rust, to allow for cross-language package distribution. Currently, we support Javascript/Typescript, Python and Rust.

EPDx is part of a larger project of making life cycle assessments more accessible and transparent to building professionals.

Read more about our overall goal

ILCD+EPD

The ILCD+EPD format is a digital format for EPDs. Provided in either XML or JSON.

Initially EPDs were provided as PDFs. That is not very convenient for automation processes and requires large amounts of manual work to process.

The ILCD (International Life Cycle Data System) is a data format developed by the European Commission to give LCA practitioners a common digital format for life cycle assessments. In order to integrate EPD specific information (e.g. scenarios, modules, type of data), extensions were added to the ILCD format. The resulting format got named ILCD+EPD format.

The ECO Platform and Ökobau uses the format to store and expose EPDs through the soda4LCA API. The API makes it possible for everyone to search and download tons of EPDs to be used free of charge.

The ILCD+EPD format is a node based format. It means that each EPD consists of several layers of nodes that contain different information. The first node contains a summary of the EPD, with references to the nodes. By drilling down the tree of nodes, you have access to more and more specific information, such as EPD manufacturer, functional unit(s), etc.

Read more about ILCD at the European Platform on Life Cycle Assessment

Documentation

EPDx can have available packages for Javascript, Python and Rust.

To get started head over to our documentation.

Install NPM Package

npm install epdx

Install Python Package

pip install epdx

Install Rust Crate

cargo add epdx

Contribute

Install Rust

Head over to Rust's installation page

Run Tests

cargo test --package epdx --target x86_64-unknown-linux-gnu

Run Python Tests

maturin develop --extras tests --target x86_64-unknown-linux-gnu
source .venv/bin/activate .
cd packages/python
pytest tests/

Build Documentation

maturin develop --extras doc,codegen --target x86_64-unknown-linux-gnu
mkdocs develop

Build JS Package

wasm-pack build --features jsbindings
mv pkg/epdx* packages/javascript/src