python cURL JavaScript (browser) JavaScript (NodeJS)
Overview

Overview

Welcome to the Hestia API documentation!

API

API

To access the API:

  1. Create an Account.
  2. Retrieve your access token:
curl -X POST "<APIUrl>/users/signin" \
  -H "Content-Type: application/json" \
  --data '{"email":"email@email.com","password":"pwd"}' | jq '.token'
import json
import requests

headers = {'Content-Type': 'application/json'}
body = json.dumps({"email":"email@email.com","password":"pwd"})
token = requests.post('<APIUrl>/users/signin', body, headers=headers).json().get('token')
print(token)
(async () => {
  const url = '<APIUrl>/users/signin';
  const headers = {
    'Content-Type': 'application/json'
  };
  const body = JSON.stringify({ email: 'email@email.com', password: 'pwd' });
  const response = await fetch(url, { method: 'POST', headers, body });
  const { token } = await response.json();
  console.log(token);
})();
const axios = require('axios');

(async () => {
  const url = '<APIUrl>/users/signin';
  const body = { email: 'email@email.com', password: 'pwd' };
  const { data: { token } } = await axios.post(url, body);
  console.log(token);
})();
Documentation

Documentation

You can view the API documentation and test it here.

Samples

Samples

Retrieving your profile

curl -H "X-ACCESS-TOKEN: <your-token>" \
  -H "Content-Type: application/json" \
  "<APIUrl>/users/me"
import requests

headers = {'Content-Type': 'application/json', 'X-ACCESS-TOKEN': '<your-token>'}
profile = requests.get('<APIUrl>/users/me', headers=headers).json()
print(profile)
(async () => {
  const url = '<APIUrl>/users/me';
  const headers = {
    'Content-Type': 'application/json',
    'X-ACCESS-TOKEN': '<your-token>'
  };
  const response = await fetch(url, { headers });
  const profile = await response.json();
  console.log(profile);
})();
const axios = require('axios');

(async () => {
  const url = '<APIUrl>/users/me';
  const headers = {
    'X-ACCESS-TOKEN': '<your-token>'
  };
  const { data } = await axios.get(url, { headers });
  console.log(data);
})();

Downloading a node (example for a Term)

curl "<APIUrl>/terms/sandContent"
import requests

headers = {'Content-Type': 'application/json'}
node = requests.get('<APIUrl>/terms/sandContent', headers=headers).json()
print(node)
# or use our utils library
from hestia_earth.schema import SchemaType
from hestia_earth.utils.api import download_hestia

node = download_hestia('sandContent', SchemaType.TERM)
(async () => {
  const url = '<APIUrl>/terms/sandContent';
  const headers = {
    'Content-Type': 'application/json'
  };
  const response = await fetch(url, { headers });
  const node = await response.json();
  console.log(node);
})();
const axios = require('axios');

(async () => {
  const url = '<APIUrl>/terms/sandContent';
  const { data } = await axios.get(url);
  console.log(data);
})();

Getting related nodes

curl "<APIUrl>/terms/sandContent/sites"
import requests

headers = {'Content-Type': 'application/json'}
node = requests.get('<APIUrl>/terms/sandContent/sites', headers=headers).json()
print(node)
# or use our utils library
from hestia_earth.schema import SchemaType
from hestia_earth.utils.api import find_related

cycles = find_related(SchemaType.TERM, 'sandContent', SchemaType.SITE)
(async () => {
  const url = '<APIUrl>/terms/sandContent/sites';
  const headers = {
    'Content-Type': 'application/json'
  };
  const response = await fetch(url, { headers });
  const node = await response.json();
  console.log(node);
})();
const axios = require('axios');

(async () => {
  const url = '<APIUrl>/terms/sandContent/sites';
  const { data } = await axios.get(url);
  console.log(data);
})();

All of our Nodes are linked together by a Graph Database, which means you can get a list of Site that are linked to a Term for example.

Full Examples

Full Examples

from hestia_earth.schema import SchemaType
from hestia_earth.utils.api import find_node, download_hestia

# this will give you partial information only
cycles = find_node(SchemaType.CYCLE, {
  'emissions.term.name': 'NO3, to groundwater, soil flux'
})

for cycle in cycles:
  # to retrieve the complete data of the cycle
  data = download_hestia(cycle['@id'], SchemaType.CYCLE, data_state='recaclulated')
  inputs = data.get('inputs', [])
  N_filter = [sum(input.get('value')) if input.get('term', {}).get('units') == 'kg N' else 0 for input in inputs]
  total = sum(N_filter)
  print(cycle, 'total nitrogen fertilizer', total)
from hestia_earth.schema import SchemaType
from hestia_earth.utils.api import find_node, download_hestia
from hestia_earth.utils.model import find_term_match

# searching for aggregated GWP100 emissions on "Maize, grain"
impacts = find_node(SchemaType.IMPACTASSESSMENT, {
  'aggregated': 'true',
  'product.name': 'Maize, grain'
})
# only download the first impact to test, but there would be many more
data = download_hestia(impacts[0]['@id'], SchemaType.IMPACTASSESSMENT, data_state='aggregated')
# 'gwp100' here refers to the @id and not the name
emission = find_term_match(data['impacts'], 'gwp100')
print(emission['value'])
(async () => {
  const apiUrl = '<APIUrl>';
  const searchUrl = '<APIUrl>/search';
  const headers = {
    'Content-Type': 'application/json'
  };
  const body = JSON.stringify({
    fields: ['@id'],
    limit: 10,
    query: {
      bool: {
        'must': [
          { match: { '@type': 'Cycle' } },
          { match: { 'emissions.term.name': 'NO3, to groundwater, soil flux' } }
        ]
      }
    }
  });
  const { results: cycles } = await (await fetch(searchUrl, { method: 'POST', headers, body })).json();
  cycles.map(async cycle => {
    const data = await (await fetch(`${apiUrl}/cycles/${cycle['@id']}`, { headers })).json();
    const values = (data.inputs || [])
      .filter(input => input.term.units === 'kg N')
      .flatMap(input => input.value);
    const total = values.reduce((a, b) => a + b, 0);
    console.log(cycle, 'total nitrogen fertilizer', total);
  });
})();
(async () => {
  const apiUrl = '<APIUrl>';
  const searchUrl = '<APIUrl>/search';
  const headers = {
    'Content-Type': 'application/json'
  };
  // searching for aggregated GWP100 emissions on "Maize, grain"
  const body = JSON.stringify({
    fields: ['@id'],
    limit: 10,
    query: {
      bool: {
        'must': [
          { match: { '@type': 'ImpactAssessment' } },
          { match: { 'aggregated': true } },
          { match: { 'product.term': 'Maize, grain' } }
        ]
      }
    }
  });
  const { results: impacts } = await (await fetch(searchUrl, { method: 'POST', headers, body })).json();
  impacts.map(async impact => {
    const url = `${apiUrl}/impactassessments/${impact['@id']}?dataState=aggregated`;
    const data = await (await fetch(url, { headers })).json();
    const value = (data.impacts || []).find(impact => impact.term.name === 'GWP100').value;
    console.log(value);
  });
})();
const axios = require('axios');

(async () => {
  const apiUrl = '<APIUrl>';
  const searchUrl = '<APIUrl>/search';
  const body = {
    fields: ['@id'],
    limit: 10,
    query: {
      bool: {
        'must': [
          { match: { '@type': 'Cycle' } },
          { match: { 'emissions.term.name': 'NO3, to groundwater, soil flux' } }
        ]
      }
    }
  };
  const { data: { results: cycles } } = await axios.post(searchUrl, body);
  cycles.map(async cycle => {
    const { data } = await axios.get(`${apiUrl}/cycles/${cycle['@id']}`);
    const values = (data.inputs || [])
      .filter(input => input.term.units === 'kg N')
      .flatMap(input => input.value);
    const total = values.reduce((a, b) => a + b, 0);
    console.log(cycle, 'total nitrogen fertilizer', total);
  });
})();
const axios = require('axios');

