Skip to content

Latest commit

 

History

History
86 lines (66 loc) · 6.11 KB

README.md

File metadata and controls

86 lines (66 loc) · 6.11 KB
Raw

Electro-Optical Extension Specification

  • Title: Electro-Optical
  • Identifier: eo
  • Field Name Prefix: eo
  • Scope: Item
  • Extension Maturity Classification: Proposal

This document explains the fields of the STAC Electro-Optical (EO) Extension to a STAC Item. EO data is considered to be data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands in any part of the electromagnetic spectrum. Examples of EO data include sensors with visible, short-wave and mid-wave IR bands (e.g., the OLI instrument on Landsat-8), long-wave IR bands (e.g. TIRS aboard Landsat-8).

If the data has been collected by a satellite, it is strongly recommended to use the sat extension, which in turn requires the Instrument Fields. If the data has been collected on an airborne platform it is strongly recommended to use the Instrument Fields.

For defining view geometry of data, it is strongly recommended to use the view extension.

Item fields

Field Name Type Description
eo:bands [Band Object] This is a list of the available bands where each item is a Band Object.
eo:cloud_cover number Estimate of cloud cover as a percentage (0-100) of the entire scene. If not available the field should not be provided.

eo:bands: In previous versions eo:bands was allowed to be used on the asset-level referencing via array indices to the actual bands in Item properties. Starting with STAC 1.0.0-beta.1 you are now allowed to place the full eo:bands array with all Band Object information in Item assets as described in general in the STAC Item.

Band Object

Field Name Type Description
name string The name of the band (e.g., "B01", "B02", "B1", "B5", "QA").
common_name string The name commonly used to refer to the band to make it easier to search for bands across instruments. See the list of accepted common names.
description string Description to fully explain the band. CommonMark 0.29 syntax MAY be used for rich text representation.
center_wavelength number The center wavelength of the band, in micrometers (μm).
full_width_half_max number Full width at half maximum (FWHM). The width of the band, as measured at half the maximum transmission, in micrometers (μm).

full_width_half_max (FWHM) is a common way to describe the size of a spectral band. It is the width, in micrometers (μm), of the bandpass measured at a half of the maximum transmission. Thus, if the maximum transmission of the bandpass was 80%, the FWHM is measured as the width of the bandpass at 40% transmission.

Common Band Names

The band's common_name is the name that is commonly used to refer to that band's spectral properties. The table below shows the common name based on the average band range for the band numbers of several popular instruments.

Common Name Band Range (μm) Landsat 5/7 Landsat 8 Sentinel 2 MODIS
coastal 0.40 - 0.45 1 1
blue 0.45 - 0.50 1 2 2 3
green 0.50 - 0.60 2 3 3 4
red 0.60 - 0.70 3 4 4 1
yellow 0.58 - 0.62
pan 0.50 - 0.70 8 (L7 only) 8
rededge 0.70 - 0.75
nir 0.75 - 1.00 4 8 2
nir08 0.75 - 0.90 5 8a
nir09 0.85 - 1.05 9
cirrus 1.35 - 1.40 9 10 26
swir16 1.55 - 1.75 5 6 11 6
swir22 2.10 - 2.30 7 7 12 7
lwir 10.5 - 12.5 6
lwir11 10.5 - 11.5 10 31
lwir12 11.5 - 12.5 11 32

The difference between the nir, nir08, and nir09 bands are that the nir band is a wider band that covers most of the spectral range of 0.75μm to 1.0μm. nir08 and nir09 are narrow bands centered 0.85μm and 0.95μm respectively. The same goes for the difference between lwir, lwir11 and lwir12.

Implementations

A number of implementations listed on STAC Examples on stacspec.org are making use of the core EO properties, including the SpaceNet, CBERS, sat-api and Planet implementations. This is not marked as more mature because the eo:bands portion is still being fleshed out.

Extensions

The extensions page gives an overview about related extensions. Of particular relevance to EO data: