This page aims to collect the comments on the Document "STAC Requirements and Recommendations for EOF Services", downloadable from this link;


RC 1 : CAP-TN-030-BE_STAC_Requirements_and_recommendations_for_EOF_services-1.0-RC1.pdf

RC 2 : CAP-TN-030-BE_STAC_Requirements_and_recommendations_for_EOF_services-1.0-RC2.pdf

RC 3 : CAP-TN-030-BE_STAC_Requirements_and_recommendations_for_EOF_services-1.0-RC3.pdf


Note: Comments from Yves Coene are available in this file: CAP-TN-030-BE_STAC_Requirements_and_recommendations_for_EOF_services-1.0-RC1-yc-v2-car.pdf



This document provides a set of common requirements and recommendations to be applicable by any EOF Service that will adopt STAC as the main API specification for the discovery and downloading of their products.
Each EOF Service will complete those common requirements by its own service-level ICD to address its specificities. 

Please, add your comments to the following table:

Id.AuthorSection/Page numberTitleStatus (Open / Fixed / Closed)Comment
1JMSTAC-CORE-GEN-REC-0020Use of mixed case in e.g. platform valuesClosed

Mis-alignment with the "searchable identifiers" recommendations here: https://github.com/radiantearth/stac-spec/blob/master/best-practices.md. Perhaps the recommendation should be that the naming follows GCMD but best practice for the case sensitivity is that of STAC.  (Open for discussion) → ok fixed to lowercase

I suggest though that any updated version simplifies the list to sentinel-1[a,b,c,d] and likewise for sentinel-2 and 3, also provides ellipsis ... since the requirement should be generic for the expansion missions and others.

2Mario Winkler (DLR)STAC-CORE-COL-REC-0110Collection IdentifierFixedThe specific collection names for each EOF Service should be defined in the corresponding EOF Service ICDs since the set of collections is known in advance. → this will be done in the specific ICD related to each individual EOF Service
3Mario Winkler (DLR)

STAC-CORE-COL-REC-0120

STAC-CORE-ITEM-REQ-0180

STAC-CORE-ITEM-REC-0190

Semantics of "created" and "published"

Closed

The semantics of the "created" and "published" properties may differ between the EOF services. This should be reflected in the individual EOF Service ICDs.

→ Yes noted.

4Mario Winkler (DLR)STAC-CORE-ITEM-REC-0190Additional timestamp information

Fixed

There is a difference between data not being valid and not being available any more. Maybe differentiate this by also using the "unpublished" property from the Timestamps extension.

→ ok, updated the requirement as followed:


STAC-CORE-ITEM-REC-0190 – Additional timestamp information [Recommendation]


EOF Service STAC implementations should encode any Item with the following properties, when relevant:

  • "created" Timestamp of the Item metadata creation, if different from the "published" property (specified by [STAC_ITEM_SPEC]),
  • "expires" Timestamp when the Item will no longer be available in the Catalog (specified by [STAC_TIMESTAMP_EXTENSION]).

"unpublished" Timestamp when the Item was unpublished (specified by [STAC_TIMESTAMP_EXTENSION]).


5Mario Winkler (DLR)STAC-API-ADVSRCH-CREQ-0630Set of fields returned by default

Closed

The default fields may differ between the various EOF Services and should be defined in the service-level ICDs.

→ Yes, it has to be specified at Service level ICD.

6Mario Winkler (DLR)

STAC-API-ADVSRCH-CREQ-0640

STAC-API-ADVSRCH-CREQ-0650

Empty or no "fields" directive

Closed

Maybe consider to allow an EOF Service to tailor this behavior e.g. to optimize query performance.

→ question submitted to the working group.