(async () => {
  const apiUrl = '<APIUrl>';
  const searchUrl = '<APIUrl>/search';
  // searching for aggregated GWP100 emissions on "Maize, grain"
  const body = {
    fields: ['@id'],
    limit: 10,
    query: {
      bool: {
        'must': [
          { match: { '@type': 'ImpactAssessment' } },
          { match: { 'aggregated': true } },
          { match: { 'product.term': 'Maize, grain' } }
        ]
      }
    }
  };
  const { data: { results: impacts } } = await axios.post(searchUrl, body);
  impacts.map(async impact => {
    const url = `${apiUrl}/impactassessments/${impact['@id']}?dataState=aggregated`;
    const { data } = await axios.get(url);
    const value = (data.impacts || []).find(impact => impact.term.name === 'GWP100').value;
    console.log(value);
  });
})();
Validate CSV/JSON files

Validate CSV/JSON files

Hestia provides some functions to validate a CSV / JSON / JSON-LD files formatted following the Hestia format.

Validating a CSV file

Validating a CSV file

To validate a CSV file, you will first need to convert it to JSON. This can be done using the Hestia's utils package:

  1. Install NodeJS version 12
  2. Install the utils library globally: npm install --global @hestia-earth/schema-convert
  3. Drop your CSV files into a specific folder then run:
hestia-convert-to-json folder

You will find in the folder the list of CSV files converted to JSON with the .json extension. These files can be then used for validation described below.

Validating the Terms

Validating the Terms

When uploading data on the Hestia platform, you will need to use our Glossary of Terms. You can follow these steps to install a package to validate the terms:

  1. Install NodeJS version 12
  2. Install the utils library globally: npm install --global @hestia-earth/utils
  3. Drop your JSON / JSON-LD files into a specific folder then run:
API_URL=<APIUrl> hestia-validate-terms folder

Errors will appear in the console if any have been found.

Validating the Schema

Validating the Schema

When uploading data on the Hestia platform, you will need to follow our Schema. You can follow these steps to install a package to validate the schema:

  1. Install NodeJS version 12
  2. Install the schema validation library globally: npm install --global @hestia-earth/schema-validation
  3. Drop your JSON / JSON-LD files into a specific folder then run:
hestia-validate-jsonld '' folder

Errors will appear in the console if any have been found.

Validating the Data

Validating the Data

One important step when uploading data on the Hestia platform is making sure the data is consistent using the Data Validation package. You can follow these steps to install a package to validate the data:

  1. Install Python version 3 minimum
  2. Install the data validation library: pip install hestia_earth.validation
  3. Drop your JSON / JSON-LD files into a specific folder then run:
API_URL=<APIUrl> VALIDATE_SPATIAL=false VALIDATE_EXISTING_NODES=true hestia-validate-data folder

Errors will appear in the console if any have been found.

Hestia Utils

Hestia Utils

The utils library contains useful functions to work with Hestia data.

Pivoting Headers by Terms

Pivoting Headers by Terms

After downloading data as CSV from the Hestia platform, the format will look like this:

site.@id site.measurements.0.term.@id site.measurements.0.value site.measurements.1.term.@id site.measurements.1.value site.measurements.2.term.@id site.measurements.2.value site.dataPrivate
xvflr sandContent 90 siltContent 6 clayContent 4 false
gght sandContent 90 siltContent 6 clayContent 4 false

It is possible to pivot some data based on the term.@id and move them as columns, such as:

site.@id site.measurements.sandContent.value site.measurements.siltContent.value site.measurements.clayContent.value site.dataPrivate
xvflr 90 6 4 false
gght 90 6 4 false
Usage

Usage

  1. Install Python version 3 minimum
  2. Install the data validation library: pip install hestia_earth.utils
  3. Run:
hestia-pivot-csv source.csv dest.csv

The dest.csv file will be pivoted.

Hestia Calculation Models

Hestia Calculation Models

The Calculation Models are a set of modules for creating structured data models from LCA observations and evaluating biogeochemical aspects of specific farming cycles.

Usage

Usage

  1. You will need to use python 3 (we recommend using python 3.6 minimum).
  2. Install the library:
pip install hestia_earth.models
  1. Set the following environment variables:
API_URL="<APIUrl>"
WEB_URL="<WEBUrl>"

Now you can scroll to the model you are interested in and follow the instructions to run them.

Logging

Logging

The models library is shipped with it's own logging which will be displayed in the console by default. If you want to save the logs into a file, please set the LOG_FILENAME environment variable to the path of the file when running the models.

Example with a my_file.py file like:

from hestia_earth.models.pooreNemecek2018 import run

run('no3ToGroundwaterSoilFlux', cycle_data)

You can save the output in the models.log file by running LOG_FILENAME=models.log python my_file.py.

Orchestrator

Orchestrator

Hestia has developed a library to run the models in a specific sequence defined in a configuration file called the Hestia Engine Orchestrator.

Whereas when running a single model you would do:

from hestia_earth.models.pooreNemecek2018 import run

run('no3ToGroundwaterInorganicFertilizer', cycle_data)

You can run a sequence of models by doing instead:

from hestia_earth.orchestrator import run

config = {
  "models": [
    {
      "key": "emissions",
      "model": "pooreNemecek2018",
      "value": "no3ToGroundwaterInorganicFertilizer",
      "runStrategy": "add_blank_node_if_missing"
    },
    {
      "key": "emissions",
      "model": "pooreNemecek2018",
      "value": "no3ToGroundwaterOrganicFertilizer",
      "runStrategy": "add_blank_node_if_missing"
    }
  ]
}

run(cycle_data, config)

More information and examples are available in the Hestia Engine Orchestrator repository.

Agribalyse (2016)

Agribalyse (2016)

These models use data from the Agribalyse dataset to gap fill average values.

Fuel and Electricity

Fuel and Electricity

This model calculates fuel and electricity data from the number of hours each machine is operated for using.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.agribalyse2016 import run

print(run('fuelElectricity', Cycle))

View source on Gitlab

Machinery infrastructure, depreciated amount per Cycle

Machinery infrastructure, depreciated amount per Cycle

The quantity of machinery infrastructure, depreciated over its lifetime, divided by the area it operates over, and expressed in kilograms per functional unit per Cycle.

Machinery gradually depreciates over multiple production Cycles until it reaches the end of its life. As a rough rule, the more the machinery is used, the faster it depreciates. Machinery use can be proxied for by the amount of fuel used. From 139 processes in AGRIBALYSE, the ratio of machinery depreciated per unit of fuel consumed (kg machinery kg diesel–1) was established. Recognizing that farms in less developed countries have poorer access to capital and maintain farm machinery for longer, the machinery-to-diesel ratio was doubled in countries with a Human Development Index of less than 0.8.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.agribalyse2016 import run

print(run('machineryInfrastructureDepreciatedAmountPerCycle', Cycle))

View source on Gitlab

Akagi et al (2011) and IPCC (2006)

Akagi et al (2011) and IPCC (2006)

This model calculates the emissions from crop residue burning, using the methodology detailed in the IPCC (2006, Volume 4, Chapter 2, Section 2.4) guidelines and the emissions factors detailed in Akagi et al (2011, Atmos. Chem. Phys., 11, 4039–4072).

CH4, to air, crop residue burning

CH4, to air, crop residue burning

Methane emissions to air, from crop residue burning.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.akagiEtAl2011AndIpcc2006 import run

print(run('ch4ToAirCropResidueBurning', Cycle))

View source on Gitlab

N2O, to air, crop residue burning, direct

N2O, to air, crop residue burning, direct

Nitrous oxide emissions to air, from crop residue burning.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.akagiEtAl2011AndIpcc2006 import run

print(run('n2OToAirCropResidueBurningDirect', Cycle))

View source on Gitlab

NH3, to air, crop residue burning

NH3, to air, crop residue burning

Ammonia emissions to air, from crop residue burning.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.akagiEtAl2011AndIpcc2006 import run

print(run('nh3ToAirCropResidueBurning', Cycle))

View source on Gitlab

NOx, to air, crop residue burning

NOx, to air, crop residue burning

