Name | hestia-earth-models JSON |
Version |
0.64.4
JSON |
| download |
home_page | https://gitlab.com/hestia-earth/hestia-engine-models |
Summary | HESTIA's set of modules for filling gaps in the activity data using external datasets (e.g. populating soil properties with a geospatial dataset using provided coordinates) and internal lookups (e.g. populating machinery use from fuel use). Includes rules for when gaps should be filled versus not (e.g. never gap fill yield, gap fill crop residue if yield provided etc.). |
upload_time | 2024-10-01 08:00:06 |
maintainer | None |
docs_url | None |
author | HESTIA Team |
requires_python | None |
license | GPL |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# HESTIA Engine Models
[![Pipeline Status](https://gitlab.com/hestia-earth/hestia-engine-models/badges/master/pipeline.svg)](https://gitlab.com/hestia-earth/hestia-engine-models/commits/master)
[![Coverage Report](https://gitlab.com/hestia-earth/hestia-engine-models/badges/master/coverage.svg)](https://gitlab.com/hestia-earth/hestia-engine-models/commits/master)
HESTIA's set of models for running calculations or retrieving data using external datasets and internal lookups.
## Documentation
Documentation for every model can be found in the [HESTIA API Documentation](https://hestia.earth/docs/#hestia-calculation-models).
## Install
1. Install python `3` (we recommend using python `3.6` minimum)
2. Install the module:
```bash
pip install hestia_earth.models
```
3. Set the following environment variables:
```
API_URL=https://api.hestia.earth
WEB_URL=https://hestia.earth
```
### Usage
```python
from hestia_earth.models.pooreNemecek2018 import run
# cycle is a JSONLD node Cycle
run('no3ToGroundwaterSoilFlux', cycle_data)
```
Additionally, to reduce the number of queries to the HESTIA API and run the models faster, prefetching can be enabled:
```python
from hestia_earth.models.preload_requests import enable_preload
enable_preload()
```
### Using Spatial Models
We have models that can gap-fill geographical information on a `Site`. If you want to use these models:
1. Install the library: `pip install hestia_earth.earth_engine`
2. Follow the [Getting Started instructions](https://gitlab.com/hestia-earth/hestia-earth-engine#getting-started).
### Using the ecoinventV3 model
ecoinvent is a consistent, transparent, and well validated life cycle inventory database.
We use ecoinvent data to ascertain the environmental impacts of activities that occur outside of our system boundary, for example data on the environmental impacts of extracting oil and producing diesel, or the impacts of manufacturing plastics.
The `ecoinventV3` model requires a valid [license](https://ecoinvent.org/offerings/licences/) to run. We are currently working on a way to enable users of this code with a valid ecoinvent licence to run these models themselves, but for now, these models are only available on the public platform.
Raw data
{
"_id": null,
"home_page": "https://gitlab.com/hestia-earth/hestia-engine-models",
"name": "hestia-earth-models",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "HESTIA Team",
"author_email": "guillaumeroyer.mail@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/34/6b/b580867f54159f2071aa9ea1467dad2ab8d91713da1b796815c0e7af317c/hestia-earth-models-0.64.4.tar.gz",
"platform": null,
"description": "# HESTIA Engine Models\n\n[![Pipeline Status](https://gitlab.com/hestia-earth/hestia-engine-models/badges/master/pipeline.svg)](https://gitlab.com/hestia-earth/hestia-engine-models/commits/master)\n[![Coverage Report](https://gitlab.com/hestia-earth/hestia-engine-models/badges/master/coverage.svg)](https://gitlab.com/hestia-earth/hestia-engine-models/commits/master)\n\nHESTIA's set of models for running calculations or retrieving data using external datasets and internal lookups.\n\n## Documentation\n\nDocumentation for every model can be found in the [HESTIA API Documentation](https://hestia.earth/docs/#hestia-calculation-models).\n\n## Install\n\n1. Install python `3` (we recommend using python `3.6` minimum)\n2. Install the module:\n```bash\npip install hestia_earth.models\n```\n3. Set the following environment variables:\n```\nAPI_URL=https://api.hestia.earth\nWEB_URL=https://hestia.earth\n```\n\n### Usage\n\n```python\nfrom hestia_earth.models.pooreNemecek2018 import run\n\n# cycle is a JSONLD node Cycle\nrun('no3ToGroundwaterSoilFlux', cycle_data)\n```\n\nAdditionally, to reduce the number of queries to the HESTIA API and run the models faster, prefetching can be enabled:\n```python\nfrom hestia_earth.models.preload_requests import enable_preload\n\nenable_preload()\n```\n\n### Using Spatial Models\n\nWe have models that can gap-fill geographical information on a `Site`. If you want to use these models:\n1. Install the library: `pip install hestia_earth.earth_engine`\n2. Follow the [Getting Started instructions](https://gitlab.com/hestia-earth/hestia-earth-engine#getting-started).\n\n### Using the ecoinventV3 model\n\necoinvent is a consistent, transparent, and well validated life cycle inventory database.\nWe use ecoinvent data to ascertain the environmental impacts of activities that occur outside of our system boundary, for example data on the environmental impacts of extracting oil and producing diesel, or the impacts of manufacturing plastics.\n\nThe `ecoinventV3` model requires a valid [license](https://ecoinvent.org/offerings/licences/) to run. We are currently working on a way to enable users of this code with a valid ecoinvent licence to run these models themselves, but for now, these models are only available on the public platform.\n\n\n",
"bugtrack_url": null,
"license": "GPL",
"summary": "HESTIA's set of modules for filling gaps in the activity data using external datasets (e.g. populating soil properties with a geospatial dataset using provided coordinates) and internal lookups (e.g. populating machinery use from fuel use). Includes rules for when gaps should be filled versus not (e.g. never gap fill yield, gap fill crop residue if yield provided etc.).",
"version": "0.64.4",
"project_urls": {
"Homepage": "https://gitlab.com/hestia-earth/hestia-engine-models"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1911913dd5a24f55c2194da3e92dd4c931ea3f9a187d7a561d4ea1a43436be98",
"md5": "8442dab3c25e21d4facad7455e25d412",
"sha256": "3cea3189f62354fc7a60c87080d0186d0dc973a8ffb2bc906828bc9596126639"
},
"downloads": -1,
"filename": "hestia_earth_models-0.64.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8442dab3c25e21d4facad7455e25d412",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 995811,
"upload_time": "2024-10-01T08:00:04",
"upload_time_iso_8601": "2024-10-01T08:00:04.182682Z",
"url": "https://files.pythonhosted.org/packages/19/11/913dd5a24f55c2194da3e92dd4c931ea3f9a187d7a561d4ea1a43436be98/hestia_earth_models-0.64.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "346bb580867f54159f2071aa9ea1467dad2ab8d91713da1b796815c0e7af317c",
"md5": "7ad55263a4bcc120704f8a24f3046a1e",
"sha256": "8cf7b850002cef065136522ca452e94328da0def3dea02206abd9825f3eead5a"
},
"downloads": -1,
"filename": "hestia-earth-models-0.64.4.tar.gz",
"has_sig": false,
"md5_digest": "7ad55263a4bcc120704f8a24f3046a1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 363433,
"upload_time": "2024-10-01T08:00:06",
"upload_time_iso_8601": "2024-10-01T08:00:06.255787Z",
"url": "https://files.pythonhosted.org/packages/34/6b/b580867f54159f2071aa9ea1467dad2ab8d91713da1b796815c0e7af317c/hestia-earth-models-0.64.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-01 08:00:06",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "hestia-earth",
"gitlab_project": "hestia-engine-models",
"lcname": "hestia-earth-models"
}