7Matthias Mohrvarious
Fixed
  • ✓ A link for the file info extension is missing → link added  
  • ✓ STAC-...-0020: All values should be lowercase as per STAC spec recommendation → ok fixed to lowercase
  • ✓ STAC-...-0060: "role": "metadata" is invalid STAC → ok fixed
  • ✓ STAC-...-0130: Two options are given but not detailed enough to decide which to use when. → keep only the via option
  • STAC-...-0160: It's unclear why start and end_datetime need to be provided as duplicate values. Discussed during STAC catchup → ok to keep this requirement as is
  • ✓ STAC-...-0290/0300/0310: This seems a bit ambiguous and confusing. Maybe linking to the newly added best practice (in STAC 1.1) around thumbnails and overviews may help. → ok replace requirements by recommendation from STAC 1.1 best practices 
  • ✓ STAC-...-0340/0350: "role"="data" is invalid STAC → ok fixed
  • STAC-...-0370: The extension is not stable at all and is likely to change drastically, a requirement seems not be a good idea at this point. → see comment
  • ✓ STAC-...-0440: A secret is not required in a web-browser based OIDC flow (not sure whether that's a usecase). → see comment
  • If the OGC API - Features conformance classes get implemented, you can't exclude the conformance and service-desc relation types → see comment
  • ✓ STAC-...-0590: The selection of JSON Schema properties is a little random?! see comment
8

Jan Musial

(CloudFerro)

page 4outdated STAC version FixedSTAC has been already released in version 1.1 beta (official release planned next week) so it would be beneficial to start with the most recent version instead of creating a technological backlog from the very beginning. Furthermore, the CDSE is implemented in v1.1. so PIRP in v 1.0 would not  compatible.

✓ The extensions versions should also match the ones used in the CDSE. → OK, Document is now aligned with STAC 1.1
9

Jan Musial

(CloudFerro)

STAC-CORE-ITEM-REQ-0250the ID does not match the Sentinel file naming convention without the exttension (i.e. ".SAFE") Decision needed if this is OK.

Closed

e.g. MMM_MSIXXX_YYYYMMDDHHMMSS_Nxxyy_ROOO_Txxxxx_<Product Discriminator>.SAFE

see: https://sentinels.copernicus.eu/en/web/sentinel/user-guides/sentinel-2-msi/naming-convention


10

Jan Musial

(CloudFerro)

STAC-CORE -ASSET-REQ-0370STAC storage extension is outdated and temporarily removed from CDSE STAC

Fixed

✓ not clear if the extension would be adjusted to meet CDSE requirements

to clarify how information provided by storage extension will be provided in CDSE implementation. See also comment to #7

 → reference to storage extension removed

11

Jan Musial

(CloudFerro)

STAC-API-SIMPSRCH-REQ-0520maximum allowed items per page not defined

Fixed

Added a recommendation to highlght the need to properly defined this parameter, considering a trade-off between client needs and technical constraints

STAC-API-SIMPSRCH-REC-0521 – Maximum page size [Recommendation]


EOF Service STAC implementation should carefully define the maximum number of items that could be returned, considering a trade-off between STAC Client needs and technical/performance constraints.


12

Jan Musial

(CloudFerro)

STAC-API- ADVSRCH-CREQ-0570maximum number of vertexes in querable geometry not defined.

Fixed

Not clear in the querable geometry can be a multipolygon?

Added following requirement:

STAC-API- ADVSRCH-CREQ-0571 – Limiting the number of vertexes in spatial query [Conditional Requirement]

When a geometry search criterion is provided and exceeds the maximum number of vertexes supported by the EOF Service STAC implementations, a 413 HTTP status code (Request Entity Too large) shall be returned including an error content including a clear explanation of the issue.  

13

Jan Musial

(CloudFerro)

general commentlack of specific list of required & recommended STAC extension with corresponding versionsClosedIt has to be specified in service level ICD.
13

Jan Musial

(CloudFerro)

general commentlack of specific list of required STAC extension with corresponding versionsClosedduplicate from previous
14

Jan Musial

(CloudFerro)

general commentno relation to INSPIRE specification. It was agreed that the STAC should be INSPIRE compliant at collection levelClosedAs discussed in catchup meeting, no additional requirement expected.
15

Jan Musial

(CloudFerro)

general commentno requirements regarding cross-collection search capabilities

16Vincent Privat (ADS)

STAC-CORE-GEN-REQ-0040

STAC-CORE-COL-REC-0135

Mispelled identifiers (REQ vs. REC)Fixed

These statements have conflicting identifier and type (requirements with REC or recommendations with REQ)

2 references renamed 

17Vincent Privat (ADS)

STAC-API-GEN-REQ-0411

Type (requirement) forgottenFixed

The type "[Requirement]" shall be added in the title, like other requirements in the document

Title fixed

18Vincent Privat (ADS)

STAC-API-SIMPSRCH-REQ-0530

All STAC-API-ADVSRCH-CREQ-*

Extra space characters in requirement identifiersFixed

Some extra characters are present in these requirement identifiers, it causes issues with traceability tools.

Extra spaces deleted

19Vincent Privat (ADS)

STAC-CORE-COL-REC-0110

TypoFixed

Wrong spelling of Recommendation ('a' instead of 'e')


  • No labels

1 Comment

  1. @Vincent.privat

    RC3 doc updated

Write a comment…