HESTIA Data Validation
Install
pip install hestia_earth_validation
Usage
from hestia_earth.validation.preload_requests import enable_preload
from hestia_earth.validation import validate
# enable request preloading
enable_preload()
# for each node, this will return a list containing all the errors/warnings (empty list if no errors/warnings)
errors = validate(nodes)
Note: if you want to validate existing data (with @type and @id fields), please set the following environment variable:
VALIDATE_EXISTING_NODES=true
Spatial validation
Some validations need geospatial data: whether a Site's coordinates fall inside the country or region it declares, how far outside they are, whether the region is small enough for the models to gap-fill, and whether the declared siteType matches the MODIS land cover there.
There are two ways to provide it, and either is enough:
# 1. the HESTIA Caching API, if it holds the land cover and GADM assets
VALIDATION_CACHING_API_URL=https://<host>/api
VALIDATION_CACHING_API_KEY=<token>
# 2. Earth Engine, which needs an account and credentials
pip install "hestia-earth-validation[spatial]"
The Caching API is preferred when it can answer, and anything it has no asset for still goes to Earth Engine — so the two combine rather than compete. MODELS_CACHING_API_* is read as a fallback for the variables above, which is what most deployments already set.
Set VALIDATE_SPATIAL=false to skip these validations entirely. Without either backend they are skipped anyway, with an error in the log: validating coordinates against data nobody can fetch would report every Site as being outside its own country.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hestia_earth_validation-0.41.3.tar.gz.
File metadata
- Download URL: hestia_earth_validation-0.41.3.tar.gz
- Upload date:
- Size: 72.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bd7eb8b5d21b61957076dc6b6439b19c2111611a3e15a69605d85869365048a8
|
|
| MD5 |
51bd7e95f1d1d96e9e34c49da589e9dd
|
|
| BLAKE2b-256 |
7a72efdcb23c1b978233f6e095150a80891e7c4f3108bf305048f86e22072d90
|
File details
Details for the file hestia_earth_validation-0.41.3-py3-none-any.whl.
File metadata
- Download URL: hestia_earth_validation-0.41.3-py3-none-any.whl
- Upload date:
- Size: 84.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f3273fc4b0a2bb60cfb4577c8852753d7068a8e75f9a47dbc8481fff51a663f
|
|
| MD5 |
2df228af7aeaee01d4ddd15df5195fa9
|
|
| BLAKE2b-256 |
d9b60db1c65b22338184be9cdcc98947452b50c3fbe3e87eebca86cda6f4626e
|
