Skip to content

USEPA/LCIAformatter

Repository files navigation

LCIA formatter

DOI build

The LCIA formatter, or lciafmt, is a Python tool for standardizing the format and flows of life cycle impact assessment (LCIA) data. The tool acquires LCIA data transparently from its original source, cleans the data, shapes them into a standard format using the LCIAmethod format, and optionally applies flow mappings as defined in the Federal LCA Commons Elementary Flow List. The result can be exported to all formats supported by the pandas package (e.g. Excel, CSV) or the openLCA JSON-LD format.

The LCIA Formatter v1 was peer-reviewed internally at USEPA and externally through the Journal of Open Source software. An article describing the LCIA Formatter was published by JOSS.

Data Provided

LCIA Data Provider Link
TRACI 2.1 US Environmental Protection Agency Tool for Reduction and Assessment of Chemicals and Other Environmental Impacts
ReCiPe 2016 Midpoint National Institute for Public Health and the Environment (The Netherlands) LCIA: the ReCiPe Model
ReCiPe 2016 Endpoint National Institute for Public Health and the Environment (The Netherlands) LCIA: the ReCiPe Model
ImpactWorld+ Midpoint* International Reference Center for Life Cycle of Products, Services and Systems (CIRAIG) ImpactWorld+
ImpactWorld+ Endpoint* International Reference Center for Life Cycle of Products, Services and Systems (CIRAIG) ImpactWorld+
IPCC GWP Intergovernmental Panel on Climate Change (IPCC)
FEDEFL Inventory Methods US Environmental Protection Agency FEDEFL Inventory Methods

* only works on Windows installations

Installation Instructions

lciafmt requires Python 3.9 or greater.

Install a release directly from github using pip. From a command line interface, run:

pip install git+https://github.com/USEPA/LCIAformatter.git@v1.1.0#egg=lciafmt

where you can replace 'v1.1.0' with the version you wish to use under Releases.

Alternatively, to install from the most current point on the repository:

git clone https://github.com/USEPA/LCIAformatter.git
cd LCIAformatter
pip install . # or pip install -e . for devs

The current version contains an optional dependency on the pyodbc library to generate the Impact World+ LCIA method. Due to limitations in reading Access databases from non-Windows platforms, this will only be install on Windows machines.

This needs to be specified in the pip install command. It can be done in one of two ways:

pip install .["ImpactWorld"]

or

pip install . -r requirements.txt -r impactworld_requirements.txt 

See the Wiki for further installation and use instructions or for information on how to seek support.

Disclaimer

The United States Environmental Protection Agency (EPA) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.