Nitrogen oxides emissions to air, from crop residue burning.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.akagiEtAl2011AndIpcc2006 import run

print(run('noxToAirCropResidueBurning', Cycle))

View source on Gitlab

AWARE

AWARE

This model characterises water use based on the geospatial AWARE model (see UNEP (2016); Boulay et al (2016); Boulay et al (2020); EC-JRC (2017)).

Scarcity weighted water use

Scarcity weighted water use

This model calculates the scarcity weighted water use based on the geospatial AWARE model (see UNEP (2016); Boulay et al (2016); Boulay et al (2020); EC-JRC (2017)).

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Different lookup files are used depending on the situation:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.aware import run

print(run('scarcityWeightedWaterUse', ImpactAssessment))

View source on Gitlab

Blonk Consultants (2016)

Blonk Consultants (2016)

This model calculates the land transformation and emissions related to land use change, using the Blonk Consultants (2016) direct land use change assessment model.

CH4, to air, natural vegetation burning

CH4, to air, natural vegetation burning

Methane emissions to air, from natural vegetation burning during deforestation or other land conversion.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.blonkConsultants2016 import run

print(run('ch4ToAirNaturalVegetationBurning', Cycle))

View source on Gitlab

CO2, to air, soil carbon stock change

CO2, to air, soil carbon stock change

Carbon dioxide emissions to air, from soil carbon stock change.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.blonkConsultants2016 import run

print(run('co2ToAirSoilCarbonStockChange', Cycle))

View source on Gitlab

Land transformation, from forest, 20 year average, during Cycle

Land transformation, from forest, 20 year average, during Cycle

The amount of land used by this Cycle, that changed use from forest to the current use in the last 20 years, divided by 20.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.blonkConsultants2016 import run

print(run('landTransformationFromForest20YearAverage', ImpactAssessment))

View source on Gitlab

N2O, to air, natural vegetation burning, direct

N2O, to air, natural vegetation burning, direct

Direct nitrous oxide emissions to air, from natural vegetation burning during deforestation or other land conversion.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.blonkConsultants2016 import run

print(run('n2OToAirNaturalVegetationBurningDirect', Cycle))

View source on Gitlab

Chaudhary Brooks (2018)

Chaudhary Brooks (2018)

This model calculates the biodiversity impacts related to habitat loss, accounting for different land use intensities, as defined in Chaudhary & Brooks (2018, Environ. Sci. Technol. 52, 9, 5094–5104).

Damage to terrestrial ecosystems, land occupation

Damage to terrestrial ecosystems, land occupation

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to land occupation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Different lookup files are used depending on the situation:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.chaudharyBrooks2018 import run

print(run('damageToTerrestrialEcosystemsLandOccupation', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, land transformation

Damage to terrestrial ecosystems, land transformation

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to land transformation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Different lookup files are used depending on the situation:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.chaudharyBrooks2018 import run

print(run('damageToTerrestrialEcosystemsLandTransformation', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, total land use effects

Damage to terrestrial ecosystems, total land use effects

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to land occupation and transformation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.chaudharyBrooks2018 import run

print(run('damageToTerrestrialEcosystemsTotalLandUseEffects', ImpactAssessment))

View source on Gitlab

Chaudhary et al (2015)

Chaudhary et al (2015)

This model calculates the biodiversity impacts related to habitat loss as defined in Chaudhary et al (2015, Environ. Sci. Technol. 49, 16, 9987–9995).

CML2001 Baseline

CML2001 Baseline

These models characterise emissions and resource use according to the CML2001 Baseline method (see Guinée et al. 2002; Jenkin & Hayman, 1999; Derwent et al. 1998, Huijbregts, 1999).

Eutrophication potential, excluding fate

Eutrophication potential, excluding fate

The potential of nutrient emissions to cause excessive growth of aquatic plants and algae in aquatic ecosystems.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cml2001Baseline import run

print(run('eutrophicationPotentialExcludingFate', ImpactAssessment))

View source on Gitlab

Terrestrial acidification potential, including fate, average Europe

Terrestrial acidification potential, including fate, average Europe

Changes in soil chemical properties following the deposition of nitrogen and sulfur in acidifying forms, including average fate of the emissions in Europe.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cml2001Baseline import run

print(run('terrestrialAcidificationPotentialIncludingFateAverageEurope', ImpactAssessment))

View source on Gitlab

CML2001 Non-Baseline

CML2001 Non-Baseline

These models characterise emissions and resource use according to the CML2001 Non-Baseline method (see Guinée et al. 2002; Jenkin & Hayman, 1999; Derwent et al. 1998, Huijbregts, 1999).

Eutrophication potential, including fate, average Europe

Eutrophication potential, including fate, average Europe

The potential of nutrient emissions to cause excessive growth of aquatic plants and algae in aquatic ecosystems, including an estimated fate of these emissions in Europe.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cml2001NonBaseline import run

print(run('eutrophicationPotentialIncludingFateAverageEurope', ImpactAssessment))

View source on Gitlab

Terrestrial acidification potential, excluding fate

Terrestrial acidification potential, excluding fate

Changes in soil chemical properties following the deposition of nitrogen and sulfur in acidifying forms, excluding average fate of the emissions in Europe.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cml2001NonBaseline import run

print(run('terrestrialAcidificationPotentialExcludingFate', ImpactAssessment))

View source on Gitlab

Cycle

Cycle

These models are specific to Cycle.

Above ground crop residue, total

Above ground crop residue, total

The total amount of above ground crop residue as dry matter. This total is the value prior to crop residue management practices (for example, burning or removal). Properties can be added, such as the nitrogen composition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('aboveGroundCropResidueTotal', Cycle))

View source on Gitlab

Cold carcass weight per head

Cold carcass weight per head

The average cold carcass weight of the animals per head.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('coldCarcassWeightPerHead', Cycle))

View source on Gitlab

Cold dressed carcass weight per head

Cold dressed carcass weight per head

The cold dressed carcass weight (i.e., excluding offal and slaughter fats) of the animals per head.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('coldDressedCarcassWeightPerHead', Cycle))

View source on Gitlab

Concentrate feed Properties

Concentrate feed Properties

This model calculates all of the nutrient content values and dry matter values for a feed blend if we know the crops that went into the blend by taking a weighted average.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('concentrateFeed', Cycle))

View source on Gitlab

Cycle duration

Cycle duration

This model calculates the cycle duration using the cropping intensity for a single year.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('cycleDuration', Cycle))

View source on Gitlab

Animal feed

Animal feed

This model checks if the site is a cropland and updates the Data Completeness value.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('dataCompleteness', Cycle))

View source on Gitlab

Crop Residue

Crop Residue

This model checks if we have all the crop residue terms and updates the Data Completeness value.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('dataCompleteness', Cycle))

View source on Gitlab

Excreta management

Excreta management

This model checks if the site is a cropland and updates the Data Completeness value.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('dataCompleteness', Cycle))

View source on Gitlab

Material

Material

This model checks if the machinery Input has been added and updates the Data Completeness value.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('dataCompleteness', Cycle))

View source on Gitlab

Other

Other

This model checks if the seed or saplings Input has been added and updates the Data Completeness value.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('dataCompleteness', Cycle))

View source on Gitlab

Soil Amendments

Soil Amendments

This model checks if the soilPh from geospatial dataset is greater than 6.5 and updates the Data Completeness value.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('dataCompleteness', Cycle))

View source on Gitlab

Energy content (lower heating value)

Energy content (lower heating value)

The amount of heat released by combusting a specified quantity in a calorimiter. The combustion process generates water vapor, but the heat in the water vapour is not recovered and accounted for.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('energyContentLowerHeatingValue', Cycle))

View source on Gitlab

Excreta (kg)

Excreta (kg)

This model calculates the amount of excreta in kg based on the amount of excreta in kg N or kg Vs.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('excretaKgMass', Cycle))

View source on Gitlab

Excreta (kg N)

Excreta (kg N)

This model calculates the amount of excreta in kg N based on the amount of excreta in kg.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('excretaKgN', Cycle))

View source on Gitlab

Excreta (kg VS)

Excreta (kg VS)

