Skip to content

Declare the EO extension on collections that use eo:bands - #382

Merged
DerekTan1 merged 2 commits into
mainfrom
tanderek/declare-eo-extension
Sep 29, 2026
Merged

DerekTan1 merged 2 commits into
mainfrom
tanderek/declare-eo-extension

Conversation

@DerekTan1

Copy link
Copy Markdown
Contributor

Description

Five collection templates describe their bands with eo:bands (in summaries and/or item_assets) but do not list the EO extension in stac_extensions:

  • sentinel-2-l2a (datasets/sentinel-2)
  • naip
  • planet-nicfi-analytic
  • planet-nicfi-visual
  • goes-cmi

Without the declaration, STAC validators skip those fields, and tools that key on the declared extension ignore the band metadata. For example, Microsoft Planetary Computer Pro GeoCatalogs only seed built-in band-index formulas (NDVI, NDWI, ...) for collections that declare EO, so mirrored copies of these collections get none today.

This adds https://stac-extensions.github.io/eo/v1.1.0/schema.json, the EO version most templates in this repo already use (10 on v1.1.0, 7 on v1.0.0). Each change is a one-line addition to stac_extensions; no other fields change.

aster-l1t has the same gap but is deliberately not included: its bands use common names outside the EO vocabulary (swir, near infrared, yellow/green), so declaring the extension would make it fail validation. Fixing those names is a separate data change.

Type of change

  • Bug fix (non-breaking change which fixes an issue)

How Has This Been Tested?

  • pctasks dataset validate-collection <template> passes for all five updated templates.
  • Negative control: the same command fails for aster-l1t with the extension added ('swir' is not one of [...]), confirming the validator checks the EO schema rather than passing everything.
  • Each template also validates against the EO v1.1.0 JSON schema directly with jsonschema.

Checklist:

  • I have performed a self-review

sentinel-2-l2a, naip, planet-nicfi-analytic, planet-nicfi-visual and goes-cmi
describe their bands with eo:bands in summaries and item_assets but do not list
the EO extension in stac_extensions. Validators therefore skip those fields, and
tools that key on the declared extension (for example, band-aware formula
defaults) ignore the band metadata. Declare EO v1.1.0, the version most
templates here already use. All five pass 'pctasks dataset validate-collection'.
@ghidalgo3

Copy link
Copy Markdown
Collaborator

Looks good, please go ahead and run the pctasks command to update these collections in the production database.

@DerekTan1
DerekTan1 marked this pull request as ready for review September 29, 2026 15:10
fws-nwi: fws_nwi:state and fws_nwi:state_code summaries
hls2-l30: scientific extension
hls2-s30: scientific extension and sci:doi
nasa-nex-gddp-cmip6: cmip6:model summary
sentinel-3-synergy-syn-l2-netcdf: eo:bands summary
@DerekTan1
DerekTan1 merged commit c74f998 into main Sep 29, 2026
5 of 6 checks passed
@DerekTan1
DerekTan1 deleted the tanderek/declare-eo-extension branch September 29, 2026 15:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants