Skip to main content

ECOSTRESS Collection 3 Granule Utilities

CI

Gregory H. Halverson (they/them)
gregory.h.halverson@jpl.nasa.gov
NASA Jet Propulsion Laboratory 329G

ECOv003-granules is a Python library for working with ECOSTRESS Collection 3 data products. It opens granule files, identifies the product type, and exposes the metadata, geometry, and raster layers through product-specific wrapper classes.

open_granule(path) supports either an extracted granule directory or a ZIP archive. It recognizes the Collection 3 L1CT_RAD, L2T_LSTE, L2T_STARS, L3T_ETAUX, L3T_JET, L4T_ESI, and L4T_WUE products, and raises an explicit error for unsupported products, missing paths, invalid path types, or malformed ZIP archives. Tiled granules expose available TIFF layer filenames and variables from either storage format; an empty granule has no discovered layers.

ECOSTRESS Granules Data Layers

This document provides a detailed listing of the data layers available in the ECOSTRESS granules for various products, including L2T STARS, L3T ETAUX, L3T JET, L4T ESI, and L4T WUE.

L2T STARS NDVI & Albedo Product

Name Description Type Units Fill Value No Data Value Valid Min Valid Max Scale Factor Size
NDVI Normalized Difference Vegetation Index float32 Index NaN N/A -1 1 N/A 12.96 mb
NDVI-UQ NDVI Uncertainty float32 Index NaN N/A -1 1 N/A 12.96 mb
NDVI-bias NDVI Bias float32 Index NaN N/A N/A N/A N/A 12.96 mb
NDVI-bias-UQ NDVI Bias Uncertainty float32 Index NaN N/A N/A N/A N/A 12.96 mb
albedo Albedo float32 Ratio NaN N/A 0 1 N/A 12.96 mb
albedo-UQ Albedo Uncertainty float32 Ratio NaN N/A 0 1 N/A 12.96 mb
albedo-bias Albedo Bias float32 Ratio NaN N/A N/A N/A N/A 12.96 mb
albedo-bias-UQ Albedo Bias Uncertainty float32 Ratio NaN N/A N/A N/A N/A 12.96 mb

L3T ETAUX Ecosystem Auxiliary Inputs Product

Name Description Type Units Fill Value No Data Value Valid Min Valid Max Scale Factor Size
Ta Near-surface air temperature float32 $$^\circ\text{C}$$ NaN N/A N/A N/A N/A 9.83 MB
RH Relative Humidity float32 Ratio NaN N/A 0 1 N/A 9.83 MB
Rg Global Radiation float32 $$\text{W m}^{-2}$$ NaN N/A 0 N/A N/A 9.83 MB
Rn Net Radiation float32 $$\text{W m}^{-2}$$ NaN N/A 0 N/A N/A 9.83 MB
SM Soil Moisture float32 Ratio NaN N/A 0 1 N/A 9.83 MB
cloud Cloud mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB
water Water mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB

L3T JET Evapotranspiration Product

Name Description Type Units Fill Value No Data Value Valid Min Valid Max Scale Factor Size
PTJPLSMinst PT-JPL-SM Instantaneous float32 $$\text{W m}^{-2}$$ NaN N/A N/A N/A N/A 9.83 MB
PTJPLSMdaily PT-JPL-SM Daily float32 $$\text{mm day}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
STICJPLinst STIC-JPL Instantaneous float32 $$\text{W m}^{-2}$$ NaN N/A N/A N/A N/A 9.83 MB
STICJPLdaily STIC-JPL Daily float32 $$\text{mm day}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
BESSJPLdaily BESS-JPL Daily float32 $$\text{mm day}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
PMJPLdaily PM-JPL (MOD16) Daily float32 $$\text{mm day}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
ETdaily Daily Evapotranspiration float32 $$\text{mm day}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
ETuncertainty Daily Evapotranspiration Uncertainty float32 $$\text{mm day}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
PTJPLSMcanopy PT-JPL-SM Canopy float32 proportion NaN N/A N/A N/A N/A 9.83 MB
STICJPLcanopy STIC-JPL Canopy float32 proportion NaN N/A N/A N/A N/A 9.83 MB
PTJPLSMsoil PT-JPL-SM Soil float32 proportion NaN N/A N/A N/A N/A 9.83 MB
PTJPLSMinterception PT-JPL-SM Interception float32 proportion NaN N/A N/A N/A N/A 9.83 MB
cloud Cloud mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB
water Water mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB

L4T ESI Product

Name Description Type Units Fill Value No Data Value Valid Min Valid Max Scale Factor Size
ESI Evaporative Stress Index float32 Ratio NaN N/A 0 1 N/A 9.83 MB
PET Potential Evapotranspiration float32 $$\text{mm day}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
cloud Cloud mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB
water Water mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB

L4T WUE Product

Name Description Type Units Fill Value No Data Value Valid Min Valid Max Scale Factor Size
WUE Water Use Efficiency float32 $$\text{g C kg}^{-1} \text{H}_2\text{O}$$ NaN N/A 0 1 N/A 9.83 MB
GPP Gross Primary Production float32 $$\mu\text{mol m}^{-2} \text{s}^{-1}$$ NaN N/A N/A N/A N/A 9.83 MB
cloud Cloud mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB
water Water mask uint8 Mask 255 N/A 0 1 N/A 2.46 MB

Metadata

Release files for ECOv003-granules 1.14.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ECOv003-granules 1.14.0
File Size Uploaded Provenance Actions
ecov003_granules-1.14.0.tar.gz 28.7 kB Without provenance Details for ecov003_granules-1.14.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ECOv003-granules 1.14.0
File Interpreter ABI Platform Actions
ecov003_granules-1.14.0-py3-none-any.whl Python 3 none any Details for ecov003_granules-1.14.0-py3-none-any.whl

Total release size: 62.0 kB

Release files / ecov003_granules-1.14.0.tar.gz

Download URL ecov003_granules-1.14.0.tar.gz
Size 28.7 kB
Tags Source
SHA-256 checksum
How to use checksums
7f3ebff76e3a1ce855d11760f6e5a8452c093e99c37d1417786bca4012086419
BLAKE2b-256 checksum
How to use checksums
c97093e86160d2cb30d93aad04cd65d42c2fb4122aebb9e06d1db36587945af9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release files / ecov003_granules-1.14.0-py3-none-any.whl

Download URL ecov003_granules-1.14.0-py3-none-any.whl
Size 33.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b93364380c0b9283b15d1ba32c21e70bd8cf9a98af4c5349622786fa8d18abc5
BLAKE2b-256 checksum
How to use checksums
89fc0bd6f0fd2340d1879161f35a1e3c3478f0182e313e829f97973dcdcfeee5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Security for ECOv003-granules 1.14.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page