This model calculates the amount of excreta in kg VS based on the amount of excreta in kg.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('excretaKgVs', Cycle))

View source on Gitlab

Feed conversion ratio (carbon)

Feed conversion ratio (carbon)

The feed conversion ratio (kg C of feed per kg of liveweight produced), based on the carbon content of the feed.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('feedConversionRatio', Cycle))

View source on Gitlab

Feed conversion ratio (dry matter)

Feed conversion ratio (dry matter)

The feed conversion ratio (kg of feed per kg of liveweight produced), based on the dry matter weight of the feed.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('feedConversionRatio', Cycle))

View source on Gitlab

Feed conversion ratio (energy)

Feed conversion ratio (energy)

The feed conversion ratio (MJ of feed per kg of liveweight produced), based on the energy content of the feed.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('feedConversionRatio', Cycle))

View source on Gitlab

Feed conversion ratio (fed weight)

Feed conversion ratio (fed weight)

The feed conversion ratio (kg of feed per kg of liveweight produced), based on the fed weight of the feed.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('feedConversionRatio', Cycle))

View source on Gitlab

Feed conversion ratio (nitrogen)

Feed conversion ratio (nitrogen)

The feed conversion ratio (kg N of feed per kg of liveweight produced), based on the nitrogen content of the feed.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('feedConversionRatio', Cycle))

View source on Gitlab

ecoinvent v3

ecoinvent v3

This model calculates background emissions related to the production of Inputs from the ecoinvent database, version 3.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('input.ecoinventV3', Cycle))

View source on Gitlab

Input Hestia Aggregated Data

Input Hestia Aggregated Data

This model adds impactAssessment to Input based on data which has been aggregated into country level averages. Note: to get more accurate impacts, we recommend setting the input.impactAssessment instead of the region-level averages using this model.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('input.hestiaAggregatedData', Cycle))

View source on Gitlab

Input Properties

Input Properties

This model adds properties to the Input when they are connected to another Cycle via the impactAssessment field.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('input.properties', Cycle))

View source on Gitlab

Input Value

Input Value

This model calculates the value of the Input by taking an average from the min and max values.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('input.value', Cycle))

View source on Gitlab

Irrigated

Irrigated

More than 25 mm of irrigation per year. The area irrigated can be specified as a percentage.

Irrigated

This model returns the Practice irrigated. Cycles are marked as fully irrigated if the sum of the irrigation Inputs is greater than 25mm per hectare (250m3 per hectare).

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('irrigated', Cycle))

View source on Gitlab

Live Animal

Live Animal

This model calculates the amount of live animal produced during a Cycle, based on the amount of animal product.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('liveAnimal', Cycle))

View source on Gitlab

Cycle Post Checks

Cycle Post Checks

List of models to run after any other model on an Cycle.

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import primary
from hestia_earth.models.cycle import post_checks

product = primary.run(cycle)
cycle = post_checks.run(cycle)
print(cycle)
Site

Site

This model is run only if the pre model has been run before. This model will restore the cycle.site as a "linked node" (i.e. it will be set with only @type, @id and name keys).

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run(Cycle))

View source on Gitlab

Cycle Pre Checks

Cycle Pre Checks

List of models to run before any other model on an Cycle.

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import primary
from hestia_earth.models.cycle import pre_checks

cycle = pre_checks.run(cycle)
product = primary.run(cycle)
print(product)
Site

Site

Some Cycle models need a full version of the linked Site to run. This model will fetch the complete version of the Site and include it.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run(Cycle))

View source on Gitlab

Start Date

Start Date

This model calculates the startDate from the endDate and cycleDuration.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run(Cycle))

View source on Gitlab

Product Currency

Product Currency

Converts all the currencies to USD using historical rates.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('product.currency', Cycle))

View source on Gitlab

Product Economic Value Share

Product Economic Value Share

This model quantifies the relative economic value share of each marketable Product in a Cycle. Marketable Products are all Products in the Glossary with the exception of crop residue not sold.

It works in the following order: 1. If revenue data are provided for all marketable products, the economicValueShare is directly calculated as the share of revenue of each Product; 2. If the primary product is a crop and it is the only crop Product, economicValueShare is assigned based on a lookup table containing typical global average economic value shares drawn from Poore & Nemecek (2018).

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Depending on the primary product termType:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('product.economicValueShare', Cycle))

View source on Gitlab

Product Price

Product Price

Sets the price of products to 0 in specific conditions: if the economicValueShare is 0, or for excreta.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('product.price', Cycle))

View source on Gitlab

Product Primary

Product Primary

Determines the primary product which is the product with the highest economicValueShare.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('product.primary', Cycle))

View source on Gitlab

Product Revenue

Product Revenue

This model calculates the revenue of each product by multiplying the yield with the revenue.

In the case the product value is 0, the revenue will be set to 0.

In the case the product price is 0, the revenue will be set to 0.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('product.revenue', Cycle))

View source on Gitlab

Product Value

Product Value

This model calculates the value of the Product by taking an average from the min and max values.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('product.value', Cycle))

View source on Gitlab

Ready-to-cook weight per head

Ready-to-cook weight per head

The ready-to-cook weight of the animals per head.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('readyToCookWeightPerHead', Cycle))

View source on Gitlab

Residue removed

Residue removed

The amount of crop residue removed.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('residueRemoved', Cycle))

View source on Gitlab

Site duration

Site duration

This model calculates the siteDuration on the Cycle to the same value as cycleDuration when only a single Site is present.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('siteDuration', Cycle))

View source on Gitlab

Transformations

Transformations

Returns the Emission from every Transformation to be added in the Cycle.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.cycle import run

print(run('transformation', Cycle))

View source on Gitlab

Dämmgen (2009)

Dämmgen (2009)

These models calculate direct and indirect greenhouse gas emissions from the German GHG inventory guidelines, Dämmgen (2009).

NOx, to air, excreta

NOx, to air, excreta

Nitrogen oxides emissions to air, from animal excreta.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.dammgen2009 import run

print(run('noxToAirExcreta', Cycle))

View source on Gitlab

de Ruijter et al (2010)

de Ruijter et al (2010)

This model calculates the NH3 emissions due to crop residue decomposition using the regression model in de Ruijter et al (2010, Atmospheric Environment, 44, 28, 3362-3368).

NH3, to air, crop residue decomposition

NH3, to air, crop residue decomposition

Ammonia emissions to air, from crop residue decomposition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.deRuijterEtAl2010 import run

print(run('nh3ToAirCropResidueDecomposition', Cycle))

View source on Gitlab

EMEA-EEA (2019)

EMEA-EEA (2019)

These models implements the methods in the EMEP-EEA Handbook (2019), including fuel combustion emissions (Part B, Chapter 1.A.4, page 22).

CO2, to air, fuel combustion

CO2, to air, fuel combustion

Carbon dioxide emissions to air, from the combustion of fuel.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.emeaEea2019 import run

print(run('co2ToAirFuelCombustion', Cycle))

View source on Gitlab

N2O, to air, fuel combustion, direct

N2O, to air, fuel combustion, direct

Nitrous oxide emissions to air, from the combustion of fuel.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.emeaEea2019 import run

print(run('n2OToAirFuelCombustionDirect', Cycle))

View source on Gitlab

NH3, to air, excreta

NH3, to air, excreta

Ammonia emissions to air, from animal excreta.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.emeaEea2019 import run

print(run('nh3ToAirExcreta', Cycle))

View source on Gitlab

NH3, to air, inorganic fertilizer

NH3, to air, inorganic fertilizer

Ammonia emissions to air, from inorganic fertilizer volatilization.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.emeaEea2019 import run

print(run('nh3ToAirInorganicFertilizer', Cycle))

View source on Gitlab

NOx, to air, fuel combustion

NOx, to air, fuel combustion

Nitrogen oxides emissions to air, from the combustion of fuel.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.emeaEea2019 import run

print(run('noxToAirFuelCombustion', Cycle))

View source on Gitlab

SO2, to air, fuel combustion

SO2, to air, fuel combustion

Sulfur dioxide emissions to air, from the combustion of fuel.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.emeaEea2019 import run

