Optical data#
You will find an optical tutorial here.
Implemented optical constellation#
The product resolution is the one given in Data Access Portfolio (2014-2022, section 6.2). The Data Access Portfolio Document presents the offer of the datasets and data access services that are made available to the Copernicus Users in response to their Earth Observation data requirements. However, especially for SAR data, the default pixel size of GRD bands is not the same as the product resolution!
Constellations |
Class |
Use archive |
---|---|---|
Sentinel-2 |
✅ |
|
Sentinel-2 on AWS cloud |
|
- |
Sentinel-2 Theia |
✅ |
|
Sentinel-3 SLSTR |
✅ |
|
Sentinel-3 OLCI |
✅ |
|
Landsat 8/9 OLI-TIRS |
✅ |
|
Landsat 7 ETM |
COL1*: ❌, COL2: ✅ |
|
Landsat 4/5 TM |
COL1*: ❌, COL2: ✅ |
|
Landsat 1-5 MSS |
COL1*: ❌, COL2: ✅ |
|
Harmonized Landsat-Sentinel |
✅ |
|
PlanetScope |
✅(❌ if multiple subdatasets) |
|
SkySat |
✅(❌ if multiple subdatasets) |
|
RapidEye |
✅(❌ if multiple subdatasets) |
|
Pleiades-Neo |
✅ |
|
Pleiades |
✅ |
|
Vision-1 |
✅ |
|
SPOT 4/5 |
✅ |
|
SPOT 6/7 |
✅ |
|
Maxar** |
✅ |
|
SuperView-1 |
✅ |
|
GEOSAT-2 |
✅ |
* Archived Landsat Collection-1 are not managed because of the tar.gz format, which is too slow to process. It is better to work on the extracted product. Landsat-9 Collection-1 products don’t exist.
** Maxar satellites: Worldview 2, 3, 4 and GeoEye-1 (but WorldView-1, QuickBird should work, however they don’t have been tested). The resolution can vary around the one given here.
Warning
Satellites products that cannot be used as archived have to be extracted before use.
Constellations |
Product Types |
Default Pixel Size |
---|---|---|
Sentinel-2 |
L1C & L2A & L2Ap |
10 m |
Sentinel-2 on AWS Cloud |
L2A (for now) |
10 m |
Sentinel-2 Theia |
L2A |
10 m |
Sentinel-3 SLSTR |
RBT |
300 m |
Sentinel-3 OLCI |
EFR |
500 m |
Landsat 8/9 OLI-TIRS |
Level 1 & 2 |
30 m |
Landsat 7 ETM |
Level 1 & 2 |
30 m |
Landsat 4/5 TM |
Level 1 & 2 |
30 m |
Landsat 1-5 MSS |
Level 1 |
60 m |
Harmonized Landsat-Sentinel |
L30 & S30 |
30 m |
PlanetScope |
L3A & L3B |
3 m |
SkySat |
(Collect Product) ortho_* |
0.5 m |
RapidEye |
L3A |
5 m |
Pleiades-Neo |
SEN**, PRJ, ORT & MOS |
0.3 m (PAN), 1.2 m (MS) |
Pleiades |
SEN**, PRJ, ORT & MOS |
0.5 m (PAN), 2 m (MS) |
Vision-1 |
PRJ & ORTP |
0.9 m (PAN), 3.5 m (MS) |
SPOT 4/5 |
L1A, L1B, L2A |
10 m (PAN), 20 m (MS) |
SPOT 6/7 |
SEN, PRJ, ORT & MOS |
1.5 m (PAN), 6 m (MS) |
Maxar* |
Standard & Ortho |
0.5 m (PAN), 2 m (MS) |
SuperView-1 |
L1B & L2A |
0.5 m (PAN), 2 m (MS) |
GEOSAT-2 |
L1B & L1C & L1D & L1S |
0.4 m (PAN), 2 m (MS) for L1D data |
* Maxar satellites: Worldview 2, 3, 4 and GeoEye-1 (but WorldView-1, QuickBird should work, however they don’t have been tested). The resolution can vary around the one given here.
** ⚠ DIMAP SEN products are orthorectified using RPCs and not the rigorous sensor model. Shift can occur. Please refer to this issue.
Note
Note that for the rest of this documentation:
HLS.S30 and Sentinel-2 data are equivalent (only 30m gsd).
HLS.L30 and Landsat-OLI-TIRS data are equivalent.
The goal of EOReader is to implement every constellation that can be used in the Copernicus Emergency Management Service.
The constellations that can be used during CEMS activations are (as of 09/2021):
Optical bands#
The following bands are available in EOReader, but may not be available for all constellations.
Warning
EOReader loads bands in UTM. VHR bands can be orthorectified but EOReader needs a DEM for that.
Be sure to position the environment variable EOREADER_DEM_PATH
to the DEM you want.
Satellite bands#
Note
Optical bands are always loaded in reflectance, except for brilliance temperature bands that are left as is.
However, the user can ask for bands “as is” by using the TO_REFLECTANCE
keyword with the load and stack functions.
It will give the bands in the provider format (either DN, radiance or reflactance in uint16…).
See the optical notebook to see how to implement it.
These bands will be cleaned according to the user’s needs. By default, only the pixels outside the detectors footprints are set to nodata. Methods to clean optical bands are best described in the notebook about the optical cleaning methods.
Band names#
These bands are mainly based on Sentinel-2 bands.
The names are the ones from Sentinel-2, even if sometimes it can be confusing (especially for Coastal Aerosol
and SWIR Cirrus
bands).
Some additions to the Sentinel-2 bands have been made (YELLOW
, PAN
…):
CA
: Coastal AerosolGREEN_1
: First Green band of PlanetScope 8 bands, mapped to the 5th band of Sentinel-3 OLCIVRE_1
: Vegetation Red Edge 1VRE_2
: Vegetation Red Edge 2VRE_3
: Vegetation Red Edge 3NIR
: Near InfraredNARROW_NIR
: Spectrally resolved Narrow Near Infrared (band8A
forSentinel-2
, same asNIR
for other sensors)WV
: Water vapourSWIR_CIRRUS
: Cirrus bandSWIR_1
: Short Wave Infrared 1SWIR_2
Short Wave Infrared 2PAN
: PanchromaticTIR_1
: Thermal Infrared 1TIR_2
: Thermal Infrared 2
Note
Note that bands that are not mapped can still be used (i.e. for Sentinel-3 OLCI and SLSTR).
They will be called by their true name (i.e. F1
or Oa05
). However,
the mapped band will have to be called with their mapped name, i.e. BLUE
rather than Oa04
for Sentinel-3 OLCI.
But the bands that are not present in the alias
file won’t be recognized.
Optical band mapping between constellations#
Bands (names) |
Coastal aerosol |
Blue |
Green I |
Green |
Yellow |
Red |
Vegetation red edge |
Vegetation red edge |
Vegetation red edge |
NIR |
Narrow NIR |
Water vapor |
SWIR – Cirrus |
SWIR |
SWIR |
Panchromatic |
Thermal IR |
Thermal IR |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Bands (alias) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Sentinel-2 |
1 (60m) |
2 (10m) |
3 (10m) |
4 (10m) |
5 (20m) |
6 (20m) |
7 (20m) |
8 (10m) |
8A (20m) |
9 (60m) |
10 (60m) |
11 (20m) |
12 (20m) |
|||||
Sentinel-2 Theia |
Not available |
2 (10m) |
3 (10m) |
4 (10m) |
5 (20m) |
6 (20m) |
7 (20m) |
8A (10m) |
8 (20m) |
Not available |
10 (60m) |
11 (20m) |
12 (20m) |
|||||
Sentinel-3 OLCI* |
3 (300m) |
4 (300m) |
5 (300m) |
6 (300m) |
7 (300m) |
8 (300m) |
11 (300m) |
12 (300m) |
16 (300m) |
17 (300m) |
17 (300m) |
20 (300m) |
||||||
Sentinel-3 SLSTR* |
1 (500m) |
2 (500m) |
3 (500m) |
3 (500m) |
4 (500m) |
5 (500m) |
6 (500m) |
8 (1km) |
9 (1km) |
|||||||||
Landsat OLI-TIRS (8-9) |
1 (30m) |
2 (30m) |
3 (30m) |
4 (30m) |
5 (30m) |
5 (30m) |
9 (30m) |
6 (30m) |
7 (30m) |
8 (15m) |
10 (100m) |
11 (100m) |
||||||
Landsat ETM (7) |
1 (30m) |
2 (30m) |
3 (30m) |
4 (30m) |
4 (30m) |
5 (30m) |
7 (30m) |
8 (15m) |
6 (60m) |
6 (60m) |
||||||||
Landsat TM (5-4) |
1 (30m) |
2 (30m) |
3 (30m) |
4(30m) |
4 (30m) |
5 (30m) |
7 (30m) |
6 (120m) |
6 (120m) |
|||||||||
Landsat MSS (5-4) |
1 (60m) |
2 (60m) |
3 (60m) |
3 (60m) |
3 (60m) |
4 (60m) |
4 (60m) |
|||||||||||
Landsat MSS (1-3) |
4 (60m) |
5 (60m) |
6 (60m) |
6 (60m) |
6 (60m) |
7 (60m) |
7 (60m) |
8 (240m) |
8 (240m) |
|||||||||
PlanetScope (4 bands) |
1 (3m) |
2 (3m) |
3 (3m) |
4 (3m) |
4 (3m) |
|||||||||||||
PlanetScope (5 bands) |
1 (3m) |
2 (3m) |
3 (3m) |
4 (3m) |
5 (3m) |
5 (3m) |
||||||||||||
PlanetScope (8 bands) |
1 (3m) |
2 (3m) |
3 (3m) |
4 (3m) |
5 (3m) |
6 (3m) |
7 (3m) |
8 (3m) |
8 (3m) |
|||||||||
SkySat |
1 (0.5m) |
2 (0.5m) |
3 (0.5m) |
4 (0.5m) |
4 (0.5m) |
|||||||||||||
RapidEye |
1 (5m) |
2 (5m) |
3 (5m) |
4 (5m) |
5 (5m) |
5 (5m) |
||||||||||||
Pleiades |
3 (0.5/2m) |
2 (0.5/2m) |
1 (0.5/2m) |
4 (0.5/2m) |
4 (0.5/2m) |
1 (0.5m) |
||||||||||||
Pleiades-Neo |
5 (0.3/1.2m) |
3 (0.3/1.2m) |
2 (0.3/1.2m) |
1 (0.3/1.2m) |
6 (0.3/1.2m) |
6 (0.3/1.2m) |
6 (0.3/1.2m) |
4 (0.3/1.2m) |
4 (0.3/1.2m) |
1 (0.5m) |
||||||||
SPOT-4 |
1 (10/20m) |
2 (10/20m) |
3 (10/20m) |
3 (10/20m) |
4 (10/20m) |
1 (10m) |
||||||||||||
SPOT-5 |
1 (2.5/5/10m) |
2 (2.5/5/10m) |
3 (2.5/5/10m) |
3 (2.5/5/10m) |
4 (2.5/5/10m) |
1 (2.5/5m) |
||||||||||||
SPOT-6/7 |
3 (1.5/6m) |
2 (1.5/6m) |
1 (1.5/6m) |
4 (1.5/6m) |
4 (1.5/6m) |
1 (0.5m) |
||||||||||||
Vision-1 |
1 (0.9/3.5m) |
2 (0.9/3.5m) |
3 (0.9/3.5m) |
4 (0.9/3.5m) |
4 (0.9/3.5m) |
1 (0.5m) |
||||||||||||
WorldView-1 |
1 (0.5m) |
|||||||||||||||||
WorldView-4, GeoEye-1, QuickBird |
1 (0.5m/2m) |
2 (0.5m/2m) |
3 (0.5m/2m) |
4 (0.5m/2m) |
4 (0.5m/2m) |
1 (0.5m) |
||||||||||||
WorldView-2/3 |
1 (0.5m/2m) |
2 (0.5m/2m) |
3 (0.5m/2m) |
4 (0.5m/2m) |
5 (0.5m/2m) |
6 (0.5m/2m) |
6 (0.5m/2m) |
6 (0.5m/2m) |
7 (0.5m/2m) |
7 (0.5m/2m) |
8 (0.5m/2m) |
1 (0.5m) |
||||||
Superview-1 |
1 (0.5m/2m) |
2 (0.5m/2m) |
3 (0.5m/2m) |
4 (0.5m/2m) |
4 (0.5m/2m) |
1 (0.5m) |
||||||||||||
GEOSAT-2 |
4 (0.4m/2m) |
3 (0.4m/2m) |
2 (0.4m/2m) |
1 (0.4m/2m) |
1 (0.4m/2m) |
1 (0.4m) |
* Not all bands of these constellations are mapped in EOReader. However, they can still be used by using directly their name (i.e. F1
or Oa05
)