Within the Copernicus Data Space Ecosystem there are two STAC catalogues available:

1. Production catalogue available here: https://radiantearth.github.io/stac-browser/#/external/catalogue.dataspace.copernicus.eu/stac

2. Development catalogue available here: https://radiantearth.github.io/stac-browser/#/external/pgstac.demo.cloudferro.com

Sentinel-5P attributes to be discussed on 27.05.2024

Sentinel-5P Odata attributes
data type
to be
removed
target STAC extension
(in bold new attributes to be added)
STAC Counterpart
asset level
Description
Example STAC
Example Odata
beginningDateTimeDateTimeOffsetAttribute
attribute

start_datetime

datetime



2018-11-03T23:58:55.121559Z2024-05-17T00:23:29.000Z
endingDateTimeDateTimeOffsetAttribute
core STAC attributeend_datetime

2018-11-03T23:58:55.121559Z2024-05-17T00:27:08.000Z
instrumentShortNameStringAttribute
core STAC attributeinstruments

tropomiTROPOMI
orbitNumberIntegerAttribute
satsat:absolute_orbit

3415834158
parentIdentifierStringAttributeX




urn:ogc:def:EOP:ESA:SENTINEL.S5P_TROP_L2__NO2___
platformShortNameStringAttribute
core STAC attributeconstellation

sentinel-5pSENTINEL-5P
processingCenterStringAttribute
processingprocessing:facility
?pdgs-opPDGS-OP
processingDateDateTimeOffsetAttribute
processingprocessing:datetime

2018-11-03T23:58:55.121559Z2024-05-17T01:26:59.613000+00:00
processingLevelStringAttribute
processingprocessing:level

L2L2
processingModeStringAttribute
productproduct:timeliness
product:timeliness_category


PT3H

NRT

NRTI
processorNameStringAttributeX




TROPNLL2DP
processorVersionStringAttributeX


For Sentinel-5P  I believe the processing:version should be taken from the netCDF global attribute processor_version


20600
productTypeStringAttribute
product:typeproduct:type

L2__NO2___L2__NO2___

Sentinel-1 attributes to be discussed on 20.05.2024

Sentinel-1  Odata attributes
data type
to be
removed
target STAC extension
(in bold new attributes to be added)
STAC Counterpart
asset level
Description
Example STAC
Example Odata
beginningDateTimeDateTimeOffsetAttribute
core STAC attribute

start_datetime

datetime



2018-11-03T23:58:55.121559Z2024-05-14T00:06:28.688Z
completionTimeFromAscendingNodeDoubleAttribute
sat:anx_end_offset



238903.7
cycleNumberIntegerAttribute
sat:orbit_cyclesat:orbit_cycle


322
datatakeIDIntegerAttribute
EOPF



429004
endingDateTimeDateTimeOffsetAttribute
core STAC attributeend_datetime

2018-11-03T23:59:55.112875Z2024-05-14T00:06:53.687Z
instrumentConfigurationIDIntegerAttribute
EOPF



7
instrumentShortNameStringAttribute
core STAC attributeinstruments

sarSAR
operationalModeStringAttribute
sar:instrument_modesar:instrument_mode

IWIW
orbitDirectionStringAttribute
satsat:orbit_state

descendingASCENDING
orbitNumberIntegerAttribute
satsat:absolute_orbit

4276753860
originStringAttribute
processingprocessing:facility

production service-sercoESA
platformSerialIdentifierStringAttribute
core STAC attributeplatform

sentinel-1aA
platformShortNameStringAttribute
core STAC attributeconstellation

sentinel-1SENTINEL-1
polarisationChannelsStringAttribute
sar:polarizationssar:polarizations

'[VV,VH]'VV&VH
processingCenterStringAttribute
processingprocessing:facility

production service-sercoProduction Service-SERCO
processingDateDateTimeOffsetAttribute
processingprocessing:datetime


2024-05-14T08:04:12.593998+00:00
processingLevelStringAttribute
processingprocessing:level

L1LEVEL1
processorNameStringAttributeX
to be dropped


