Hestia's module to orchestrate the models.
Project description
Hestia Engine Orchestrator
Orchestrate your different models to run on a Cycle, an ImpactAssessment or a Site.
Documentation
Documentation can be found in the source folder.
Install
- Install the library:
pip install hestia_earth.orchestrator
You can now install your own models or follow the steps below to use the default Hestia models.
Install the Hestia Models
If you want to use the hestia default models, follow these steps:
- Install the library:
pip install hestia_earth.models
- Download the latest configuration files:
curl https://gitlab.com/hestia-earth/hestia-engine-orchestrator/-/raw/master/scripts/download_config.sh?inline=false -o download_config.sh && chmod +x download_config.sh
# pip default install directory is /usr/local/lib/python<version>/site-packages
./download_config.sh <pip install directory>
Using your own models
You can create your own models in addition (or instead of) the default set of models provided by Hestia.
The model needs to expose only one method:
def run(key: str, data): ...
It will be given the data that has been given to the orchestrator, i.e. by calling:
from hestia_earth.orchestrator import run
my_data = {'@type': 'Cycle', 'inputs': []}
config = {
"models": [{
"key": "inputs",
"model": "my_model",
"value": "my_model_value",
"runStrategy": "add_if_missing_key"
}]
}
run(my_data, config)
Will be calling in your own model my_model.py
:
def run('my_model_value', my_data: dict): ...
Usage
# will work with either Cycle or Site
from hestia_earth.orchestrator import run
# cycle is a JSONLD node cycle
cycle = {'@type': 'Cycle', ...}
result = run(cycle, '/path/to/my-config.json') # configuration stored in a file
print(result)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for hestia-earth-orchestrator-0.6.15.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 52ad45e2f94c5f9a8316ba538c0ab3e1a031d4ca52a838575ad1be76d679a2d6 |
|
MD5 | 66ffa0bcb4e0f4dc89f2bff6bb3b1e51 |
|
BLAKE2b-256 | 6fc2eff7681ace3cc198c36671fc8aaf76e65e723cdcc16d73972afbf260021c |
Close
Hashes for hestia_earth_orchestrator-0.6.15-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ffa40caf95a8e770f5b56f83f454456d29fb3227a9b79ab67a17e54b334b4512 |
|
MD5 | 8452e39cbcf653320ded4e54e488ab77 |
|
BLAKE2b-256 | a7e1796ba9627b1fd3791273317c10713b9181958fa5a0afde34e96aaeaffa1f |