Skip to content

Commit

Permalink
Updated README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
t-bellier committed Jul 21, 2023
1 parent 84d1a73 commit 5c07c61
Showing 1 changed file with 40 additions and 7 deletions.
47 changes: 40 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,59 @@
# LCA4MDAO

### Author: Thomas Bellier

## Installation

Download from this repository, then install with:
`python setup.py install`

### Dependencies

#### Brightway2 (Opensource)
#### Brightway2 (opensource)

[Brightway2](https://documentation.brightway.dev/en/legacy/index.html) manages the environment databases and LCA calculation. Note that only *Brightway2* is compatible and not *Brightway25*.

#### OpenMDAO (opensource)

#### OpenMDAO (Opensource)
[OpenMDAO](https://openmdao.org/newdocs/versions/latest/main.html) manages all the MDAO and optimisation structure.

#### Ecoinvent (licence) or ???
#### Ecoinvent (licence, optional)

[Ecoinvent](https://ecoinvent.org/) is one of the main environmental database and the one *Brightway2* is built for. Most projects would require a license, which is sadly not free.
Be careful, specific *Ecoinvent* version requires specific *Brightway2* version, as stated on the [documentation](https://github.com/brightway-lca/brightway2-io).

#### Pymoo (opensource, optional)

[Pymoo](https://pymoo.org/) is only required to use the [optimizer](lca4mdao/optimizer) module, mainly for multiobjective optimisation.

## Usage

### Documentation

The notebooks in the [examples](lca4mdao/examples) folder are used as tutorial to understand the usage of the module. Full documentation will be included with the final release.

### Examples

### Documentation
The main principles of the package are highlighted in the simple [sellar notebook](lca4mdao/examples/sellar.ipynb).
The same single objective optimisation problem is condensed in the [sellar](lca4mdao/examples/sellar.py) python file, the multi-objective version in the [sellar_multiobjective](lca4mdao/examples/sellar_multiobjective.py) python file, and a variation using *Ecoinvent 3.8* in the [sellar_ecoinvent](lca4mdao/examples/sellar_ecoinvent.py) python file.

## TODO

Many things
- Add to a package registry
- Add precise requirements
- Include utilities for databases other than ecoinvent
- Upgrade to brightway25
- Create other convenient option to generate LCA variables
- Include MDAO parameters inside the normal brightway dependency chain
- Optimise partial derivative computation for LCA
- Include and test more optimiser from pymoo

## License

Distributed under the MIT License. See [LICENSE](LICENSE) for more information.

## Contact

Author: [Thomas Bellier](mailto:[email protected])
Manager: [Joseph Morlier](mailto:[email protected])

## Citation

Expand Down

0 comments on commit 5c07c61

Please sign in to comment.