diff --git a/.github/remark.yaml b/.github/remark.yaml index 70dddb2..4146ea2 100644 --- a/.github/remark.yaml +++ b/.github/remark.yaml @@ -43,4 +43,4 @@ plugins: - space # Tables - remark-lint-table-pipes - - remark-lint-no-literal-urls + - remark-lint-no-literal-urls \ No newline at end of file diff --git a/README.md b/README.md index cb99dd2..e83aa7f 100644 --- a/README.md +++ b/README.md @@ -21,15 +21,16 @@ It will often be combined with other extensions that describe the actual data, s ## Item Properties -| Field Name | Type | Description | -| ------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| sat:platform_international_designator | string | The International Designator, also known as COSPAR ID, and NSSDCA ID | -| sat:orbit_state | string | The state of the orbit. Either `ascending` or `descending` for polar orbiting satellites, or `geostationary` for geosynchronous satellites | -| sat:absolute_orbit | integer | The absolute orbit number at the time of acquisition. | -| sat:relative_orbit | integer | The relative orbit number at the time of acquisition. | -| sat:orbit_cycle | integer | The number of repeat cycle done by the satellite at the time of the acquisition. [Repeat cycle](https://ltb.itc.utwente.nl/page/498/concept/81577) is the time between two successive identical orbits. | -| sat:orbit_state_vectors | Map | The state vectors of the satellite at the time of acquisition. | -| sat:anx_datetime | string | The [Ascending Node](https://en.wikipedia.org/wiki/Orbital_node) Crossing (ANX) time, in UTC. It is formatted according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6). | +| Field Name | Type | Description | +| ------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| sat:platform_international_designator | string | The International Designator, also known as COSPAR ID, and NSSDCA ID | +| sat:orbit_state | string | The state of the orbit. Either `ascending` or `descending` for polar orbiting satellites, or `geostationary` for geosynchronous satellites | +| sat:absolute_orbit | integer | The absolute orbit number at the time of acquisition. | +| sat:relative_orbit | integer | The relative orbit number at the time of acquisition. | +| sat:orbit_cycle | integer | The number of repeat cycle done by the satellite at the time of the acquisition. [Repeat cycle](https://ltb.itc.utwente.nl/page/498/concept/81577) is the time between two successive identical orbits. | +| sat:orbit_state_vectors | Map | The state vectors of the satellite at the time of acquisition. | +| sat:anx_datetime | string | The [Ascending Node](https://en.wikipedia.org/wiki/Orbital_node) Crossing (ANX) time, in UTC. It is formatted according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6). | +| sat:acquisition_station | string | The acquisition station (ground station) where the satellite data was downlinked. Equivalent to `eop:acquisition_station` in OGC 10-157r4 and OGC 17-003r2. | *At least one of the fields must be specified.* @@ -120,6 +121,13 @@ Example: It is recommended that the state vectors are provided in a separate file and referenced as a link with relationship type `sat:osv`. The file should correspond to the example above. +#### sat:acquisition_station + +The ground station where the satellite data was downlinked. This information is crucial for data lineage and provenance tracking, +as it identifies the first point of data reception on Earth. In the context of Earth Observation missions, this corresponds to the +`eop:acquisitionStation` in OGC standards (10-157r4 and 17-003r2). This field can be used for filtering datasets based on the +ground station used for downlinking, which can be relevant for certain processing workflows or quality assessments. + ## Relation types The following types should be used as applicable `rel` types in the diff --git a/examples/example-landsat8.json b/examples/example-landsat8.json index 0f43a0e..ea10db8 100644 --- a/examples/example-landsat8.json +++ b/examples/example-landsat8.json @@ -51,6 +51,7 @@ ], "constellation": "landsat", "sat:orbit_state": "ascending", + "sat:acquisition_station": "LGS", "view:off_nadir": 0 }, "assets": { diff --git a/examples/example-sentinel1.json b/examples/example-sentinel1.json index a0a7cd2..12cb058 100644 --- a/examples/example-sentinel1.json +++ b/examples/example-sentinel1.json @@ -81,6 +81,7 @@ -5604.210861145829 ] }, + "sat:acquisition_station": "PDGS Matera", "sar:instrument_mode": "IW", "sar:polarizations": [ "VV", diff --git a/json-schema/schema.json b/json-schema/schema.json index 0d86067..640446d 100644 --- a/json-schema/schema.json +++ b/json-schema/schema.json @@ -66,6 +66,11 @@ "required": [ "sat:orbit_state_vectors" ] + }, + { + "required": [ + "sat:acquisition_station" + ] } ] }, @@ -153,6 +158,9 @@ } }, "additionalProperties": false + }, + "sat:acquisition_station": { + "type": "string" } }, "patternProperties": { diff --git a/package.json b/package.json index 80b64f7..33a171c 100644 --- a/package.json +++ b/package.json @@ -18,4 +18,4 @@ "remark-validate-links": "^13.0.0", "stac-node-validator": "^1.3.0" } -} +} \ No newline at end of file