Fix build and minor improvements

radiantearth · Dec 15, 2020 · 67d1132 · 67d1132
1 parent a382373
commit 67d1132
Show file tree

Hide file tree

Showing 2 changed files with 20 additions and 20 deletions.
diff --git a/extensions/README.md b/extensions/README.md
@@ -46,7 +46,7 @@ An extension can add new fields to STAC entities (content extension), or can add
 
 | Extension Title                                  | Identifier        | Field Name Prefix   | Scope                     | Maturity   | Description |
 | ------------------------------------------------ | ----------------- | ------------------- | ------------------------- | ---------- | ----------- |
-| [CARD4L SAR](card4l-sar/README.md)               | card4l-sar        | -                   | Item                      | *Proposal* | How to comply to the CEOS CARD4L product family specification for SAR NRB and POL products |
+| [CARD4L SAR](card4l-sar/README.md)               | card4l-sar        | card4l              | Item                      | *Proposal* | How to comply to the CEOS CARD4L product family specification for SAR NRB and POL products |
 | [Checksum](checksum/README.md)                   | checksum          | checksum            | Item, Catalog, Collection | *Proposal* | Provides a way to specify file checksums for assets and links in Items, Catalogs and Collections. |
 | [Collection Assets](collection-assets/README.md) | collection-assets | -                   | Collection                | *Proposal* | Provides a way to specify assets available on the collection-level. |
 | [Data Cube](datacube/README.md)                  | datacube          | cube                | Item, Collection          | *Proposal* | Data Cube related metadata, especially to describe their dimensions. |

diff --git a/extensions/card4l-sar/README.md b/extensions/card4l-sar/README.md
@@ -2,7 +2,7 @@
 
 - **Title: CARD4L SAR**
 - **Identifier: card4l-sar**
-- **Field Name Prefix: card4l** (shared with a future CARD4L Optical Extension)
+- **Field Name Prefix: card4l** (shared with the CARD4L Optical Extension)
 - **Scope: Item**
 - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal**
 
@@ -27,7 +27,7 @@ We will refer to the included XML Tags throughout this document:
 
 1. *XML mode*: A STAC entry without CARD4L specific fields is published in addition to the complete XML file proposed by CEOS. This is recommended if no STAC Item exists for the source file. Also, CARD4L (2.1) has in the *threshold (minimum) requirements* that 
 
-   > metadata is formatted in accordance with CARD4L [...] Metadata Specifications, v.5.0.
+   > metadata is formatted in accordance with CARD4L \[...\] Metadata Specifications, v.5.0.
    
     The CARD4L Metadata Specification is XML-based.
 
@@ -60,7 +60,7 @@ The column *XML Tag* refers to the XML tag proposed in the CARD4L metadata speci
 
 A STAC Item for the Source (*Src*) is only required in STAC mode. Otherwise a XML file can be provided.
 
-STAC Items must always be valid STAC Item. Requirements directly specified in the STAC Item specification are not covered here, only additional requirements and mappings to fulfill the CARD4L requirements are listed here:
+STAC Items must always be valid, but not all STAC Item requirements are covered here, only additional requirements and mappings to fulfill the CARD4L requirements are listed here:
 
 | Field Name      | XML Tag                                                      | Description                                                  | Src     | Prod    |
 | --------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------- | ------- |
@@ -197,18 +197,18 @@ Each of the assets can either be exposed individually or grouped together in any
 
 The italic role names are proposed to be the asset's key.
 
-| Role Name(s)          | Additional properties | XML Tag                      | Description                                                  | Src  | Prod  |
-| --------------------- | ------------------------------ | ---------------------------- | ------------------------------------------------------------ | ---- | ----- |
-| *card4l*, metadata | `type` | *n/a*                        | **REQUIRED in *XML Mode*.** Points to the CARD4L metadata XML file. Media type: `application/xml` | ✗    | ✓ 2.1 |
-| *mask*, metadata | `type`, `card4l:valid`, `card4l:invalid`, `card4l:nodata`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `DataMask`                   | **REQUIRED.** Points to the data mask file.                  | ✗    | ✓ 2.2 |
-| *area*, metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `LocalContributingArea`      | **REQUIRED.** Points to the normalized scattering area file. | ✗    | ✓ 2.3 |
-| *local-inc-angle*,  metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `LocalIncAngle`              | **REQUIRED.** Points to the local incidence angle file.      | ✗    | ✓ 2.4 |
-| *ellipsoid-inc-angle*, metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `EllipsoidIncAngle`          |                                                              | ✗    | ✓ 2.5 |
-| *noise-power*, card4l, metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `NoisePower`                 |                                                              | ✗    | ✓ 2.6 |
-| *gamma-sigma*, metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `GammaToSigmaRatio`          |                                                              | ✗    | ✓ 2.7 |
-| *date*, metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `AcquisitionDate`            |                                                              | ✗    | ✓ 2.8 |
-| backscatter-measurements, data | `type`, `created`, `sar:polarizations`, `card4l:conversion_eq`, `card4l:header_size`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `BackscatterMeasurementData` | **REQUIRED for *NRB*.** Points to the backscatter measurements for the polarizations specified in `sar:polarizations`. | ✗    | ✓ 3.1 (NRB) |
-| (covmat *or* prd), data | `type`, `created`, `sar:polarizations` (CovMat only), `card4l:conversion_eq`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `Measurements` | **REQUIRED for *POL*.** Points to the Normalized Polarimetric Radar Covariance Matrix (CovMat) *or* the Polarimetric Radar Decomposition (PRD) | ✗ | ✓ 3.1 (POL) |
+| Role Name(s)                    | Additional properties                                        | XML Tag                      | Description                                                  | Src  | Prod        |
+| ------------------------------- | ------------------------------------------------------------ | ---------------------------- | ------------------------------------------------------------ | ---- | ----------- |
+| *card4l*, metadata              | `type`                                                       | *n/a*                        | **REQUIRED in *XML Mode*.** Points to the CARD4L metadata XML file. Media type: `application/xml` | ✗    | ✓ 2.1       |
+| *mask*, metadata                | `type`, `card4l:valid`, `card4l:invalid`, `card4l:nodata`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `DataMask`                   | **REQUIRED.** Points to the data mask file.                  | ✗    | ✓ 2.2       |
+| *area*, metadata                | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `LocalContributingArea`      | **REQUIRED.** Points to the normalized scattering area file. | ✗    | ✓ 2.3       |
+| *local-inc-angle*,  metadata    | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `LocalIncAngle`              | **REQUIRED.** Points to the local incidence angle file.      | ✗    | ✓ 2.4       |
+| *ellipsoid-inc-angle*, metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `EllipsoidIncAngle`          |                                                              | ✗    | ✓ 2.5       |
+| *noise-power*, card4l, metadata | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `NoisePower`                 |                                                              | ✗    | ✓ 2.6       |
+| *gamma-sigma*, metadata         | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `GammaToSigmaRatio`          |                                                              | ✗    | ✓ 2.7       |
+| *date*, metadata                | `type`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `AcquisitionDate`            |                                                              | ✗    | ✓ 2.8       |
+| backscatter-measurements, data  | `type`, `created`, `sar:polarizations`, `card4l:conversion_eq`, `card4l:header_size`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `BackscatterMeasurementData` | **REQUIRED for *NRB*.** Points to the backscatter measurements for the polarizations specified in `sar:polarizations`. | ✗    | ✓ 3.1 (NRB) |
+| (covmat *or* prd), data         | `type`, `created`, `sar:polarizations` (CovMat only), `card4l:conversion_eq`, `file:data_type`, `file:byte_order`, `card4l:bits_per_sample` | `Measurements`               | **REQUIRED for *POL*.** Points to the Normalized Polarimetric Radar Covariance Matrix (CovMat) *or* the Polarimetric Radar Decomposition (PRD) | ✗    | ✓ 3.1 (POL) |
 
 #### Additional Asset Properties
 
@@ -226,9 +226,9 @@ Some additional properties are always specified per asset:
 | file:data_type         | string     | `DataType`                                                   | **REQUIRED.** One of the [Data Types](#data-types).          | ✗       | ✓       |
 | file:byte_order        | string     | `ByteOrder`                                                  | **REQUIRED.** One of `big-endian` or `little-endian`         | ✗       | ✓       |
 | card4l:bits_per_sample | integer    | `BitsPerSample`                                              | **REQUIRED.** Bits per sample, e.g. 8, 16, 32, ...           | ✗       | ✓       |
-| card4l:valid           | [any]      | `ValidData` in `BitValues`                                   | **REQUIRED** for the data mask. Value(s) for valid data.     | ✗       | ✓ 2.2   |
-| card4l:invalid         | [any]      | `InvalidData` in `BitValues`                                 | **REQUIRED** for the data mask. Value(s) for invalid data.   | ✗       | ✓ 2.2   |
-| card4l:nodata          | [any]      | `NoData` in `BitValues`                                      | **REQUIRED** for the data mask. Value(s) for no-data.        | ✗       | ✓ 2.2   |
+| card4l:valid           | \[any\]    | `ValidData` in `BitValues`                                   | **REQUIRED** for the data mask. Value(s) for valid data.     | ✗       | ✓ 2.2   |
+| card4l:invalid         | \[any\]    | `InvalidData` in `BitValues`                                 | **REQUIRED** for the data mask. Value(s) for invalid data.   | ✗       | ✓ 2.2   |
+| card4l:nodata          | \[any\]    | `NoData` in `BitValues`                                      | **REQUIRED** for the data mask. Value(s) for no-data.        | ✗       | ✓ 2.2   |
 
 ##### Data Types
 
@@ -251,4 +251,4 @@ Some additional properties are always specified per asset:
 
 1.6.9: `SideLobeLevel`, `IntegratedSideLobeRatio`, `CrossCorrelationWidth`, `CrossCorelationPeakLoc` are *recommended* to be included in the resource linked to with the relation type [`performance-indicators`](#stac-item-links).
 
-1.7.3: `ProductColumnSpacing`, `ProductRowSpacing` are not sufficiently specified in the CARD4L specifications (unit missing). Therefore they are missing here at the moment. (ToDo: Can we re-use `sar:pixel_spacing_azimuth` and `sar:pixel_spacing_range`?)
+1.7.3: `ProductColumnSpacing`, `ProductRowSpacing` are not sufficiently specified in the CARD4L specifications (unit missing). Therefore they are missing here at the moment. (ToDo: Can we re-use `sar:pixel_spacing_azimuth` and `sar:pixel_spacing_range`?)