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
Metadata
1 maintainer
Release files for hestia-earth-validation 0.41.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hestia_earth_validation-0.41.12.tar.gz | 79.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hestia_earth_validation-0.41.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 171.4 kB
Release files / hestia_earth_validation-0.41.12.tar.gz
| Download URL | hestia_earth_validation-0.41.12.tar.gz |
|---|---|
| Size | 79.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4fdd689afde8e8ede0f263bad02a8c6fb8d3a30ad378166686e4523130e0742f
|
|
BLAKE2b-256 checksum How to use checksums |
e85ee51eb1671b93ffde8fbc83e5a846c16b5f1d60124a5c5a63346275f5e0bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / hestia_earth_validation-0.41.12-py3-none-any.whl
| Download URL | hestia_earth_validation-0.41.12-py3-none-any.whl |
|---|---|
| Size | 92.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7c3fda93bb2efc0c8708e77b3bbcecca307eb097a3d45dce48d6b77a2d97b3c9
|
|
BLAKE2b-256 checksum How to use checksums |
f285000adb5decf33e2e7054b68f7993b1c4d1451c765a693d3c4739a024994f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