print(run('so2ToAirFuelCombustion', Cycle))

View source on Gitlab

EPA (2014)

EPA (2014)

These models calculate direct and indirect greenhouse gas emissions using the methodology detailed in the EPA (2014) guidelines, EPA (2014) guidelines.

NO3, to groundwater, excreta

NO3, to groundwater, excreta

Nitrate leaching to groundwater, from animal excreta.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.epa2014 import run

print(run('no3ToGroundwaterExcreta', Cycle))

View source on Gitlab

FAOSTAT (2018)

FAOSTAT (2018)

These models uses data from the FAOSTAT database (accessed in 2018) to gap fill values like seed based on crop yield.

Cold carcass weight per head

Cold carcass weight per head

The average cold carcass weight of the animals per head.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('coldCarcassWeightPerHead', Cycle))

View source on Gitlab

Cold dressed carcass weight per head

Cold dressed carcass weight per head

The cold dressed carcass weight (i.e., excluding offal and slaughter fats) of the animals per head.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('coldDressedCarcassWeightPerHead', Cycle))

View source on Gitlab

Land transformation, from temporary cropland, 100 year average, during Cycle

Land transformation, from temporary cropland, 100 year average, during Cycle

The amount of land used by this Cycle, that changed use from temporary cropland to the current use in the last 100 years, divided by 100.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('landTransformationFromCropland100YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from temporary cropland, 20 year average, during Cycle

Land transformation, from temporary cropland, 20 year average, during Cycle

The amount of land used by this Cycle, that changed use from temporary cropland to the current use in the last 20 years, divided by 20.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('landTransformationFromCropland20YearAverage', ImpactAssessment))

View source on Gitlab

Liveweight per head

Liveweight per head

The liveweight of the animals per head.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('liveweightPerHead', Cycle))

View source on Gitlab

Product Price

Product Price

Calculates the price of crop and liveAnimal using FAO data.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Depending on the primary product termType:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('product.price', Cycle))

View source on Gitlab

Ready-to-cook weight per head

Ready-to-cook weight per head

The ready-to-cook weight of the animals per head.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('readyToCookWeightPerHead', Cycle))

View source on Gitlab

Seed

Seed

The seed of a crop.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.faostat2018 import run

print(run('seed', Cycle))

View source on Gitlab

Global Crop Water Model (2008)

Global Crop Water Model (2008)

This model adds rooting depths based on the Global Crop Water Model Siebert and Doll (2008).

Rooting depth

Rooting depth

The rooting depth of the crop.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.globalCropWaterModel2008 import run

print(run('rootingDepth', Cycle))

View source on Gitlab

HYDE 3.2

HYDE 3.2

This model uses the HYDE database v3.2 to calculate land use and land use change.

Land transformation, from cropland, 100 year average, during Cycle

Land transformation, from cropland, 100 year average, during Cycle

The amount of land used by this Cycle, that changed use from cropland (temporary and permanent) to the current use in the last 100 years, divided by 100.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromCropland100YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from cropland, 20 year average, during Cycle

Land transformation, from cropland, 20 year average, during Cycle

The amount of land used by this Cycle, that changed use from cropland (temporary and permanent) to the current use in the last 20 years, divided by 20.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromCropland20YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from forest, 100 year average, during Cycle

Land transformation, from forest, 100 year average, during Cycle

The amount of land used by this Cycle, that changed use from forest to the current use in the last 100 years, divided by 100.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromForest100YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from forest, 20 year average, during Cycle

Land transformation, from forest, 20 year average, during Cycle

The amount of land used by this Cycle, that changed use from forest to the current use in the last 20 years, divided by 20.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromForest20YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from other natural vegetation, 100 year average, during Cycle

Land transformation, from other natural vegetation, 100 year average, during Cycle

The amount of land used by this Cycle, that changed use from other natural vegetation to the current use in the last 100 years, divided by 100.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromOtherNaturalVegetation100YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from other natural vegetation, 20 year average, during Cycle

Land transformation, from other natural vegetation, 20 year average, during Cycle

The amount of land used by this Cycle, that changed use from other natural vegetation to the current use in the last 20 years, divided by 20.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromOtherNaturalVegetation20YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from permanent pasture, 100 year average, during Cycle

Land transformation, from permanent pasture, 100 year average, during Cycle

The amount of land used by this Cycle, that changed use from permanent pasture to the current use in the last 100 years, divided by 100.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromPermanentPasture100YearAverage', ImpactAssessment))

View source on Gitlab

Land transformation, from permanent pasture, 20 year average, during Cycle

Land transformation, from permanent pasture, 20 year average, during Cycle

The amount of land used by this Cycle, that changed use from permanent pasture to the current use in the last 20 years, divided by 20.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

One of (depending on site.siteType):

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.hyde32 import run

print(run('landTransformationFromPermanentPasture20YearAverage', ImpactAssessment))

View source on Gitlab

Impact Assessment

Impact Assessment

These models are specific to Impact Assessment.

Emissions

Emissions

Creates an Indicator for every Emission contained within the ImpactAssesment.cycle. It does this by dividing the Emission amount by the Product amount, and applying an allocation between co-products.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run('emissions', ImpactAssessment))

View source on Gitlab

Freshwater withdrawals, during Cycle

Freshwater withdrawals, during Cycle

Withdrawals of water from freshwater lakes, rivers, and aquifers that occur during the Cycle.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run('freshwaterWithdrawals', ImpactAssessment))

View source on Gitlab

Irrigated

Irrigated

Detects if the Cycle was irrigated.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run('irrigated', ImpactAssessment))

View source on Gitlab

Organic

Organic

Detects if the Cycle has an organic label.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run('organic', ImpactAssessment))

View source on Gitlab

Impact Assessment Post Checks

Impact Assessment Post Checks

List of models to run after any other model on an ImpactAssessment.

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import irrigated
from hestia_earth.models.impact_assessment import post_checks

impact['irrigated'] = irrigated.run(impact)
impact = post_checks.run(impact)
print(impact)
Cycle

Cycle

This model is run only if the pre model has been run before. This model will restore the impactAssessment.cycle as a "linked node" (i.e. it will be set with only @type, @id and name keys).

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run(ImpactAssessment))

View source on Gitlab

Site

Site

This model is run only if the pre model has been run before. This model will restore the impactAssessment.site as a "linked node" (i.e. it will be set with only @type, @id and name keys).

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run(ImpactAssessment))

View source on Gitlab

Impact Assessment Pre Checks

Impact Assessment Pre Checks

List of models to run before any other model on an ImpactAssessment.

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import irrigated
from hestia_earth.models.impact_assessment import pre_checks

impact = pre_checks.run(impact)
impact['irrigated'] = irrigated.run(impact)
print(impact)
Cycle

Cycle

Some ImpactAssessment models need a full version of the linked Cycle to run. This model will fetch the complete version of the Cycle and include it.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run(ImpactAssessment))

View source on Gitlab

Site

Site

Some ImpactAssessment models need a full version of the linked Site to run. This model will fetch the complete version of the Site and include it.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run(ImpactAssessment))

View source on Gitlab

Primary Product

Primary Product

The product of an ImpactAssessment is the primary product of the Cycle.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.impact_assessment import run

print(run('product', ImpactAssessment))

View source on Gitlab

IPCC (2006)

IPCC (2006)

These models, described in the IPCC (2006) guidelines, calculate direct and indirect greenhouse gas emissions and provide data for lookup tables.

Above ground crop residue, removed

Above ground crop residue, removed

The amount of above ground crop residue dry matter that was removed as part of the crop residue management practice.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('aboveGroundCropResidueRemoved', Cycle))

View source on Gitlab

Above ground crop residue, total

Above ground crop residue, total

The total amount of above ground crop residue as dry matter. This total is the value prior to crop residue management practices (for example, burning or removal). Properties can be added, such as the nitrogen composition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('aboveGroundCropResidueTotal', Cycle))

View source on Gitlab

Below ground crop residue

Below ground crop residue

