diff --git a/CHANGELOG.md b/CHANGELOG.md index 6bb1ef1..3d4bdad 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Added +- Added new common names for `green05`, `rededge71`, `rededge75`, and `rededge78` +- More satellite mappings for the common names - `eo:cloud_cover` and `eo:snow_cover` can be used in bands - `eo:common_name`, `eo:center_wavelength`, `eo:full_width_half_max` and `eo:solar_illumination` can be used in Assets and Item Properties @@ -24,6 +26,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - `solar_illumination` has been renamed to `eo:solar_illumination` - The bands in Item Properties are not meant to be the union of the asset bands any longer You usually don't list bands in Item Properties any longer unless all assets have the same bands. +- Small changes to the band ranges in common names to be closer to the [Awesome Spectral Indices](https://github.com/awesome-spectral-indices/awesome-spectral-indices) ### Removed diff --git a/README.md b/README.md index 3342bca..3e8af4d 100644 --- a/README.md +++ b/README.md @@ -132,28 +132,35 @@ The band's `eo:common_name` is the name that is commonly used to refer to that b 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 | | +| 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.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`. +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 diff --git a/json-schema/schema.json b/json-schema/schema.json index 4728eb4..ffee4c9 100644 --- a/json-schema/schema.json +++ b/json-schema/schema.json @@ -176,13 +176,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",