ECOSTRESS Collection 3 Granule Utilities
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.