The total amount of below ground crop residue as dry matter. Properties can be added, such as the nitrogen composition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('belowGroundCropResidue', Cycle))

View source on Gitlab

CO2, to air, organic soil cultivation

CO2, to air, organic soil cultivation

Carbon dioxide emissions to air, from organic soil (histosol) cultivation.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('co2ToAirOrganicSoilCultivation', Cycle))

View source on Gitlab

N2O, to air, crop residue decomposition, indirect

N2O, to air, crop residue decomposition, indirect

Nitrous oxide emissions to air, indirectly created from NOx, NH3, and NO3 emissions, from crop residue decomposition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirCropResidueDecompositionIndirect', Cycle))

View source on Gitlab

N2O, to air, excreta, direct

N2O, to air, excreta, direct

Nitrous oxide emissions to air, from animal excreta.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirExcretaDirect', Cycle))

View source on Gitlab

N2O, to air, excreta, indirect

N2O, to air, excreta, indirect

Nitrous oxide emissions to air, indirectly created from NOx and NH3 emissions, from animal excreta.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirExcretaIndirect', Cycle))

View source on Gitlab

N2O, to air, inorganic fertilizer, direct

N2O, to air, inorganic fertilizer, direct

Nitrous oxide emissions to air, from nitrification and denitrification of inorganic fertilizer.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirInorganicFertilizerDirect', Cycle))

View source on Gitlab

N2O, to air, inorganic fertilizer, indirect

N2O, to air, inorganic fertilizer, indirect

Nitrous oxide emissions to air, indirectly created from NOx, NH3, and NO3 emissions, from inorganic fertilizer.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirInorganicFertilizerIndirect', Cycle))

View source on Gitlab

N2O, to air, organic fertilizer, direct

N2O, to air, organic fertilizer, direct

Nitrous oxide emissions to air, from nitrification and denitrification of organic fertilizer.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirOrganicFertilizerDirect', Cycle))

View source on Gitlab

N2O, to air, organic fertilizer, indirect

N2O, to air, organic fertilizer, indirect

Nitrous oxide emissions to air, indirectly created from NOx, NH3, and NO3 emissions, from organic fertilizer.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirOrganicFertilizerIndirect', Cycle))

View source on Gitlab

N2O, to air, organic soil cultivation, direct

N2O, to air, organic soil cultivation, direct

Direct nitrous oxide emissions to air, from organic soil (histosol) cultivation.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2006 import run

print(run('n2OToAirOrganicSoilCultivationDirect', Cycle))

View source on Gitlab

IPCC (2013) excluding feedbacks

IPCC (2013) excluding feedbacks

These models, described in the IPCC (2013) guidelines, characterise different greenhouse gases into a global warming or global temperature potential. Conversions from each gas to CO2 equivalents exclude climate carbon feedbacks. Climate carbon feedbacks were not included in the IPCC (2007) or earlier guidelines, and were first provided in the IPCC (2013) guidelines in Table 8.7.

GWP100

GWP100

The global warming potential of mixed greenhouse gases on the mid-term climate (100 years), expressed as CO2 equivalents.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2013ExcludingFeedbacks import run

print(run('gwp100', ImpactAssessment))

View source on Gitlab

IPCC (2013) including feedbacks

IPCC (2013) including feedbacks

These models, described in the IPCC (2013) guidelines, characterise different greenhouse gases into a global warming or global temperature potential. Conversions from each gas to CO2 equivalents include climate carbon feedbacks. Climate carbon feedbacks were not included in the IPCC (2007) or earlier guidelines, and were first provided in the IPCC (2013) guidelines in Table 8.7.

GWP100

GWP100

The global warming potential of mixed greenhouse gases on the mid-term climate (100 years), expressed as CO2 equivalents.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2013IncludingFeedbacks import run

print(run('gwp100', ImpactAssessment))

View source on Gitlab

IPCC (2019)

IPCC (2019)

These models, described in the IPCC (2019) refinement to the IPCC (2006) guidelines, calculate direct and indirect greenhouse gas emissions and provide data for lookup tables.

Above ground crop residue, total

Above ground crop residue, total

The total amount of above ground crop residue as dry matter. This total is the value prior to crop residue management practices (for example, burning or removal). Properties can be added, such as the nitrogen composition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('aboveGroundCropResidueTotal', Cycle))

View source on Gitlab

Below ground crop residue

Below ground crop residue

The total amount of below ground crop residue as dry matter. Properties can be added, such as the nitrogen composition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('belowGroundCropResidue', Cycle))

View source on Gitlab

CH4, to air, enteric fermentation

CH4, to air, enteric fermentation

Methane emissions to air, from enteric fermentation by ruminants.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('ch4ToAirEntericFermentation', Cycle))

View source on Gitlab

CH4, to air, excreta

CH4, to air, excreta

Methane emissions to air, from animal excreta.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('ch4ToAirExcreta', Cycle))

View source on Gitlab

CH4, to air, flooded rice

CH4, to air, flooded rice

Methane emissions to air, from flooded paddy rice fields.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('ch4ToAirFloodedRice', Cycle))

View source on Gitlab

CO2, to air, lime hydrolysis

CO2, to air, lime hydrolysis

Carbon dioxide emissions to air, from lime hydrolysis (including dolomitic lime).

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('co2ToAirLimeHydrolysis', Cycle))

View source on Gitlab

CO2, to air, urea hydrolysis

CO2, to air, urea hydrolysis

Carbon dioxide emissions to air, from urea hydrolysis (a corresponding negative emission occurs during fertilizer production).

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('co2ToAirUreaHydrolysis', Cycle))

View source on Gitlab

Cropping duration

Cropping duration

For temporary crops, the period from planting to harvest in days. For perennial crops such as asparagus, the period from planting to removal in days. For transplant rice and other crops with a nursery stage, cropping duration excludes the nursery stage.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('croppingDuration', Cycle))

View source on Gitlab

N2O, to air, crop residue decomposition, direct

N2O, to air, crop residue decomposition, direct

Nitrous oxide emissions to air, from crop residue decomposition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('n2OToAirCropResidueDecompositionDirect', Cycle))

View source on Gitlab

N2O, to air, excreta, direct

N2O, to air, excreta, direct

Nitrous oxide emissions to air, from animal excreta.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('n2OToAirExcretaDirect', Cycle))

View source on Gitlab

Nitrogen content

Nitrogen content

The total nitrogen content of something, as N, expressed as a percentage.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.ipcc2019 import run

print(run('nitrogenContent', Cycle))

View source on Gitlab

Koble (2014)

Koble (2014)

This model estimates the amount of crop residue burnt and removed using country average factors for different crop groupings. The data are described in The Global Nitrous Oxide Calculator – GNOC – Online Tool Manual.

Above Ground Crop Residue

Above Ground Crop Residue

This model returns the amounts and destinations of above ground crop residue, working in the following order: 1. Above ground crop residue, removed; 2. Above ground crop residue, incorporated; 3. Above ground crop residue, burnt; 4. Above ground crop residue, left on field.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.koble2014 import run

print(run('aboveGroundCropResidue', Cycle))

View source on Gitlab

Residue burnt

Residue burnt

The amount of crop residue burnt, after multiplication by the combustion factor (which allows for residue burnt but not combusted).

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.koble2014 import run

print(run('residueBurnt', Cycle))

View source on Gitlab

Residue left on field

Residue left on field

The amount of crop residue left on field.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.koble2014 import run

print(run('residueLeftOnField', Cycle))

View source on Gitlab

Residue removed

Residue removed

The amount of crop residue removed.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.koble2014 import run

print(run('residueRemoved', Cycle))

View source on Gitlab

LC-Impact (all effects, 100 years)

LC-Impact (all effects, 100 years)

These models characterise emissions and resource use according to the methods defined by the LC-Impact working group. All the effects caused by an impact category that are known to damage one or more areas of protection are considered, and the time horizon is 100 years.

Damage to freshwater ecosystems, climate change

Damage to freshwater ecosystems, climate change

The fraction of species richness that may be potentially lost in freshwater ecosystems due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToFreshwaterEcosystemsClimateChange', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, freshwater ecotoxicity

