bw-recipe-2016 0.4
Import ReCiPe 2016 into Brightway2
License: BSD 3-clause

# bw_recipe_2016

Import the official ReCiPe characterization factors into Brightway.

**Warning**: These CFs have not yet been verified!

## Impact categories

### Midpoints

Note that not all perspectives are available for all midpoints.

* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Freshwater', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Freshwater', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Freshwater', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Marine', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Marine', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Marine', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Terrestrial', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Terrestrial', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ecotoxicity', 'Terrestrial', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Fossil resource scarcity')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Freshwater Eutrophication')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Global Warming', '100 year timescale', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Global Warming', '1000 year timescale', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Global Warming', '20 year timescale', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ionizing Radiation', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ionizing Radiation', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ionizing Radiation', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Land occupation')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Land transformation')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Marine eutrophication')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Mineral Resource Scarcity', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Mineral Resource Scarcity', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Mineral Resource Scarcity', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ozone Formation', 'Damage to Ecosystems')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Ozone Formation', 'Damage to Humans')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Particulate Matter Formation', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Particulate Matter Formation', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Particulate Matter Formation', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Stratospheric Ozone Depletion', '100 year timescale', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Stratospheric Ozone Depletion', '20 year timescale', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Stratospheric Ozone Depletion', 'Infinite timescale', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Terrestrial Acidification')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Toxicity', 'Carcinogenic', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Toxicity', 'Carcinogenic', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Toxicity', 'Carcinogenic', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Toxicity', 'Non-carcinogenic', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Toxicity', 'Non-carcinogenic', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Toxicity', 'Non-carcinogenic', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Midpoint', 'Water consumption')

### Endpoints

ReCiPe 2016 provides five endpoints:

* Freshwater ecosystems
* Resources
* Human health
* Marine ecosystems
* Terrestrial ecosystems

Combined with the three perspectives, the following endpoints are available:

* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Ecotoxicity', 'Freshwater', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Ecotoxicity', 'Freshwater', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Ecotoxicity', 'Freshwater', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Freshwater Eutrophication', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Freshwater Eutrophication', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Freshwater Eutrophication', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Global Warming', '100 year timescale', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Global Warming', '1000 year timescale', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Global Warming', '20 year timescale', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Water consumption', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Water consumption', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Water consumption', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Global Warming', '100 year timescale', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Global Warming', '1000 year timescale', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Global Warming', '20 year timescale', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Ionizing Radiation', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Ionizing Radiation', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Ionizing Radiation', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Ozone Formation', 'Damage to Humans', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Ozone Formation', 'Damage to Humans', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Ozone Formation', 'Damage to Humans', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Particulate Matter Formation', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Particulate Matter Formation', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Particulate Matter Formation', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Stratospheric Ozone Depletion', '100 year timescale', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Stratospheric Ozone Depletion', '20 year timescale', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Stratospheric Ozone Depletion', 'Infinite timescale', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Toxicity', 'Carcinogenic', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Toxicity', 'Carcinogenic', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Toxicity', 'Carcinogenic', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Toxicity', 'Non-carcinogenic', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Toxicity', 'Non-carcinogenic', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Toxicity', 'Non-carcinogenic', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Water consumption', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Water consumption', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Water consumption', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Ecotoxicity', 'Marine', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Ecotoxicity', 'Marine', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Ecotoxicity', 'Marine', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Marine eutrophication', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Marine eutrophication', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Marine eutrophication', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Fossil resource scarcity', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Fossil resource scarcity', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Fossil resource scarcity', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Mineral Resource Scarcity', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Mineral Resource Scarcity', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Mineral Resource Scarcity', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Ecotoxicity', 'Terrestrial', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Ecotoxicity', 'Terrestrial', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Ecotoxicity', 'Terrestrial', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Global Warming', '100 year timescale', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Global Warming', '1000 year timescale', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Global Warming', '20 year timescale', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Land occupation', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Land occupation', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Land occupation', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Land transformation', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Land transformation', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Land transformation', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Ozone Formation', 'Damage to Ecosystems', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Ozone Formation', 'Damage to Ecosystems', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Ozone Formation', 'Damage to Ecosystems', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Terrestrial Acidification', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Terrestrial Acidification', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Terrestrial Acidification', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Water consumption', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Water consumption', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Water consumption', 'Individualist')

### Aggregated Endpoints

#### Ecosystems

* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Aggregated', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Aggregated', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Freshwater ecosystems', 'Aggregated', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Aggregated', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Aggregated', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Marine ecosystems', 'Aggregated', 'Individualist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Aggregated', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Aggregated', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Terrestrial ecosystems', 'Aggregated', 'Individualist')

Aggregation of all ecosystem endpoints:

* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Ecosystems', 'Aggregated', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Ecosystems', 'Aggregated', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Ecosystems', 'Aggregated', 'Individualist')

#### Human health

* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Aggregated', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Aggregated', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Human health', 'Aggregated', 'Individualist')

#### Resources

* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Aggregated', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Aggregated', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Resources', 'Aggregated', 'Individualist')

### Single score

Note that the ReCiPe 2016 report does not provide aggregation weights for a single score indicator. Weights were taken from the Stepwise LCIA method, and adjusted from global species extinction to regional species extinction for one year by dividing by 1000. See [this notebook](https://github.com/brightway-lca/bw_recipe_2016/blob/master/dev/Calculation%20of%20single%20score%20endpoint%20weights.ipynb)
 to see the relative weights of each input indicator for every activity in ecoinvent 3.6, cutoff system model.

* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Weighted single score', 'Aggregated', 'Egalitarian')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Weighted single score', 'Aggregated', 'Hierarchist')
* ('ReCiPe 2016', 'v1.1 (20180117)', 'Endpoint', 'Weighted single score', 'Aggregated', 'Individualist')


## Usage

```python
from bw_recipe_2016 import add_recipe_2016
add_recipe_2016()
```

## Installation

`pip install bw-recipe-2016`

## Parsing ReCiPe output files

This library goes as far as possible to avoid making any subjective judgments. It does, however, correct or amend data to provide consistent outputs across impact categories. For example, it fixes the following issues:

* Elementary flows are called different things in different impact categories
* Column labels are inconsistent across impact categories
* Given CAS numbers are not actually CAS numbers
* Ecotoxicity factors are repeated across three separate worksheets.

## Contributing

Details on how to contribute