Library · Noun reference
vegetation_index
A derived vegetation index; currently NDVI.
Quick facts
| Fact | Value |
|---|---|
| Semantic type | Derived vegetation index |
| Units by source | sentinel2: ndvi: 1 |
| Spatial coverage | Global land surfaces |
| Temporal resolution | scene acquisition; nominal five-day constellation revisit |
| Available source flavors | sentinel2 |
Usage
data.vegetation_index(*, source='sentinel2', index='ndvi', lat, lon, start, end, **kwargs)
Import with from cubedynamics import data. Keyword-only parameters and defaults above come from Python.
Available sources
| Source | Coverage | Resolution | Time | Selection constraint |
|---|---|---|---|---|
| sentinel2 | Global land surfaces | 10 m | 2015-present; scene acquisition; nominal five-day constellation revisit | NDVI is a greenness index, not a direct measurement of biomass. |
Returned data
An xarray.DataArray named ndvi, normally with time, y, x dimensions. time stores acquisition/observation times; y and x store grid coordinates in the declared CRS. Inspect the actual dimensions and CRS before combining sources.
Units are source-specific (above), not silently harmonized. Attributes include scientific_noun, source_flavor, source_variables, source_provider, source_product, spatial_query, temporal_query, crs, retrieved_at, data_state, and serving/schema provenance. See provenance helpers.
Minimal reproducible example
Network example: requires the provider and its optional dependencies. This is a real-data request, not an offline certification. For frozen inputs, use the reviewed notebooks.
from cubedynamics import data
import matplotlib.pyplot as plt
cube = data.vegetation_index(
source="sentinel2", lat=40.0, lon=-105.25,
start="2024-06-01", end="2024-06-03",
)
cube.isel(time=0).plot()
plt.show()
Quality and provenance
| Source | Lifecycle | Revision | Revision status | Live health | QA profile |
|---|---|---|---|---|---|
| sentinel2 | implemented | vegetation_index.sentinel2@2026-08-26.1 | VALIDATED | STALE | continuous_raster_static |
Revision validity is not a claim that the live endpoint is available today. Certification evidence distinguishes reviewed fixtures from live checks. Each source's selection constraint above remains part of the interpretation.