Damage to freshwater ecosystems, freshwater ecotoxicity

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToFreshwaterEcosystemsFreshwaterEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, freshwater eutrophication

Damage to freshwater ecosystems, freshwater eutrophication

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToFreshwaterEcosystemsFreshwaterEutrophication', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems (PDF*year)

Damage to freshwater ecosystems (PDF*year)

The fraction of freshwater species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToFreshwaterEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, water stress

Damage to freshwater ecosystems, water stress

The fraction of species richness that may be potentially lost in freshwater ecosystems due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToFreshwaterEcosystemsWaterStress', ImpactAssessment))

View source on Gitlab

Damage to human health

Damage to human health

The disability-adjusted life years lost in the human population.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealth', ImpactAssessment))

View source on Gitlab

Damage to human health, climate change

Damage to human health, climate change

The disability-adjusted life years lost in the human population due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealthClimateChange', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (cancerogenic)

Damage to human health, human toxicity (cancerogenic)

The disability-adjusted life years lost in the human population due to cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealthHumanToxicityCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (non-cancerogenic)

Damage to human health, human toxicity (non-cancerogenic)

The disability-adjusted life years lost in the human population due to non-cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealthHumanToxicityNonCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, particulate matter formation

Damage to human health, particulate matter formation

The disability-adjusted life years lost in the human population due to particulate matter formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealthParticulateMatterFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, photochemical ozone formation

Damage to human health, photochemical ozone formation

The disability-adjusted life years lost in the human population due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealthPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, stratospheric ozone depletion

Damage to human health, stratospheric ozone depletion

The disability-adjusted life years lost in the human population due to stratospheric ozone depletion. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealthStratosphericOzoneDepletion', ImpactAssessment))

View source on Gitlab

Damage to human health, water stress

Damage to human health, water stress

The disability-adjusted life years lost in the human population due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Different lookup files are used depending on the situation:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToHumanHealthWaterStress', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine ecotoxicity

Damage to marine ecosystems, marine ecotoxicity

The fraction of species richness that may be potentially lost in marine ecosystems due to marine ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToMarineEcosystemsMarineEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine eutrophication

Damage to marine ecosystems, marine eutrophication

The fraction of species richness that may be potentially lost in marine ecosystems due to marine eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToMarineEcosystemsMarineEutrophication', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems (PDF*year)

Damage to marine ecosystems (PDF*year)

The fraction of marine species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToMarineEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, climate change

Damage to terrestrial ecosystems, climate change

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToTerrestrialEcosystemsClimateChange', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems (PDF*year)

Damage to terrestrial ecosystems (PDF*year)

The fraction of terrestrial species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToTerrestrialEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, photochemical ozone formation

Damage to terrestrial ecosystems, photochemical ozone formation

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToTerrestrialEcosystemsPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial acidification

Damage to terrestrial ecosystems, terrestrial acidification

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial acidification. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToTerrestrialEcosystemsTerrestrialAcidification', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial ecotoxicity

Damage to terrestrial ecosystems, terrestrial ecotoxicity

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffects100Years import run

print(run('damageToTerrestrialEcosystemsTerrestrialEcotoxicity', ImpactAssessment))

View source on Gitlab

LC-Impact (all effects, infinite)

LC-Impact (all effects, infinite)

These models characterise emissions and resource use according to the methods defined by the LC-Impact working group. All the effects caused by an impact category that are known to damage one or more areas of protection are considered, and the time horizon is infinite.

Damage to freshwater ecosystems, climate change

Damage to freshwater ecosystems, climate change

The fraction of species richness that may be potentially lost in freshwater ecosystems due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsClimateChange', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, freshwater ecotoxicity

Damage to freshwater ecosystems, freshwater ecotoxicity

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsFreshwaterEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, freshwater eutrophication

Damage to freshwater ecosystems, freshwater eutrophication

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsFreshwaterEutrophication', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems (PDF*year)

Damage to freshwater ecosystems (PDF*year)

The fraction of freshwater species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, water stress

Damage to freshwater ecosystems, water stress

The fraction of species richness that may be potentially lost in freshwater ecosystems due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsWaterStress', ImpactAssessment))

View source on Gitlab

Damage to human health

Damage to human health

The disability-adjusted life years lost in the human population.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealth', ImpactAssessment))

View source on Gitlab

Damage to human health, climate change

Damage to human health, climate change

The disability-adjusted life years lost in the human population due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealthClimateChange', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (cancerogenic)

Damage to human health, human toxicity (cancerogenic)

The disability-adjusted life years lost in the human population due to cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealthHumanToxicityCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (non-cancerogenic)

Damage to human health, human toxicity (non-cancerogenic)

The disability-adjusted life years lost in the human population due to non-cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealthHumanToxicityNonCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, particulate matter formation

Damage to human health, particulate matter formation

The disability-adjusted life years lost in the human population due to particulate matter formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealthParticulateMatterFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, photochemical ozone formation

Damage to human health, photochemical ozone formation

The disability-adjusted life years lost in the human population due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealthPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, stratospheric ozone depletion

Damage to human health, stratospheric ozone depletion

The disability-adjusted life years lost in the human population due to stratospheric ozone depletion. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealthStratosphericOzoneDepletion', ImpactAssessment))

View source on Gitlab

Damage to human health, water stress

Damage to human health, water stress

The disability-adjusted life years lost in the human population due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Different lookup files are used depending on the situation:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToHumanHealthWaterStress', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine ecotoxicity

Damage to marine ecosystems, marine ecotoxicity

The fraction of species richness that may be potentially lost in marine ecosystems due to marine ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToMarineEcosystemsMarineEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine eutrophication

Damage to marine ecosystems, marine eutrophication

The fraction of species richness that may be potentially lost in marine ecosystems due to marine eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToMarineEcosystemsMarineEutrophication', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems (PDF*year)

Damage to marine ecosystems (PDF*year)

The fraction of marine species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToMarineEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, climate change

Damage to terrestrial ecosystems, climate change

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsClimateChange', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems (PDF*year)

Damage to terrestrial ecosystems (PDF*year)

The fraction of terrestrial species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, photochemical ozone formation

Damage to terrestrial ecosystems, photochemical ozone formation

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial acidification

Damage to terrestrial ecosystems, terrestrial acidification

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial acidification. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsTerrestrialAcidification', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial ecotoxicity

Damage to terrestrial ecosystems, terrestrial ecotoxicity

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactAllEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsTerrestrialEcotoxicity', ImpactAssessment))

View source on Gitlab

LC-Impact (certain effects, 100 years)

LC-Impact (certain effects, 100 years)

These models characterise emissions and resource use according to the methods defined by the LC-Impact working group. Only the effects caused by an impact category that are known to damage one or more areas of protection with a high level of robustness are considered, and the time horizon is 100 years.

Damage to freshwater ecosystems, freshwater ecotoxicity

Damage to freshwater ecosystems, freshwater ecotoxicity

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToFreshwaterEcosystemsFreshwaterEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, freshwater eutrophication

Damage to freshwater ecosystems, freshwater eutrophication

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToFreshwaterEcosystemsFreshwaterEutrophication', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems (PDF*year)

Damage to freshwater ecosystems (PDF*year)

The fraction of freshwater species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToFreshwaterEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, water stress

Damage to freshwater ecosystems, water stress

The fraction of species richness that may be potentially lost in freshwater ecosystems due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToFreshwaterEcosystemsWaterStress', ImpactAssessment))

View source on Gitlab

Damage to human health

Damage to human health

The disability-adjusted life years lost in the human population.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealth', ImpactAssessment))

View source on Gitlab

Damage to human health, climate change

Damage to human health, climate change

The disability-adjusted life years lost in the human population due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealthClimateChange', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (cancerogenic)

Damage to human health, human toxicity (cancerogenic)

The disability-adjusted life years lost in the human population due to cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealthHumanToxicityCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (non-cancerogenic)

Damage to human health, human toxicity (non-cancerogenic)

