Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 29 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,28 +138,35 @@ The band's `common_name` is the name that is commonly used to refer to that band
properties. The table below shows the allowed common names 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 | NAIP |
| ----------- | --------------- | ----------- | --------- | ---------- | ----- | ---- |
| coastal | 0.40 - 0.45 | | 1 | 1 | | |
| blue | 0.45 - 0.50 | 1 | 2 | 2 | 3 | 3 |
| green | 0.50 - 0.60 | 2 | 3 | 3 | 4 | 2 |
| red | 0.60 - 0.70 | 3 | 4 | 4 | 1 | 1 |
| yellow | 0.58 - 0.62 | | | | | |
| pan | 0.50 - 0.70 | 8 (*L7 only*) | 8 | | | |
| rededge | 0.70 - 0.79 | | | 5, 6, 7 | | |
| nir | 0.75 - 1.00 | 4 | | 8 | 2 | 4 |
| 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`.
| Common Name | Band Range (μm) | Landsat 5 TM / 7 ETM+ | Landsat 8 | Landsat Next | Sentinel-2 | Sentinel-3 OLCI / SLSTR | MODIS | NAIP | Planetscope | Worldview 2 / 3 |
| ----------- | --------------- | --------------------- | --------- | ------------ | ---------- | ----------------------- | ----- | ---- | ----------- | --------------- |
| pan | 0.40 - 1.00 | - / 8 | 8 | | | | | | | (1) |
| coastal | 0.40 - 0.45 | | 1 | 2 | 1 | 3 / - | | | 1 | 1 |
| blue | 0.45 - 0.53 | 1 | 2 | 3 | 2 | 4 / - | 3 | 3 | 2 | 2 |
| green | 0.51 - 0.60 | 2 | 3 | 4 | 3 | 6 / 1 | 4 | 2 | 4 | 3 |
| green05 | 0.51 - 0.55 | | | | | 5 / - | 11 | | 3 | |
| yellow | 0.58 - 0.62 | | | 5 | | 7 / - | | | 5 | 4 |
| red | 0.62 - 0.69 | 3 | 4 | 8 | 4 | 9 / 2 | 1 | 1 | 6 | 5 |
| rededge | 0.69 - 0.79 | | | | | | | | | 6 |
| rededge071 | 0.69 - 0.73 | | | 9 | 5 | 11 / - | | | 7 | |
| rededge075 | 0.73 - 0.76 | | | 10 | 6 | 12 / - | | | | |
| rededge078 | 0.76 - 0.79 | | | | 7 | 16 / - | | | | |
| nir | 0.76 - 1.00 | 4 / 8 | | 11 | 8 | | 2 | 4 | | 7 |
| nir08 | 0.80 - 0.90 | | 5 | 12 | 8a | 17 / 3 | | | 8 | |
| nir09 | 0.90 - 1.00 | | | 13 | 9 | 20 / - | | | | |
| cirrus | 1.35 - 1.40 | | 9 | 17 | 10 | - / 4 | 26 | | | |
| swir16 | 1.55 - 1.75 | 5 | 6 | 18 | 11 | - / 5 | 6 | | | |
| swir22 | 2.08 - 2.35 | 7 | 7 | 21 | 12 | - / 6 | 7 | | | |
| lwir | 10.4 - 12.5 | 6 | | | | | | | | |
| lwir11 | 10.5 - 11.5 | | 10 | 25 | | | 31 | | | |
| lwir12 | 11.5 - 12.5 | | 11 | 26 | | | 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.76μm to 1.0μm. `nir08` and `nir09` are narrow bands centered 0.85μm and 0.95μm
respectively. The same applies for all variants that have numerical suffixes, e.g. green, lwir and rededge.

Common band names should be uniquely assigned, i.e. there should never be two bands that share the same common
name in an Item or Collection.

## Best Practices

Expand Down
10 changes: 7 additions & 3 deletions json-schema/schema.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://stac-extensions.github.io/eo/v1.1.0/schema.json#",
"$id": "https://stac-extensions.github.io/eo/v1.2.0/schema.json#",
"title": "EO Extension",
"description": "STAC EO Extension for STAC Items.",
"oneOf": [
Expand Down Expand Up @@ -158,13 +158,17 @@
"title": "Common Name of the band",
"type": "string",
"enum": [
"pan",
"coastal",
"blue",
"green",
"green05",
"yellow",
"red",
"rededge",
"yellow",
"pan",
"rededge071",
"rededge075",
"rededge078",
"nir",
"nir08",
"nir09",
Expand Down