Sentinel-1 IPF
processorVersionStringAttributeX




3.71



processing:version (PR)processing:version (PR)

to be added in the future? what to do with s-1 baseline?




productClassStringAttributeX




S
productCompositionStringAttributeX




Slice/Slice-Partial
productTypeStringAttribute
product:type


IW_GRDH_1SIW_GRDH_1S



product:type

sar:product_type


to be moved to product:type (PR)

GRD 
relativeOrbitNumberIntegerAttribute
sat:relative_orbitsat:relative_orbit


63
segmentStartTimeDateTimeOffsetAttributeX




2024-05-14T00:05:09.988000+00:00
sliceNumberIntegerAttributeX




4
sliceProductFlagBooleanAttributeX




false
startTimeFromAscendingNodeDoubleAttribute
sat:anx_start_offset

milliseconds from anx crossing
213904.7
swathIdentifierStringAttributeX




IW
timelinessStringAttribute
productproduct:timeliness
product:timeliness_category


PT24H

Fast-24H

Fast-24h
totalSlicesIntegerAttributeX




20



sar:frequency_bandsar:frequency_band
collection level?C

Additional attributes for bursts:

burst attributesexampleto be added to STAC
linesPerBurst1493
samplesPerBurst21673
subswath"IW1" should be stringsar:subswaths_id
polarizationvhsar:polarizations
start line1493
azimuthTime2024-05-10T00:40:19.788314
sensingTime2024-05-10T00:40:19.788314

start_datetime

datetime

byteOffset129538967
burstId_relative8690 should be string used to be called frame_id

sar:relative_burst

burstId_absolute115560765
burstID_internal2



Sentinel-3 attributes to be discussed on 13.05.2024

Sentinel-3  Odata attributes
data type
to be
removed
target STAC extension
(in bold new attributes to be added)
STAC Counterpart
asset level
Description
Example STAC
Example Odata
baselineCollectionStringAttributeXXprocessing:version
OL__L1_.003.03.02,
reflected in the:
processing:version

003
beginningDateTimeDateTimeOffset

start_datetime

datetime

start_datetime

datetime



2023-07-10T00:47:16.702921Z2024-05-04T00:02:03.199Z
cloudCoverDoubleAttribute
?eo:cloud_cover

2828
coastalCoverDoubleAttributeX



10.009
cycleNumberIntegerAttribute
sat:orbit_cyclesat:orbit_cycle
The orbital cycle is 27 days (14+7/27 orbits per day, 385 orbits per cycle). The orbit cycle is the time taken for the satellite to pass over the same geographical point on the ground.
112
endingDateTimeDateTimeOffset
core STAC attributeend_datetime

2023-07-10T00:47:16.702921Z2024-05-04T00:05:03.199Z
freshInlandWaterCoverDoubleAttributeX
s3:fresh_inland_water

00
instrumentShortNameStringAttribute
core STAC attributeinstruments

olciOLCI
landCoverDoubleAttribute
?s3:land

22
operationalModeStringAttribute?


To be harmonized across missions
Earth Observation
orbitDirectionStringAttribute
satsat:orbit_state

descendingDESCENDING
orbitNumberIntegerAttribute
satsat:absolute_orbit

4276742767
platformSerialIdentifierStringAttribute
core STAC attributeplatform

sentinel-3aA
platformShortNameStringAttribute
core STAC attributeconstellation

sentinel-3SENTINEL-3
processingDateDateTimeOffset
processingprocessing:datetime

2023-07-10T00:47:16.702921Z2024-05-04T02:11:42+00:00
processingLevelStringAttribute
processingprocessing:level

L22
processorNameStringAttributeX


To be dropped and discussed with ESA experts.PUGPUG
processorVersionStringAttributeX

 





03.50
<sentinel3: processingBaseline>PB_ID.xxx.yy.zz </sentinel3: processingBaseline> from SAFE does not exists in Odata

processing:version

OL__L1_.003.03.02

OL - instrument

L1 - processing level 

003 - baselineCollection

03.02 - S3 processorVersion



To be discussed with Jordi. https://sentinels.copernicus.eu/web/sentinel/technical-guides/sentinel-3-olci/processing-baseline

<sentinel3: processingBaseline>PB_ID.xxx.yy.zz </sentinel3: processingBaseline>


<PB_ID> is unique and has as fixed format with 7 alphanumeric characters.
The definition of xxx.yy.zz version is the following:
xxx : baseline collection (starting from 002, 003 or 004 depending on the chain)
yy : minor changes in IPF or in static ADF (starting from zero for new baseline collection)
zz: changes in L0/PUG processing/task tables/PM or any other changes not expected to affect
the quality of the products (starting from zero when new baseline collection or minor change
is introduced). Only one PB_ID is applied on OLCI L1: e.g. in case of change of RAC or SPC
IPF which has no significant impact on product quality, zz shall be incremented.


productTypeStringAttribute
productproduct:type

OL_2_LFR___OL_2_LFR___
relativeOrbitNumberIntegerAttribute
sat:relative_orbitsat:relative_orbit

5959
salineWaterCoverDoubleAttributeX
s3:saline_water

442
tidalRegionCoverDoubleAttributeX
s3:tidal_region

20
timelinessStringAttribute
productproduct:timeliness
product:timeliness_category


PT3H

NR

NR

Sentinel-2 attributes to be discussed on 06.05.2024

Mappings not directly defined in the Sentinel extensions:

Sentinel-2  Odata attributes
data type
to be
removed
target STAC extension
(in bold new attributes to be added)
querable
STAC Counterpart
asset level
Description
Example STAC
Example Odata
mediaContentTypeStringAttributeX





application/octet-stream
IdStringAttributeX



Odata internal idX3e3b9d1a-18d5-43b8-83d8-564587ec3070
NameStringAttribute
id (core STAC attribute)Xs2:product_uri (to be removed)
product name. STAC "id" is without .SAFES2A_MSIL2A_20240308T100841_N0510_R022_T33UVR_20240308T143352S2B_MSIL2A_20240419T001429_N0510_R116_T56NNG_20240419T013152.SAFE
ContentTypeStringAttribute
core STAC attribute
typeXdiffers between Odata and STACimage/jp2application/octet-stream
ContentLengthIntegerAttribute
file
file:sizeXin bytes720970508720970508
OriginDateDateTimeOffsetAttribute
core STAC attributeX


into eopf

time of the publication at prip

2024-03-08T14:33:52.000000Z2024-04-19T02:13:20.000Z
PublicationDateDateTimeOffsetAttribute
core STAC attributeXpublished

2024-03-08T14:33:52.000000Z2024-04-19T02:20:17.555Z
ModificationDateDateTimeOffsetAttribute
core STAC attributeXupdated

2024-03-08T14:33:52.000000Z2024-04-19T02:21:14.300Z
ChecksumChecksum
file
file:checksumXBlake3/MD5 in Odata vs Multihash in STAC

ContentDate.StartDateTimeOffsetAttribute
core STAC attribute

X

datetime

start_datetime




2024-04-19T00:14:29.024Z
ContentDate.EndDateTimeOffsetAttribute
core STAC attributeXend_datetime




2024-04-19T00:14:29.024Z
Footprint
XXXX



GeoFootprint

core STAC attribute
geometry


"GeoFootprint":{"type":"Polygon","coordinates":
[[[153.9866661847601,0.945453049017732],
[153.9866661847601,0.945453049017732]]]}
originStringAttribute
processing
processing:facility


from manifest or EUMETSAT
cloudCoverDoubleAttribute
eoXeo:cloud_cover


14.583966
orbitNumberIntegerAttribute
sat
sat:absolute_orbit


37179
sourceProductStringAttributeX


 

S2B_OPER_MSI_L2A_TL_2BPS_20240419T013152_A037179_T56NNG_N05.10 S2B_OPER_MSI_L2A_DS_2BPS_20240419T013152_S20240419T001424_N05.10
processingLevelStringAttribute
processing
processing:level

L2S2MSI2A
platformShortNameStringAttribute
core STAC attribute
constellation

sentinel-2SENTINEL-2
instrumentShortNameStringAttribute
core STAC attribute
instruments

msiMSI
relativeOrbitNumberIntegerAttribute
satXsat:relative_orbit

22116
sourceProductOriginDateStringAttributeX



 
2024-04-19T02:13:20Z 2024-04-19T01:32:14Z
platformSerialIdentifierStringAttribute
core STAC attribute
platform

sentinel-2aA
beginningDateTimeDateTimeOffsetAttribute
core STAC attribute


start_datetime

datetime



2024-03-08T14:33:52.000000Z2024-04-19T00:14:29.024Z
endingDateTimeDateTimeOffsetAttribute
core STAC attribute
end_datetime

2024-03-08T14:33:52.000000Z2024-04-19T00:14:29.024Z
granuleIdentifierStringAttributeXNone
s2:granule_id (removed)

S2A_OPER_MSI_L2A_TL_2APS_20240308T143352_A045493_T33UVR_N05.10S2A_OPER_MSI_L2A_TL_2APS_20240308T143352_A045493_T33UVR_N05.10

Sentinel-2 STAC extension attributes to be discussed (not all present in Odata):

  • s2:generation_time (also in s1)
  • s2:datatake_id (also in s1)
  • s2:product_type (also in s1, s3, s5)
  • s2:tile_id
  • s2:product_uri
  • s2:datastrip_id
  • s2:datatake_type
  • s2:processing_baseline
  • s2:reflectance_conversion_factor

See the table below for details.

STAC Sentinel extensions

A priority should be to update the STAC Sentinel extensions to be less extensive at least. The plan is to find spaces in the general STAC community for these fields.
As a first step, we need to identify which fields are actually relevant to the general public.

General fields

For descriptions of the fields, please refer to the Sentinel extensions or the stactools-package implementations.

Idea is to keep a small variant of the Sentinel extensions as best practices, mostly using other extensions.
EOPF is for "private" fields that externals are not interested in.

Field nameData TypeRelevant to general public?
Potential future extension or field
Comments
Multi-Mission
s1:processing_datetime
s2:generation_time
date-timeYesprocessing:datetime (PR)OData: processingDate
S2 Example: 2024-04-19T01:31:52+00:00 (in STAC Z instead of +00:00)
s1:datatake_id
s2:datatake_id
stringYesto be included in the CDSE STAC and added to eopf extensionOData: productGroupId
S2 Example: GS2A_20240308T100841_045493_N05.10
s2:product_type
s3:product_type
s5p:product_type
stringNo?product:type

potentially restricted in s2 extension
What's the difference between name and type?
Can it be just one property, e.g. the name?
S2 example: S2MSI2A

s3:product_name
s5p:product_name
stringYes?
s1:product_timeliness
s3:processing_timeliness
stringYes?product:timeliness

potentially restricted in s2 extension

Can we find a common set of values for this? e.g. ISO 8601 Durations?
Sentinel-1 
s1:instrument_configuration_IDstringNo?

s1:orbit_sourcestringNo?

s1:product_identifierstring?externalIds?
s1:resolutionstringNo?

s1:slice_numberstringNo

s1:total_slicesstringNo

Sentinel-2 
s2:tile_idstringYes?

grid:code (querable)

and
mgrs:utm_zone (not querable)
mgrs:grid_square (not querable)
mgrs:latitude_band (not querable)

  • mgrs extention requires 3 fields (56, NN, G)
  • grid:code is one field (MGRS-56NNG)
  • Odata: tileId (56NNG)
s2:product_uristringNO To be removedNONEMight be needed in the S2 extension by some other users of the extensions.
s2:datastrip_idstringYes?EOPFOData field: datastripId
Example: S2A_OPER_MSI_L2A_DS_2APS_20240308T143352_S20240308T101546_N05.10
s2:datatake_typestringON HOLD similar to instrument_mode in the SAREOPFOData: operationalMode
Example: INS-NOBS
s2:processing_baselinestringYesprocessing:version (PR)OData: processorVersion, example: 5.1
STAC example: 05.10
s2:reflectance_conversion_factornumberTo be removedTo be removedExample: 1.01707999697991
Sentinel-3 
s3:gsdvariousNo?

to be dropped or used acrossed all missions

"gsd" STAC core attribute 


s3:lrm_modenumberYes?altm:instrument_type
s3:sar_modenumberYes?altm:instrument_mode
Sentinel-3 (Asset-level properties) 
s3:spatial_resolution (in assets)[number]?

raster:spatial_resolution as a single value?


s3:altimetry_bands (in assets)[Altimetry Band Object]?bands STAC core attribute in STAC 1.1
Sentinel-5 
s5p:processing_modestring?

s5p:collection_identifierstring?

s5p:spatial_resolution[number]?raster:spatial_resolution as a single value?
Sentinel-5 Container Objects 
s5p:aer_aiAer Ai ObjectFlatten into top-level propertiesNone
s5p:aer_lhAer Lh ObjectFlatten into top-level propertiesNone
s5p:ch4CH4 ObjectFlatten into top-level propertiesNone
s5p:cloudCloud ObjectFlatten into top-level propertiesNone
s5p:coCO ObjectFlatten into top-level propertiesNone
s5p:hchoHCHO ObjectFlatten into top-level propertiesNone
s5p:no2NO2 ObjectFlatten into top-level propertiesNone
s5p:npbd3NPBD ObjectFlatten into top-level propertiesNone
s5p:npbd6NPBD ObjectFlatten into top-level propertiesNone
s5p:npbd7NPBD ObjectFlatten into top-level propertiesNone
s5p:o3O2 ObjectFlatten into top-level propertiesNone
s5p:o3_tclO3 TCL ObjectFlatten into top-level propertiesNone
s5p:so2SO2 ObjectFlatten into top-level propertiesNone
Sentinel 5P Container Object Fields
These fields appear in at least one of the Sentinel-5 Container Objects above.


input_bandstring / [string]No

irradiance_accompaniedstringNo?

geolocation_grid_from_bandintegerNo?

cloud_modestringNo?

shape_ccd[integer]No?

shape_csa[integer]No?

stratosphere_start_datetimestring?

stratosphere_end_datetimestring?

troposphere_start_datetimestring?

troposphere_end_datetimestring?

input_orbits[integer]No?

input_files[string]No

analysed_s5p_bandintegerNo?

VIIRS_band[integer]No?

number_of_scaled_fovintegerNo?

Percentages

Field nameRelevant to general public?
Potential future extension or field
Comments
General and Other
 
s3:land?

s2:unclassified_percentageYes, not queryableclassification:classes[*].percentage
Clouds
 
s2:cloud_shadow_percentageYes, not queryable
classification:classes[*].percentage 
s2:high_proba_clouds_percentageYes, not queryableclassification:classes[*].percentage
s2:medium_proba_clouds_percentageYes, not queryableclassification:classes[*].percentage
s2:thin_cirrus_percentageYes, not queryableclassification:classes[*].percentage
Water and Coastal
 
s2:water_percentageYes, queryable
new: eo:water_cover ?
+ classification:classes[*].percentage

s3:closed_sea?

s3:fresh_inland_water?

s3:open_ocean?

s3:saline_water


s3:tidal_region?

s3:coastal?

s3:continental_ice?

Unusable 
s2:nodata_pixel_percentageYes, queryablenew: raster:nodata_percentage ?
+ classification:classes[*].percentage

s3:bright


s3:dubious_samples?

s3:duplicated?

s3:invalid


s3:out_of_range?

s2:dark_features_percentageYes, not queryableclassification:classes[*].percentage
s3:saturated
s2:saturated_defective_pixel_percentage
Yes, not queryableclassification:classes[*].percentage
Vegetation 
s2:vegetation_percentageYes, queryable?new: eo:vegetation_cover ?
+ classification:classes[*].percentage

s2:not_vegetated_percentageYes, not queryableclassification:classes[*].percentage