The disability-adjusted life years lost in the human population due to non-cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealthHumanToxicityNonCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, particulate matter formation

Damage to human health, particulate matter formation

The disability-adjusted life years lost in the human population due to particulate matter formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealthParticulateMatterFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, photochemical ozone formation

Damage to human health, photochemical ozone formation

The disability-adjusted life years lost in the human population due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealthPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, stratospheric ozone depletion

Damage to human health, stratospheric ozone depletion

The disability-adjusted life years lost in the human population due to stratospheric ozone depletion. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealthStratosphericOzoneDepletion', ImpactAssessment))

View source on Gitlab

Damage to human health, water stress

Damage to human health, water stress

The disability-adjusted life years lost in the human population due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Different lookup files are used depending on the situation:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToHumanHealthWaterStress', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine ecotoxicity

Damage to marine ecosystems, marine ecotoxicity

The fraction of species richness that may be potentially lost in marine ecosystems due to marine ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToMarineEcosystemsMarineEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine eutrophication

Damage to marine ecosystems, marine eutrophication

The fraction of species richness that may be potentially lost in marine ecosystems due to marine eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToMarineEcosystemsMarineEutrophication', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems (PDF*year)

Damage to marine ecosystems (PDF*year)

The fraction of marine species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToMarineEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, climate change

Damage to terrestrial ecosystems, climate change

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToTerrestrialEcosystemsClimateChange', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems (PDF*year)

Damage to terrestrial ecosystems (PDF*year)

The fraction of terrestrial species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToTerrestrialEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, photochemical ozone formation

Damage to terrestrial ecosystems, photochemical ozone formation

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToTerrestrialEcosystemsPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial acidification

Damage to terrestrial ecosystems, terrestrial acidification

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial acidification. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToTerrestrialEcosystemsTerrestrialAcidification', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial ecotoxicity

Damage to terrestrial ecosystems, terrestrial ecotoxicity

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffects100Years import run

print(run('damageToTerrestrialEcosystemsTerrestrialEcotoxicity', ImpactAssessment))

View source on Gitlab

LC-Impact (certain effects, infinite)

LC-Impact (certain effects, infinite)

These models characterise emissions and resource use according to the methods defined by the LC-Impact working group. Only the effects caused by an impact category that are known to damage one or more areas of protection with a high level of robustness are considered, and the time horizon is infinite.

Damage to freshwater ecosystems, freshwater ecotoxicity

Damage to freshwater ecosystems, freshwater ecotoxicity

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsFreshwaterEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, freshwater eutrophication

Damage to freshwater ecosystems, freshwater eutrophication

The fraction of species richness that may be potentially lost in freshwater ecosystems due to freshwater eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsFreshwaterEutrophication', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems (PDF*year)

Damage to freshwater ecosystems (PDF*year)

The fraction of freshwater species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to freshwater ecosystems, water stress

Damage to freshwater ecosystems, water stress

The fraction of species richness that may be potentially lost in freshwater ecosystems due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToFreshwaterEcosystemsWaterStress', ImpactAssessment))

View source on Gitlab

Damage to human health

Damage to human health

The disability-adjusted life years lost in the human population.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealth', ImpactAssessment))

View source on Gitlab

Damage to human health, climate change

Damage to human health, climate change

The disability-adjusted life years lost in the human population due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealthClimateChange', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (cancerogenic)

Damage to human health, human toxicity (cancerogenic)

The disability-adjusted life years lost in the human population due to cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealthHumanToxicityCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, human toxicity (non-cancerogenic)

Damage to human health, human toxicity (non-cancerogenic)

The disability-adjusted life years lost in the human population due to non-cancerogenic toxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealthHumanToxicityNonCancerogenic', ImpactAssessment))

View source on Gitlab

Damage to human health, particulate matter formation

Damage to human health, particulate matter formation

The disability-adjusted life years lost in the human population due to particulate matter formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealthParticulateMatterFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, photochemical ozone formation

Damage to human health, photochemical ozone formation

The disability-adjusted life years lost in the human population due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealthPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to human health, stratospheric ozone depletion

Damage to human health, stratospheric ozone depletion

The disability-adjusted life years lost in the human population due to stratospheric ozone depletion. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealthStratosphericOzoneDepletion', ImpactAssessment))

View source on Gitlab

Damage to human health, water stress

Damage to human health, water stress

The disability-adjusted life years lost in the human population due to water stress. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Different lookup files are used depending on the situation:

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToHumanHealthWaterStress', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine ecotoxicity

Damage to marine ecosystems, marine ecotoxicity

The fraction of species richness that may be potentially lost in marine ecosystems due to marine ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToMarineEcosystemsMarineEcotoxicity', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems, marine eutrophication

Damage to marine ecosystems, marine eutrophication

The fraction of species richness that may be potentially lost in marine ecosystems due to marine eutrophication. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToMarineEcosystemsMarineEutrophication', ImpactAssessment))

View source on Gitlab

Damage to marine ecosystems (PDF*year)

Damage to marine ecosystems (PDF*year)

The fraction of marine species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToMarineEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, climate change

Damage to terrestrial ecosystems, climate change

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to climate change. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsClimateChange', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems (PDF*year)

Damage to terrestrial ecosystems (PDF*year)

The fraction of terrestrial species that are commited to become globally extinct over a certain period of time if the pressure continues to happen. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsPdfYear', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, photochemical ozone formation

Damage to terrestrial ecosystems, photochemical ozone formation

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to photochemical ozone formation. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsPhotochemicalOzoneFormation', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial acidification

Damage to terrestrial ecosystems, terrestrial acidification

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial acidification. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsTerrestrialAcidification', ImpactAssessment))

View source on Gitlab

Damage to terrestrial ecosystems, terrestrial ecotoxicity

Damage to terrestrial ecosystems, terrestrial ecotoxicity

The fraction of species richness that may be potentially lost in terrestrial ecosystems due to terrestrial ecotoxicity. See lc-impact.eu.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.lcImpactCertainEffectsInfinite import run

print(run('damageToTerrestrialEcosystemsTerrestrialEcotoxicity', ImpactAssessment))

View source on Gitlab

Linked Impact Assessment

Linked Impact Assessment

A model which takes recalculated data from an Impact Assessment linked to an Input in a Cycle.

Returns

Returns

Requirements

Requirements

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.linkedImpactAssessment import run

print(run('all', Cycle))
Hestia Engine Models Mocking

Hestia Engine Models Mocking

When deploying the calculations models on your own server, you might want to bypass any calls to the Hestia API. You can use this mocking functionality in that purpose.

from hestia_earth.models.pooreNemecek2018.aboveGroundCropResidueTotal import run
from hestia_earth.models.mocking import enable_mock

enable_mock()
run(cycle)

View source on Gitlab

Poore Nemecek (2018)

Poore Nemecek (2018)

These models implement the gap filling, emissions, and resource use models described in the supporting material of Poore & Nemecek (2018).

Above ground crop residue, total

Above ground crop residue, total

The total amount of above ground crop residue as dry matter. This total is the value prior to crop residue management practices (for example, burning or removal). Properties can be added, such as the nitrogen composition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.pooreNemecek2018 import run

print(run('aboveGroundCropResidueTotal', Cycle))

View source on Gitlab

Below ground crop residue

Below ground crop residue

The total amount of below ground crop residue as dry matter. Properties can be added, such as the nitrogen composition.

Returns

Returns

Requirements

Requirements

Lookup used

Lookup used

Usage

Usage

  1. Install the library: pip install hestia_earth.models
  2. Import the library and run the model:
from hestia_earth.models.pooreNemecek2018 import run

print(run('belowGroundCropResidue', Cycle))

View source on Gitlab

CH4, to air, aquaculture systems

CH4, to air, aquaculture systems

Methane emissions to air, from the methanogenesis of organic carbon in excreta, unconsumed feed, fertilizer, and net primary production. Reaches the air through diffusion and ebullition.

Returns

Returns

Requirements

Requirements