This is now the official repo for Brightway2-UI:
a web and command line user interface, part of the Brightway2 LCA framework https://brightway.dev.
The original source code was hosted on Bitbucket: https://bitbucket.org/tomas_navarrete/brightway2-ui.
This repository is used to produce 2 packages: one compatible with brightway25 (bw25ui), and one compatible with brightway2 (bw2ui).
Both, conda / mamba and wheels from pypi.org are available.
The package names are different for Brightway25 and Brightway2, but the main executable script is still the same.
Note
The requirements here are abstract, but they are different for brightway25 and brightway2.
For brightway25, bw2calc must be >= 2.0.dev10 and bw2analyzer >= 0.11
for brightway2 bw2calc must be < 2 and bw2analyzer >=0.10
To install a conda / mamba package compatible with brightway25:
mamba install -c tomas_navarrete bw25ui
There is also a pip wheel that you can install with:
pip install bw25ui
To install a package compatible with brightway2:
mamba install -c tomas_navarrete bw2ui
There is also a pip wheel that you can install with:
pip install bw2ui
- As long as retro-compatibility is possible between Brightway25 and Brightway2, the code base will remain identical.
- Packages will be published with the same version tags, but different names.
- New features will be primarily implemented to work with Brightway25, and if they are compatible with Brightway2 they will be part of the same code base.
- When the implementation of new features in a single code base for Brightway2 and Brightway25 becomes imposible, a new branch called
legacywill be created to track the code compatible with Brightway2. The same will be done in the long term once Brightway3 is released.
The current code base is identical for both packages (bw25ui and bw2ui).
The current main branch will be kept as the branch for development, with identical code bases for both packages until brightway25 public API breaks the compatibility.
Once Brightway3 starts to exist, the main branch will be dedicated to it, with a bw3ui package.
Contributions are very welcome. To learn more, see the Contributor Guide.
Distributed under the terms of the BSD-3 license, bw2ui is free and open source software.
If you encounter any problems, please file an issue along with a detailed description.
You can build the documentation locally by installing the documentation Conda environment:
conda env create -f docs/environment.ymlactivating the environment
conda activate sphinx_brightway2-uiand running the build command:
sphinx-build docs _build/html --builder=html --jobs=auto --write-all; open _build/html/index.htmland running the build command:
sphinx-build docs _build/html --builder=html --jobs=auto --write-all; open _build/html/index.html