Depending on the asset structure, some percentages may be provided as a classification percentages as proposed in https://github.com/stac-extensions/classification/pull/49

Deprecated

For completeness, the following fields did exist in the past and are already deprecated in favor of existing STAC fields:

Field nameData TypeNew field name
s2:granule_idstringRemoved
s2:mgrs_tilestringmgrs:*
s2:mean_solar_zenithnumberview:sun_azimuth
s2:mean_solar_azimuthnumberview:sun_elevation
s2:snow_ice_percentage
s3:snow_or_ice
numbereo:snow_cover
s1:shape[integer]proj:shape
s1:processing_levelstringprocessing:level
s5p:shape[integer]proj:shape
s3:shape (in assets)[integer]proj:shape

CDSE querables attributes for Sentinel-2 L1C


CDSE STAC development roadmap


0. Simplify the geofootprint which is the largest attribute in the STAC response and slows down spatial querying (especially relevant for S-3 and S5P) ← to be provided by the Bureau d'Etude

1. Disable the overview displaying on items/assets level for selected collections e.g. Senitnel-3 where overviews generated in satellite projection is not displayed correctly. 

2. [Done at the collection level] Implement the CEOS-ARD extension for Level-2 and Level-3 products https://github.com/stac-extensions/ceos-ard First would be the Sentinel-2 L2A (stac item example https://github.com/stac-extensions/ceos-ard/blob/main/examples/optical-sr/item.json), then Sentinel-3 and Sentinel-5P products. There is no CEOS ARD for radar data yet. Currently it is only for CEOS ARD PFSes (so surface reflectance and temperature, and aquatic reflectance)

3. Populate the development catalogue with the Sentinel-2 L1C and L2A products and make the online version of the catalogue publicly available for testing

4. Add new collections based on the on the stac-tools for Sentinel-1 (https://github.com/stactools-packages/sentinel1), Sentinel-3 (https://github.com/stactools-packages/sentinel3), Sentinel-5P (https://github.com/stactools-packages/sentinel5p) These collections will conform to the new Sentinel's extensions: https://github.com/stac-extensions/sentinel-1 , https://github.com/stac-extensions/sentinel-3 ,  https://github.com/stac-extensions/sentinel-5p

4. Update ASAP current "more generic" extensions: EO, SAR, etc. Add new Sentinel collections excluding the Sentinel specific extensions.  

5. [In progress] Migrate some generic attributes from platform specific extension to more general extensions such as eo and sar. The rest of missions specific attributes (red crosses) should be maintained in the mission specific extensions not in the EOPF extension: https://github.com/CS-SI/eopf-stac-extension



7. Add to STAC Functionality of online/offline products. Add on demand product generation (url-s)

Missing STAC API functionalities to be potentially implemented in new STAC extensions

  • Hiding entire extensions in the https://github.com/stac-api-extensions/fields This could mimic the Odata $expand option for advanced, ESA internal extensions. 
  • Hiding items and assets within a Collection by an AOI
  • User levels and permissions to filter the Json response for general & expert CDSE users. 

Modification of current STAC extensions:



Various issues related to population of the STAC catalogue:

  1. NaN values in the Sentinel-2 viewing geometry: https://esa-cams.atlassian.net/browse/GSANOM-15086

    Coordination desk reply:

    This product is absolutely normal with respect to the current IPF implementation. It is really small as only few pixels from the datastrip intersect this tile as you can see in the CDSE and QGIS screenshots attached (the rainbow effect visible for the TCI displayed in QGIS is normal, and due to the fact that the different spectral bands do not share exactly the same footprint).

    A consequence of this very limited intersection between the tile footprint and the datastrip footprint is that we get only NaN viewing incidence values for several bands in the tile metadata, resulting in NaN mean viewing incidence values for these bands. This is because the grid on which the viewing incidence values are computed is very coarse (5 km x 5 km). Then this behaviour could happen sometimes for this kind of products (with limited intersection between the tile and the datastrip), and did happen before.

 


  • No labels
Write a comment…