# Brightway-Hestia bridge
[][pypi status]
[][pypi status]
[][pypi status]
[][license]
[][read the docs]
[][tests]
[][codecov]
[][pre-commit]
[][black]
[pypi status]: https://pypi.org/project/bw_hestia_bridge/
[read the docs]: https://docs.brightway.dev/projects/hestiabridge
[tests]: https://github.com/brightway-lca/bw_hestia_bridge/actions?workflow=Tests
[codecov]: https://app.codecov.io/gh/brightway-lca/bw_hestia_bridge
[pre-commit]: https://github.com/pre-commit/pre-commit
[black]: https://github.com/psf/black
``bw_hestia_bridge`` is a library to interact with [Hestia] and create [brightway] databases from its data.
[Hestia]: https://hestia.earth
[brightway]: https://brightway.dev
## Installation
You can install ``bw_hestia_bridge`` via [pip] from [PyPI]:
```console
$ pip install bw_hestia_bridge
```
[pip]: https://pypi.org/project/pip
[PyPi]: https://pypi.org/project/bw-hestia-bridge
## Mapping `Hestia` cycles to the Brightway mental model
Hestia is not a linked network of unit processes, but detailed data on specific production systems. As they are agricultural, almost all of these systems have multiple outputs, and many of these outputs require further treatment. For example, in the [pig system](https://www-staging.hestia.earth/cycle/5-qkgrlriqqm?dataState=recalculated), there are three types of excreta produced, which go to deep bedding, which go to composting. Hestia doesn't seem to have a waste treatment for the final processed excreta.
Because these follow-on activities (Hestia calls them [Transformations](https://www-staging.hestia.earth/schema/Transformation)) are multi-input *and* multi-output, and because there is no guarantee that the respective ratios of these outputs align with the next stage inputs, we will do the following:
For each `transformation`, we create a new unit process. The *reference product* of this process will be the output with the highest mass.
For the other outputs, we will create proxy treatment activities. These proxies will handle any potential stoichiometric disparities.
If a `transformation` is a leaf node, i.e. it has inputs but no consumers for each outputs, we will create proxy consumers for each output other than the reference product.
We then go back to the original unit process, and add proxy consumers for each output which is not the reference product (i.e. marked `"primary": true`) or the reference product of a waste treatment.
## Contributing
Contributions are very welcome.
To learn more, see the [Contributor Guide].
## License
Distributed under the terms of the [MIT license][license],
_bw_hestia_bridge_ is free and open source software.
## Issues
If you encounter any problems,
please [file an issue] along with a detailed description.
[license]: https://github.com/brightway-lca/bw_hestia_bridge/blob/main/LICENSE
<!-- github-only -->
[command-line reference]: https://bw_hestia_bridge.readthedocs.io/en/latest/usage.html
[contributor guide]: https://github.com/brightway-lca/bw_hestia_bridge/blob/main/CONTRIBUTING.md
Raw data
{
"_id": null,
"home_page": "",
"name": "bw-hestia-bridge",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Chris Mutel <cmutel@gmail.com>",
"keywords": "brightway,hestia,agriculture,development",
"author": "Timo Diepers, Tanguy Fardet, Clemens Wingenbach",
"author_email": "Chris Mutel <cmutel@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/57/c0/235ea95864144e908e1f893451b17f146d1f1b777cb8b5eb5ac68e535b61/bw_hestia_bridge-0.3.1.tar.gz",
"platform": null,
"description": "# Brightway-Hestia bridge\n\n[][pypi status]\n[][pypi status]\n[][pypi status]\n[][license]\n\n[][read the docs]\n[][tests]\n[][codecov]\n\n[][pre-commit]\n[][black]\n\n[pypi status]: https://pypi.org/project/bw_hestia_bridge/\n[read the docs]: https://docs.brightway.dev/projects/hestiabridge\n[tests]: https://github.com/brightway-lca/bw_hestia_bridge/actions?workflow=Tests\n[codecov]: https://app.codecov.io/gh/brightway-lca/bw_hestia_bridge\n[pre-commit]: https://github.com/pre-commit/pre-commit\n[black]: https://github.com/psf/black\n\n\n``bw_hestia_bridge`` is a library to interact with [Hestia] and create [brightway] databases from its data.\n\n[Hestia]: https://hestia.earth\n[brightway]: https://brightway.dev\n\n\n## Installation\n\nYou can install ``bw_hestia_bridge`` via [pip] from [PyPI]:\n\n```console\n$ pip install bw_hestia_bridge\n```\n\n[pip]: https://pypi.org/project/pip\n[PyPi]: https://pypi.org/project/bw-hestia-bridge\n\n\n## Mapping `Hestia` cycles to the Brightway mental model\n\nHestia is not a linked network of unit processes, but detailed data on specific production systems. As they are agricultural, almost all of these systems have multiple outputs, and many of these outputs require further treatment. For example, in the [pig system](https://www-staging.hestia.earth/cycle/5-qkgrlriqqm?dataState=recalculated), there are three types of excreta produced, which go to deep bedding, which go to composting. Hestia doesn't seem to have a waste treatment for the final processed excreta.\n\nBecause these follow-on activities (Hestia calls them [Transformations](https://www-staging.hestia.earth/schema/Transformation)) are multi-input *and* multi-output, and because there is no guarantee that the respective ratios of these outputs align with the next stage inputs, we will do the following:\n\nFor each `transformation`, we create a new unit process. The *reference product* of this process will be the output with the highest mass.\n\nFor the other outputs, we will create proxy treatment activities. These proxies will handle any potential stoichiometric disparities.\n\nIf a `transformation` is a leaf node, i.e. it has inputs but no consumers for each outputs, we will create proxy consumers for each output other than the reference product.\n\nWe then go back to the original unit process, and add proxy consumers for each output which is not the reference product (i.e. marked `\"primary\": true`) or the reference product of a waste treatment.\n\n## Contributing\n\nContributions are very welcome.\nTo learn more, see the [Contributor Guide].\n\n## License\n\nDistributed under the terms of the [MIT license][license],\n_bw_hestia_bridge_ is free and open source software.\n\n## Issues\n\nIf you encounter any problems,\nplease [file an issue] along with a detailed description.\n\n[license]: https://github.com/brightway-lca/bw_hestia_bridge/blob/main/LICENSE\n\n<!-- github-only -->\n\n[command-line reference]: https://bw_hestia_bridge.readthedocs.io/en/latest/usage.html\n[contributor guide]: https://github.com/brightway-lca/bw_hestia_bridge/blob/main/CONTRIBUTING.md\n",
"bugtrack_url": null,
"license": "",
"summary": "Import HESTIA data directly into Brightway",
"version": "0.3.1",
"project_urls": {
"homepage": "https://github.com/brightway-lca/bw_hestia_bridge",
"source": "https://github.com/brightway-lca/bw_hestia_bridge",
"tracker": "https://github.com/brightway-lca/bw_hestia_bridge/issues"
},
"split_keywords": [
"brightway",
"hestia",
"agriculture",
"development"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7e7595d30064437ed8354f011c36925bce5dd57c208986520755a2fea21b26c1",
"md5": "c58cebbea9137784776ee3e4a07acecf",
"sha256": "85464df30363ac4163128da622c4978cea6fae8676a1e94b8f7b37a49797d4b3"
},
"downloads": -1,
"filename": "bw_hestia_bridge-0.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c58cebbea9137784776ee3e4a07acecf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 25006,
"upload_time": "2023-09-20T11:25:45",
"upload_time_iso_8601": "2023-09-20T11:25:45.387327Z",
"url": "https://files.pythonhosted.org/packages/7e/75/95d30064437ed8354f011c36925bce5dd57c208986520755a2fea21b26c1/bw_hestia_bridge-0.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "57c0235ea95864144e908e1f893451b17f146d1f1b777cb8b5eb5ac68e535b61",
"md5": "e1982132d1d0b2e9652007913cbc64ac",
"sha256": "6da5a3353fd6a232446fcab01f0ac38bc7b425ac4b153a4fc17e8621e484d0ae"
},
"downloads": -1,
"filename": "bw_hestia_bridge-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "e1982132d1d0b2e9652007913cbc64ac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 25218,
"upload_time": "2023-09-20T11:25:46",
"upload_time_iso_8601": "2023-09-20T11:25:46.547498Z",
"url": "https://files.pythonhosted.org/packages/57/c0/235ea95864144e908e1f893451b17f146d1f1b777cb8b5eb5ac68e535b61/bw_hestia_bridge-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-20 11:25:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "brightway-lca",
"github_project": "bw_hestia_bridge",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "bw-hestia-bridge"
}
JSON
