From ee3c42d84bf3f1648a3a9e380dbc48b48b92b105 Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Wed, 12 Feb 2020 15:16:14 -0500 Subject: [PATCH 01/19] Updated extension documentation to clearly define name/prefix --- extensions/README.md | 42 +++++++++++++-------------- extensions/asset/README.md | 5 +++- extensions/checksum/README.md | 7 +++-- extensions/commons/README.md | 5 +++- extensions/datacube/README.md | 7 +++-- extensions/eo/README.md | 7 +++-- extensions/label/README.md | 7 +++-- extensions/pointcloud/README.md | 7 +++-- extensions/projection/README.md | 7 +++-- extensions/sar/README.md | 7 +++-- extensions/sat/README.md | 7 +++-- extensions/scientific/README.md | 7 +++-- extensions/single-file-stac/README.md | 5 +++- extensions/version/README.md | 7 +++-- extensions/view/README.md | 7 +++-- 15 files changed, 88 insertions(+), 46 deletions(-) diff --git a/extensions/README.md b/extensions/README.md index 926c6e70e..2ee63d059 100644 --- a/extensions/README.md +++ b/extensions/README.md @@ -26,11 +26,11 @@ on the extension. | Maturity Classification | Min Impl # | Description | Stability | | ----------------------- | ----------- | ----------- | --------- | -| Proposal | 0 | An idea put forward by a community member to gather feedback | Not stable - breaking changes almost guaranteed as implementers try out the idea. | -| Pilot | 1 | Idea is fleshed out, with examples and a JSON schema, and implemented in one or more catalogs. Additional implementations encouraged to help give feedback | Approaching stability - breaking changes are not anticipated but can easily come from additional feedback | -| Candidate | 3 | A number of implementers are using it and are standing behind it as a solid extension. Can generally count on an extension at this maturity level | Mostly stable, breaking changes require a new version and minor changes are unlikely. | -| Stable | 6 | Highest current level of maturity. The community of extension maintainers commits to a STAC review process for any changes, which are not made lightly. | Completely stable, all changes require a new version number and review process. | -| Deprecated | N/A | A previous extension that has likely been superceded by a newer one or did not work out for some reason. | DO NOT USE, is not supported | +| Proposal | 0 | An idea put forward by a community member to gather feedback | Not stable - breaking changes almost guaranteed as implementers try out the idea. | +| Pilot | 1 | Idea is fleshed out, with examples and a JSON schema, and implemented in one or more catalogs. Additional implementations encouraged to help give feedback | Approaching stability - breaking changes are not anticipated but can easily come from additional feedback | +| Candidate | 3 | A number of implementers are using it and are standing behind it as a solid extension. Can generally count on an extension at this maturity level | Mostly stable, breaking changes require a new version and minor changes are unlikely. | +| Stable | 6 | Highest current level of maturity. The community of extension maintainers commits to a STAC review process for any changes, which are not made lightly. | Completely stable, all changes require a new version number and review process. | +| Deprecated | N/A | A previous extension that has likely been superceded by a newer one or did not work out for some reason. | DO NOT USE, is not supported | Maturity mostly comes through diverse implementations, so the minimum number of implementations column is the main gating function for an extension to mature. But extension authors can also @@ -45,22 +45,22 @@ stable for over a year and are used in twenty or more implementations. An extension can add new fields to STAC entities (content extension), or can add new endpoints or behavior to the API (API extension). Below is a list of content extensions, while API extensions given under [api-spec](../api-spec/) in a folder for [API extensions](../api-spec/extensions/). -| Extension Name (Prefix) | Scope | Description | Maturity | -| ------------------------------------------------------------ | ---------------- | ------------------------------------------------------------ | -------- | -| [Asset Definition](asset/README.md) (-) | Collection | Provides a way to specify details about what assets may be found in Items belonging to a collection. | *Proposal* | -| [Checksum](checksum/README.md) (`checksum`) | Item, Catalog, Collection | Provides a way to specify file checksums for assets and links in Items, Catalogs and Collections. | *Proposal* | -| [Commons](commons/README.md) (-) | Item, Collection | Provides a way to specify data fields in a collection that are common across the STAC Items in that collection, so that each does not need to repeat all the same information. | *Proposal* | -| [Data Cube](datacube/README.md) (`cube`) | Item, Collection | Data Cube related metadata, especially to describe their dimensions. | *Proposal* | -| [EO](eo/README.md) (`eo`) | Item | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | *Pilot* | -| [Label](label/README.md) (`label`) | Item | Items that relate labeled AOIs with source imagery | *Proposal* | -| [Point Cloud](pointcloud/README.md) (`pc`) | Item | Provides a way to describe point cloud datasets. The point clouds can come from either active or passive sensors, and data is frequently acquired using tools such as LiDAR or coincidence-matched imagery. | *Proposal* | -| [Projection](projection/README.md) (`proj`) | Item | Provides a way to describe items whose assets are in a geospatial projection. | *Proposal* | -| [SAR](sar/README.md) (`sar`) | Item | Covers synthetic-aperture radar data that represents a snapshot of the earth for a single date and time. | *Proposal* | -| [Satellite](sat/README.md) (`sat`) | Item | Satellite related metadata for data collected from satellites. | *Proposal* | -| [Scientific](scientific/README.md) (`sci`) | Item, Collection | Scientific metadata is considered to be data that indicate from which publication data originates and how the data itself should be cited or referenced. | *Proposal* | -| [Single File STAC](single-file-stac/README.md) (-) | ItemCollection | An extension to provide a set of Collections and Items as a single file catalog. | *Proposal* | -| [Versioning Indicators](version/README.md) (-) | Item, Collection | Provides fields and link relation types to provide a version and indicate deprecation. | *Proposal* | -| [View Geometry](view/README.md) | Item | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | *Proposal* | +| Extension Title (Prefix) | Name | Prefix | Scope | Description | Maturity | +| ---------------------------------------------- | ---------------- | -------- | --------------------------|---------------------------------- | -------- | +| [Asset Definition](asset/README.md) | asset | - | Collection | Provides a way to specify details about what assets may be found in Items belonging to a collection. | *Proposal* | +| [Checksum](checksum/README.md) | checksum | checksum | Item, Catalog, Collection | Provides a way to specify file checksums for assets and links in Items, Catalogs and Collections. | *Proposal* | +| [Commons](commons/README.md) | commons | - | Item, Collection | Provides a way to specify data fields in a collection that are common across the STAC Items in that collection, so that each does not need to repeat all the same information. | *Proposal* | +| [Data Cube](datacube/README.md) | datacube | cube | Item, Collection | Data Cube related metadata, especially to describe their dimensions. | *Proposal* | +| [EO](eo/README.md) | eo | eo | Item | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | *Pilot* | +| [Label](label/README.md) | label | label | Item | Items that relate labeled AOIs with source imagery | *Proposal* | +| [Point Cloud](pointcloud/README.md) | pointcloud | pc | Item | Provides a way to describe point cloud datasets. The point clouds can come from either active or passive sensors, and data is frequently acquired using tools such as LiDAR or coincidence-matched imagery. | *Proposal* | +| [Projection](projection/README.md) | projection | proj | Item | Provides a way to describe items whose assets are in a geospatial projection. | *Proposal* | +| [SAR](sar/README.md) | sar | sar | Item | Covers synthetic-aperture radar data that represents a snapshot of the earth for a single date and time. | *Proposal* | +| [Satellite](sat/README.md) | sat | sat | Item | Satellite related metadata for data collected from satellites. | *Proposal* | +| [Scientific](scientific/README.md) | scientific | sci | Item, Collection | Scientific metadata is considered to be data that indicate from which publication data originates and how the data itself should be cited or referenced. | *Proposal* | +| [Single File STAC](single-file-stac/README.md) | single-file-stac | - | ItemCollection | An extension to provide a set of Collections and Items as a single file catalog. | *Proposal* | +| [Versioning Indicators](version/README.md) | version | - | Item, Collection | Provides fields and link relation types to provide a version and indicate deprecation. | *Proposal* | +| [View Geometry](view/README.md) | view | - | Item | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | *Proposal* | ## Third-party / vendor extensions diff --git a/extensions/asset/README.md b/extensions/asset/README.md index 4339799db..13d823e79 100644 --- a/extensions/asset/README.md +++ b/extensions/asset/README.md @@ -1,6 +1,9 @@ # Asset Definition Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Asset Definition** +- **Name: asset** +- **Prefix: -** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** A Collection extension to provide details about assets that are available in member Items. diff --git a/extensions/checksum/README.md b/extensions/checksum/README.md index 08cf601d3..786117a8e 100644 --- a/extensions/checksum/README.md +++ b/extensions/checksum/README.md @@ -1,6 +1,9 @@ -# Checksum Extension Specification (`checksum`) +# Checksum Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Checksum** +- **Name: checksum** +- **Prefix: checksum** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** Provides a way to specify file checksums (e.g. BLAKE2, MD5, SHA1, SHA2, SHA3) for assets and links in STAC Items, STAC Catalogs and STAC Collections. The hashes are self-identifying hashes as described in the [Multihash specification](https://github.com/multiformats/multihash). diff --git a/extensions/commons/README.md b/extensions/commons/README.md index 3c81d288a..b9ba67b4b 100644 --- a/extensions/commons/README.md +++ b/extensions/commons/README.md @@ -1,6 +1,9 @@ # Commons Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Commons** +- **Name: commons** +- **Prefix: -** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** A group of STAC Item objects from a single source can share a lot of common metadata. This is especially true with satellite imagery that uses the STAC EO Extension. Rather than including these common metadata fields on every Item, they can be provided into the [STAC Collection](../../collection-spec/README.md) that the STAC Items belong to. diff --git a/extensions/datacube/README.md b/extensions/datacube/README.md index a7445bf4d..c767220a7 100644 --- a/extensions/datacube/README.md +++ b/extensions/datacube/README.md @@ -1,6 +1,9 @@ -# Data cube Extension Specification (`cube`) +# Data cube Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Data Cube** +- **Name: datacube** +- **Prefix:cube-** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** Data cube related metadata, especially to describe their dimensions. diff --git a/extensions/eo/README.md b/extensions/eo/README.md index f30a9ae73..2a4d04bbe 100644 --- a/extensions/eo/README.md +++ b/extensions/eo/README.md @@ -1,6 +1,9 @@ -# EO Extension Specification (`eo`) +# EO Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Pilot** +- **Title: EO** +- **Name: eo** +- **Prefix: eo** +- **Extension [Maturity Classification](../README.md#extension-maturity): Pilot** This document explains the fields of the STAC Electro-Optical (EO) Extension to a STAC Item. EO data is considered to be data that represents a snapshot of the earth for a single date and time. It diff --git a/extensions/label/README.md b/extensions/label/README.md index 721d3b83a..a5ce758f7 100644 --- a/extensions/label/README.md +++ b/extensions/label/README.md @@ -1,6 +1,9 @@ -# Label Extension Specification (`label`) +# Label Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Label** +- **Name: label** +- **Prefix: label** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This extension is meant to support using labeled AOIs with Machine Learning models, particularly training data sets, but can be used in any application where labeled AOIs are needed. diff --git a/extensions/pointcloud/README.md b/extensions/pointcloud/README.md index b2af3a1c1..017a3ef6d 100644 --- a/extensions/pointcloud/README.md +++ b/extensions/pointcloud/README.md @@ -1,6 +1,9 @@ -# Point Cloud Extension Specification (`pc`) +# Point Cloud Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Point Cloud** +- **Name: pointcloud** +- **Prefix: pc** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the Point Cloud Extension to a STAC Item, which allows STAC to more fully describe point cloud datasets. The point clouds can diff --git a/extensions/projection/README.md b/extensions/projection/README.md index 89d02f1ad..ae4363f02 100644 --- a/extensions/projection/README.md +++ b/extensions/projection/README.md @@ -1,6 +1,9 @@ -# Projection Extension Specification (`proj`) +# Projection Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Projection** +- **Name: projection** +- **Prefix: proj** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the STAC Projection (`proj`) Extension to a STAC Item. Here `proj` is short for "projection", and not a reference to the use of the PROJ/PROJ4 formats. diff --git a/extensions/sar/README.md b/extensions/sar/README.md index 67faf3f6e..97aa41c0c 100644 --- a/extensions/sar/README.md +++ b/extensions/sar/README.md @@ -1,6 +1,9 @@ -# SAR Extension Specification (`sar`) +# SAR Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: SAR** +- **Name: sar** +- **Prefix: sar** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the STAC Synthetic-Aperture Radar (SAR) Extension to a STAC Item. SAR data is considered to be data that represents a snapshot of the earth for a single date and time taken by a synthetic-aperture radar system such as Sentinel-1, RADARSAT or EnviSAT. diff --git a/extensions/sat/README.md b/extensions/sat/README.md index 254f67104..ec23c5123 100644 --- a/extensions/sat/README.md +++ b/extensions/sat/README.md @@ -1,6 +1,9 @@ -# Satellite Extension Specification (`sat`) +# Satellite Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Satellite** +- **Name: sat** +- **Prefix: sat** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the Satellite Extension to a STAC Item. Sat adds metadata related to a satellite that carries an instrument for collecting data. It will often be combined with other extensions that describe the actual data, such as the `eo`, `os` or `sar` extensions. diff --git a/extensions/scientific/README.md b/extensions/scientific/README.md index b5257971e..6d1996c06 100644 --- a/extensions/scientific/README.md +++ b/extensions/scientific/README.md @@ -1,6 +1,9 @@ -# Scientific Extension Specification (`sci`) +# Scientific Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Scientific** +- **Name: scientific** +- **Prefix: sci** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** Scientific metadata is considered to be data that indicate from which publication a data originates and how the data itself should be cited or referenced. Overall, it helps to increase reproducibility and citability. diff --git a/extensions/single-file-stac/README.md b/extensions/single-file-stac/README.md index 698e0d2a6..b981e3cf2 100644 --- a/extensions/single-file-stac/README.md +++ b/extensions/single-file-stac/README.md @@ -1,6 +1,9 @@ # Single File STAC Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Single File STAC** +- **Name: single-file-stac** +- **Prefix: -** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** An extension to provide a set of Collections and Items as a single file catalog. The single file is a self contained catalog that contains everything that would normally be in a linked set of STAC files. This format is useful to save a portion of a catalog, or when creating a small catalog from derived data that should remain portable. It is most useful for saving the results of a search from a STAC API, as the Items, Collections, and optionally the search parameters are all saved within the single file. Hierarchical links have no meaning in a single file STAC, and so, if present, should be removed when creating a single file catalog. diff --git a/extensions/version/README.md b/extensions/version/README.md index ef7a86515..9ce3e4350 100644 --- a/extensions/version/README.md +++ b/extensions/version/README.md @@ -1,6 +1,9 @@ -# Versioning Indicators Extension Specification (`-`) +# Versioning Indicators Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: Versioning Indicators** +- **Name: version** +- **Prefix: -** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This extension allows to version STAC Collections and STAC Items. Therefore, it also allows to deprecate legacy versions. Only fields and possible link relation types are defined in this extension, but it does NOT suggest any versioning best practices to structure static or dynamic catalogs. Instead check the [Versioning Best Practices for Catalogs](../../best-practices.md#versioning-for-catalogs). diff --git a/extensions/view/README.md b/extensions/view/README.md index c3bb3fc0d..0e51b6d26 100644 --- a/extensions/view/README.md +++ b/extensions/view/README.md @@ -1,6 +1,9 @@ -# View Geometry Extension Specification (`view`) +# View Geometry Extension Specification -**Extension [Maturity Classification](../README.md#extension-maturity): Proposal** +- **Title: View Geometry** +- **Name: view** +- **Prefix: -** +- **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the View Geometry Extension to a STAC Item. View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data. It will often be combined with other extensions that describe the actual data, such as the `eo`, `sat` or `sar` extensions. From 58788bdd7b6c10955106cb32156b4794d7fa0617 Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Wed, 12 Feb 2020 15:28:15 -0500 Subject: [PATCH 02/19] removed (prefix) from title column in extensions table in the extension readme --- extensions/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/README.md b/extensions/README.md index 2ee63d059..f9def56aa 100644 --- a/extensions/README.md +++ b/extensions/README.md @@ -45,7 +45,7 @@ stable for over a year and are used in twenty or more implementations. An extension can add new fields to STAC entities (content extension), or can add new endpoints or behavior to the API (API extension). Below is a list of content extensions, while API extensions given under [api-spec](../api-spec/) in a folder for [API extensions](../api-spec/extensions/). -| Extension Title (Prefix) | Name | Prefix | Scope | Description | Maturity | +| Extension Title | Name | Prefix | Scope | Description | Maturity | | ---------------------------------------------- | ---------------- | -------- | --------------------------|---------------------------------- | -------- | | [Asset Definition](asset/README.md) | asset | - | Collection | Provides a way to specify details about what assets may be found in Items belonging to a collection. | *Proposal* | | [Checksum](checksum/README.md) | checksum | checksum | Item, Catalog, Collection | Provides a way to specify file checksums for assets and links in Items, Catalogs and Collections. | *Proposal* | From 47ccbb0b1512a57a2e672bc79338a3438489df4f Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Wed, 12 Feb 2020 17:38:21 -0500 Subject: [PATCH 03/19] renamed extension to --- catalog-spec/catalog-spec.md | 16 +++++------ collection-spec/collection-spec.md | 26 +++++++++--------- extensions/README.md | 38 +++++++++++++-------------- extensions/asset/README.md | 2 +- extensions/checksum/README.md | 2 +- extensions/commons/README.md | 2 +- extensions/datacube/README.md | 2 +- extensions/eo/README.md | 2 +- extensions/label/README.md | 2 +- extensions/pointcloud/README.md | 2 +- extensions/projection/README.md | 2 +- extensions/sar/README.md | 2 +- extensions/sat/README.md | 2 +- extensions/scientific/README.md | 2 +- extensions/single-file-stac/README.md | 2 +- extensions/version/README.md | 2 +- extensions/view/README.md | 2 +- 17 files changed, 54 insertions(+), 54 deletions(-) diff --git a/catalog-spec/catalog-spec.md b/catalog-spec/catalog-spec.md index 501dfc5b4..2aa97cfd8 100644 --- a/catalog-spec/catalog-spec.md +++ b/catalog-spec/catalog-spec.md @@ -93,14 +93,14 @@ guidance for good recommendations when implementing. ## Catalog fields -| Element | Type | Description | -| ------------ | ------------- | ------------------------------------------------------------ | -| stac_version | string | **REQUIRED.** The STAC version the catalog implements. STAC versions can be mixed, but please keep the [recommended best practices](../best-practices.md#mixing-stac-versions) in mind. | -| stac_extensions | [string] | A list of extensions the Catalog implements. | -| id | string | **REQUIRED.** Identifier for the catalog. | -| title | string | A short descriptive one-line title for the catalog. | -| description | string | **REQUIRED.** Detailed multi-line description to fully explain the catalog. [CommonMark 0.29](http://commonmark.org/) syntax MAY be used for rich text representation. | -| links | [[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. | +| Element | Type | Description | +| --------------- | ------------- | ------------------------------------------------------------ | +| stac_version | string | **REQUIRED.** The STAC version the catalog implements. STAC versions can be mixed, but please keep the [recommended best practices](../best-practices.md#mixing-stac-versions) in mind. | +| stac_extensions | [string] | A list of extension identifiers the Catalog implements. | +| id | string | **REQUIRED.** Identifier for the catalog. | +| title | string | A short descriptive one-line title for the catalog. | +| description | string | **REQUIRED.** Detailed multi-line description to fully explain the catalog. [CommonMark 0.29](http://commonmark.org/) syntax MAY be used for rich text representation. | +| links | [[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. | **stac_extensions**: A list of extensions the Catalog implements. This does NOT declare the extensions of children or Items. The list contains URLs to the JSON Schema files it can be validated against. For official [content extensions](../extensions/README.md#list-of-content-extensions), a "shortcut" can be used. This means you can specify the folder name of the extension, for example `pointcloud` for the Point Cloud extension. This does *not* apply for API extensions. If the versions of the extension and the catalog diverge, you can specify the URL of the JSON schema file. This list must only contain extensions that extend the Catalog itself, see the the 'Scope' column in the list of extensions. diff --git a/collection-spec/collection-spec.md b/collection-spec/collection-spec.md index 95b4cfc03..cc1947ad0 100644 --- a/collection-spec/collection-spec.md +++ b/collection-spec/collection-spec.md @@ -23,19 +23,19 @@ Implementations are encouraged, however, as good effort will be made to not chan ## Collection fields -| Element | Type | Description | -| ------------ | ----------------- | ------------------------------------------------------------ | -| stac_version | string | **REQUIRED.** The STAC version the Collection implements. STAC versions can be mixed, but please keep the [recommended best practices](../best-practices.md#mixing-stac-versions) in mind. | -| stac_extensions | [string] | A list of extensions the Collection implements. | -| id | string | **REQUIRED.** Identifier for the collection that is unique across the provider. | -| title | string | A short descriptive one-line title for the collection. | -| description | string | **REQUIRED.** Detailed multi-line description to fully explain the collection. [CommonMark 0.29](http://commonmark.org/) syntax MAY be used for rich text representation. | -| keywords | [string] | List of keywords describing the collection. | -| license | string | **REQUIRED.** Collection's license(s), either a SPDX [License identifier](https://spdx.org/licenses/), `various` if multiple licenses apply or `proprietary` for all other cases. | -| providers | [[Provider Object](#provider-object)] | A list of providers, which may include all organizations capturing or processing the data or the hosting provider. Providers should be listed in chronological order with the most recent provider being the last element of the list. | -| extent | [Extent Object](#extent-object) | **REQUIRED.** Spatial and temporal extents. | -| summaries | Map | A map of property summaries, either a set of values or statistics such as a range. | -| links | [[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. | +| Element | Type | Description | +| -------------- | ----------------- | ------------------------------------------------------------ | +| stac_version | string | **REQUIRED.** The STAC version the Collection implements. STAC versions can be mixed, but please keep the [recommended best practices](../best-practices.md#mixing-stac-versions) in mind. | +| stac_extensions | [string] | A list of extension identifiers the Collection implements. | +| id | string | **REQUIRED.** Identifier for the collection that is unique across the provider. | +| title | string | A short descriptive one-line title for the collection. | +| description | string | **REQUIRED.** Detailed multi-line description to fully explain the collection. [CommonMark 0.29](http://commonmark.org/) syntax MAY be used for rich text representation. | +| keywords | [string] | List of keywords describing the collection. | +| license | string | **REQUIRED.** Collection's license(s), either a SPDX [License identifier](https://spdx.org/licenses/), `various` if multiple licenses apply or `proprietary` for all other cases. | +| providers | [[Provider Object](#provider-object)] | A list of providers, which may include all organizations capturing or processing the data or the hosting provider. Providers should be listed in chronological order with the most recent provider being the last element of the list. | +| extent | [Extent Object](#extent-object) | **REQUIRED.** Spatial and temporal extents. | +| summaries | Map | A map of property summaries, either a set of values or statistics such as a range. | +| links | [[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. | **stac_extensions**: A list of extensions the Collection implements. This does NOT declare the extensions of child Catalogs or Items. The list contains URLs to the JSON Schema files it can be validated against. For official [content extensions](../extensions/README.md#list-of-content-extensions), a "shortcut" can be used. This means you can specify the folder name of the extension, for example `version` for the Versioning Indicators extension. This does *not* apply for API extensions. If the versions of the extension and the collection diverge, you can specify the URL of the JSON schema file. This list must only contain extensions that extend the Collection itself, see the the 'Scope' column in the list of extensions. If an extension such as the Commons extension has influence on multiple parts of the whole catalog structure, it must be listed in all affected parts (e.g. Collection and Item for the Commons extension). If a structure such as the summaries or the Commons extension provide fields in their JSON structure, these extensions must not be listed here as they don't extend the Collection itself. For example, if a Collection includes the field `sat:platform` in the summaries, the Collection still does not list the `sat` extension in the `stac_extensions` field. diff --git a/extensions/README.md b/extensions/README.md index f9def56aa..2e25281af 100644 --- a/extensions/README.md +++ b/extensions/README.md @@ -45,22 +45,22 @@ stable for over a year and are used in twenty or more implementations. An extension can add new fields to STAC entities (content extension), or can add new endpoints or behavior to the API (API extension). Below is a list of content extensions, while API extensions given under [api-spec](../api-spec/) in a folder for [API extensions](../api-spec/extensions/). -| Extension Title | Name | Prefix | Scope | Description | Maturity | -| ---------------------------------------------- | ---------------- | -------- | --------------------------|---------------------------------- | -------- | -| [Asset Definition](asset/README.md) | asset | - | Collection | Provides a way to specify details about what assets may be found in Items belonging to a collection. | *Proposal* | -| [Checksum](checksum/README.md) | checksum | checksum | Item, Catalog, Collection | Provides a way to specify file checksums for assets and links in Items, Catalogs and Collections. | *Proposal* | -| [Commons](commons/README.md) | commons | - | Item, Collection | Provides a way to specify data fields in a collection that are common across the STAC Items in that collection, so that each does not need to repeat all the same information. | *Proposal* | -| [Data Cube](datacube/README.md) | datacube | cube | Item, Collection | Data Cube related metadata, especially to describe their dimensions. | *Proposal* | -| [EO](eo/README.md) | eo | eo | Item | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | *Pilot* | -| [Label](label/README.md) | label | label | Item | Items that relate labeled AOIs with source imagery | *Proposal* | -| [Point Cloud](pointcloud/README.md) | pointcloud | pc | Item | Provides a way to describe point cloud datasets. The point clouds can come from either active or passive sensors, and data is frequently acquired using tools such as LiDAR or coincidence-matched imagery. | *Proposal* | -| [Projection](projection/README.md) | projection | proj | Item | Provides a way to describe items whose assets are in a geospatial projection. | *Proposal* | -| [SAR](sar/README.md) | sar | sar | Item | Covers synthetic-aperture radar data that represents a snapshot of the earth for a single date and time. | *Proposal* | -| [Satellite](sat/README.md) | sat | sat | Item | Satellite related metadata for data collected from satellites. | *Proposal* | -| [Scientific](scientific/README.md) | scientific | sci | Item, Collection | Scientific metadata is considered to be data that indicate from which publication data originates and how the data itself should be cited or referenced. | *Proposal* | -| [Single File STAC](single-file-stac/README.md) | single-file-stac | - | ItemCollection | An extension to provide a set of Collections and Items as a single file catalog. | *Proposal* | -| [Versioning Indicators](version/README.md) | version | - | Item, Collection | Provides fields and link relation types to provide a version and indicate deprecation. | *Proposal* | -| [View Geometry](view/README.md) | view | - | Item | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | *Proposal* | +| Extension Title | Identifier | Prefix | Scope | Maturity | Description | +| ---------------------------------------------- | ---------------- | -------- | ------------------------- | ---------- | ---------------------------------- | +| [Asset Definition](asset/README.md) | asset | - | Collection | *Proposal* | Provides a way to specify details about what assets may be found in Items belonging to a collection. | +| [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. | +| [Commons](commons/README.md) | commons | - | Item, Collection | *Proposal* | Provides a way to specify data fields in a collection that are common across the STAC Items in that collection, so that each does not need to repeat all the same information. | +| [Data Cube](datacube/README.md) | datacube | cube | Item, Collection | *Proposal* | Data Cube related metadata, especially to describe their dimensions. | +| [EO](eo/README.md) | eo | eo | Item | *Pilot* | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | +| [Label](label/README.md) | label | label | Item | *Proposal* | Items that relate labeled AOIs with source imagery | +| [Point Cloud](pointcloud/README.md) | pointcloud | pc | Item | *Proposal* | Provides a way to describe point cloud datasets. The point clouds can come from either active or passive sensors, and data is frequently acquired using tools such as LiDAR or coincidence-matched imagery. | +| [Projection](projection/README.md) | projection | proj | Item | *Proposal* | Provides a way to describe items whose assets are in a geospatial projection. | +| [SAR](sar/README.md) | sar | sar | Item | *Proposal* | Covers synthetic-aperture radar data that represents a snapshot of the earth for a single date and time. | +| [Satellite](sat/README.md) | sat | sat | Item | *Proposal* | Satellite related metadata for data collected from satellites. | +| [Scientific](scientific/README.md) | scientific | sci | Item, Collection | *Proposal* | Scientific metadata is considered to be data that indicate from which publication data originates and how the data itself should be cited or referenced. | +| [Single File STAC](single-file-stac/README.md) | single-file-stac | - | ItemCollection | *Proposal* | An extension to provide a set of Collections and Items as a single file catalog. | +| [Versioning Indicators](version/README.md) | version | - | Item, Collection | *Proposal* | Provides fields and link relation types to provide a version and indicate deprecation. | +| [View Geometry](view/README.md) | view | - | Item | *Proposal* | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | ## Third-party / vendor extensions @@ -156,7 +156,7 @@ See the [EO](eo/) extension file structure as an example. * Specification examples should be stored in an `examples` directory. * The specification schema file(s) should be stored in a `json-schema` directory. -Make sure to choose a meaningful name for the extension folder as it will be the shortcut -that is used to reference it in the `stac_extensions` field. Also, make sure to add the -folder name to the enum defined for the `stac_extensions` field in the +Make sure to choose a meaningful identifier for the extension and use this value as the extension's directory name. +The extension's identifier should be used in the `stac_extensions` field. Also, make sure to add the identifier to the +enum defined for the `stac_extensions` field in the [JSON schema of the STAC catalog specification](../catalog-spec/json-schema/catalog.json). \ No newline at end of file diff --git a/extensions/asset/README.md b/extensions/asset/README.md index 13d823e79..9cccd7844 100644 --- a/extensions/asset/README.md +++ b/extensions/asset/README.md @@ -1,7 +1,7 @@ # Asset Definition Specification - **Title: Asset Definition** -- **Name: asset** +- **Identifier: asset** - **Prefix: -** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/checksum/README.md b/extensions/checksum/README.md index 786117a8e..34b3d2f99 100644 --- a/extensions/checksum/README.md +++ b/extensions/checksum/README.md @@ -1,7 +1,7 @@ # Checksum Extension Specification - **Title: Checksum** -- **Name: checksum** +- **Identifier: checksum** - **Prefix: checksum** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/commons/README.md b/extensions/commons/README.md index b9ba67b4b..003b1a11b 100644 --- a/extensions/commons/README.md +++ b/extensions/commons/README.md @@ -1,7 +1,7 @@ # Commons Extension Specification - **Title: Commons** -- **Name: commons** +- **Identifier: commons** - **Prefix: -** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/datacube/README.md b/extensions/datacube/README.md index c767220a7..ad41ff60a 100644 --- a/extensions/datacube/README.md +++ b/extensions/datacube/README.md @@ -1,7 +1,7 @@ # Data cube Extension Specification - **Title: Data Cube** -- **Name: datacube** +- **Identifier: datacube** - **Prefix:cube-** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/eo/README.md b/extensions/eo/README.md index 2a4d04bbe..84cf25e00 100644 --- a/extensions/eo/README.md +++ b/extensions/eo/README.md @@ -1,7 +1,7 @@ # EO Extension Specification - **Title: EO** -- **Name: eo** +- **Identifier: eo** - **Prefix: eo** - **Extension [Maturity Classification](../README.md#extension-maturity): Pilot** diff --git a/extensions/label/README.md b/extensions/label/README.md index a5ce758f7..25e042803 100644 --- a/extensions/label/README.md +++ b/extensions/label/README.md @@ -1,7 +1,7 @@ # Label Extension Specification - **Title: Label** -- **Name: label** +- **Identifier: label** - **Prefix: label** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/pointcloud/README.md b/extensions/pointcloud/README.md index 017a3ef6d..6c3a6310b 100644 --- a/extensions/pointcloud/README.md +++ b/extensions/pointcloud/README.md @@ -1,7 +1,7 @@ # Point Cloud Extension Specification - **Title: Point Cloud** -- **Name: pointcloud** +- **Identifier: pointcloud** - **Prefix: pc** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/projection/README.md b/extensions/projection/README.md index ae4363f02..648ea0d1f 100644 --- a/extensions/projection/README.md +++ b/extensions/projection/README.md @@ -1,7 +1,7 @@ # Projection Extension Specification - **Title: Projection** -- **Name: projection** +- **Identifier: projection** - **Prefix: proj** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/sar/README.md b/extensions/sar/README.md index 97aa41c0c..df0e06bc2 100644 --- a/extensions/sar/README.md +++ b/extensions/sar/README.md @@ -1,7 +1,7 @@ # SAR Extension Specification - **Title: SAR** -- **Name: sar** +- **Identifier: sar** - **Prefix: sar** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/sat/README.md b/extensions/sat/README.md index ec23c5123..ba4922363 100644 --- a/extensions/sat/README.md +++ b/extensions/sat/README.md @@ -1,7 +1,7 @@ # Satellite Extension Specification - **Title: Satellite** -- **Name: sat** +- **Identifier: sat** - **Prefix: sat** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/scientific/README.md b/extensions/scientific/README.md index 6d1996c06..c1e1ab7ad 100644 --- a/extensions/scientific/README.md +++ b/extensions/scientific/README.md @@ -1,7 +1,7 @@ # Scientific Extension Specification - **Title: Scientific** -- **Name: scientific** +- **Identifier: scientific** - **Prefix: sci** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/single-file-stac/README.md b/extensions/single-file-stac/README.md index b981e3cf2..ea7430d67 100644 --- a/extensions/single-file-stac/README.md +++ b/extensions/single-file-stac/README.md @@ -1,7 +1,7 @@ # Single File STAC Specification - **Title: Single File STAC** -- **Name: single-file-stac** +- **Identifier: single-file-stac** - **Prefix: -** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/version/README.md b/extensions/version/README.md index 9ce3e4350..78a9c7316 100644 --- a/extensions/version/README.md +++ b/extensions/version/README.md @@ -1,7 +1,7 @@ # Versioning Indicators Extension Specification - **Title: Versioning Indicators** -- **Name: version** +- **Identifier: version** - **Prefix: -** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/view/README.md b/extensions/view/README.md index 0e51b6d26..d4514be7a 100644 --- a/extensions/view/README.md +++ b/extensions/view/README.md @@ -1,7 +1,7 @@ # View Geometry Extension Specification - **Title: View Geometry** -- **Name: view** +- **Identifier: view** - **Prefix: -** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** From 4649792aaf3b413e2dbe8f2fccdbffdca98f7ce6 Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Wed, 12 Feb 2020 17:43:43 -0500 Subject: [PATCH 04/19] added scope to each extension's readme --- extensions/asset/README.md | 1 + extensions/checksum/README.md | 1 + extensions/commons/README.md | 1 + extensions/datacube/README.md | 1 + extensions/eo/README.md | 1 + extensions/label/README.md | 1 + extensions/pointcloud/README.md | 1 + extensions/projection/README.md | 1 + extensions/sar/README.md | 1 + extensions/sat/README.md | 1 + extensions/scientific/README.md | 1 + extensions/single-file-stac/README.md | 1 + extensions/version/README.md | 1 + extensions/view/README.md | 1 + 14 files changed, 14 insertions(+) diff --git a/extensions/asset/README.md b/extensions/asset/README.md index 9cccd7844..ad1a80de3 100644 --- a/extensions/asset/README.md +++ b/extensions/asset/README.md @@ -3,6 +3,7 @@ - **Title: Asset Definition** - **Identifier: asset** - **Prefix: -** +- **Scope: Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** A Collection extension to provide details about assets that are available in member Items. diff --git a/extensions/checksum/README.md b/extensions/checksum/README.md index 34b3d2f99..2a07ae4b5 100644 --- a/extensions/checksum/README.md +++ b/extensions/checksum/README.md @@ -3,6 +3,7 @@ - **Title: Checksum** - **Identifier: checksum** - **Prefix: checksum** +- **Scope: Item, Catalog, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** Provides a way to specify file checksums (e.g. BLAKE2, MD5, SHA1, SHA2, SHA3) for assets and links in STAC Items, STAC Catalogs and STAC Collections. The hashes are self-identifying hashes as described in the [Multihash specification](https://github.com/multiformats/multihash). diff --git a/extensions/commons/README.md b/extensions/commons/README.md index 003b1a11b..eb44dd6c3 100644 --- a/extensions/commons/README.md +++ b/extensions/commons/README.md @@ -3,6 +3,7 @@ - **Title: Commons** - **Identifier: commons** - **Prefix: -** +- **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** A group of STAC Item objects from a single source can share a lot of common metadata. This is especially true with satellite imagery that uses the STAC EO Extension. Rather than including these common metadata fields on every Item, they can be provided into the [STAC Collection](../../collection-spec/README.md) that the STAC Items belong to. diff --git a/extensions/datacube/README.md b/extensions/datacube/README.md index ad41ff60a..1473ae707 100644 --- a/extensions/datacube/README.md +++ b/extensions/datacube/README.md @@ -3,6 +3,7 @@ - **Title: Data Cube** - **Identifier: datacube** - **Prefix:cube-** +- **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** Data cube related metadata, especially to describe their dimensions. diff --git a/extensions/eo/README.md b/extensions/eo/README.md index 84cf25e00..7310e22a1 100644 --- a/extensions/eo/README.md +++ b/extensions/eo/README.md @@ -3,6 +3,7 @@ - **Title: EO** - **Identifier: eo** - **Prefix: eo** +- **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Pilot** This document explains the fields of the STAC Electro-Optical (EO) Extension to a STAC Item. EO diff --git a/extensions/label/README.md b/extensions/label/README.md index 25e042803..4b8fe18b0 100644 --- a/extensions/label/README.md +++ b/extensions/label/README.md @@ -3,6 +3,7 @@ - **Title: Label** - **Identifier: label** - **Prefix: label** +- **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This extension is meant to support using labeled AOIs with Machine Learning models, particularly training data sets, but can be used in any application where labeled AOIs are needed. diff --git a/extensions/pointcloud/README.md b/extensions/pointcloud/README.md index 6c3a6310b..cf5033bee 100644 --- a/extensions/pointcloud/README.md +++ b/extensions/pointcloud/README.md @@ -3,6 +3,7 @@ - **Title: Point Cloud** - **Identifier: pointcloud** - **Prefix: pc** +- **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the Point Cloud Extension to a STAC Item, diff --git a/extensions/projection/README.md b/extensions/projection/README.md index 648ea0d1f..04dfeb1e1 100644 --- a/extensions/projection/README.md +++ b/extensions/projection/README.md @@ -3,6 +3,7 @@ - **Title: Projection** - **Identifier: projection** - **Prefix: proj** +- **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the STAC Projection (`proj`) Extension to a STAC Item. Here `proj` is short diff --git a/extensions/sar/README.md b/extensions/sar/README.md index df0e06bc2..26050592f 100644 --- a/extensions/sar/README.md +++ b/extensions/sar/README.md @@ -3,6 +3,7 @@ - **Title: SAR** - **Identifier: sar** - **Prefix: sar** +- **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the STAC Synthetic-Aperture Radar (SAR) Extension to a STAC Item. diff --git a/extensions/sat/README.md b/extensions/sat/README.md index ba4922363..adfc832af 100644 --- a/extensions/sat/README.md +++ b/extensions/sat/README.md @@ -3,6 +3,7 @@ - **Title: Satellite** - **Identifier: sat** - **Prefix: sat** +- **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the Satellite Extension to a STAC Item. Sat adds metadata related to a satellite that carries an instrument for collecting data. It will often be combined with other extensions that describe the actual data, such as the `eo`, `os` or `sar` extensions. diff --git a/extensions/scientific/README.md b/extensions/scientific/README.md index c1e1ab7ad..7a34483ab 100644 --- a/extensions/scientific/README.md +++ b/extensions/scientific/README.md @@ -3,6 +3,7 @@ - **Title: Scientific** - **Identifier: scientific** - **Prefix: sci** +- **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** Scientific metadata is considered to be data that indicate from which publication a data originates and how diff --git a/extensions/single-file-stac/README.md b/extensions/single-file-stac/README.md index ea7430d67..caa4da896 100644 --- a/extensions/single-file-stac/README.md +++ b/extensions/single-file-stac/README.md @@ -3,6 +3,7 @@ - **Title: Single File STAC** - **Identifier: single-file-stac** - **Prefix: -** +- **Scope: ItemCollection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** An extension to provide a set of Collections and Items as a single file catalog. The single file is a self contained catalog that contains everything that would normally be in a linked set of STAC files. This format is useful to save a portion of a catalog, or when creating a small catalog from derived data that should remain portable. It is most useful for saving the results of a search from a STAC API, as the Items, Collections, and optionally the search parameters are all saved within the single file. Hierarchical links have no meaning in a single file STAC, and so, if present, should be removed when creating a single file catalog. diff --git a/extensions/version/README.md b/extensions/version/README.md index 78a9c7316..ed26ee14d 100644 --- a/extensions/version/README.md +++ b/extensions/version/README.md @@ -3,6 +3,7 @@ - **Title: Versioning Indicators** - **Identifier: version** - **Prefix: -** +- **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This extension allows to version STAC Collections and STAC Items. Therefore, it also allows to deprecate legacy versions. Only fields and possible link relation types are defined in this extension, but it does NOT suggest any versioning best practices to structure static or dynamic catalogs. Instead check the [Versioning Best Practices for Catalogs](../../best-practices.md#versioning-for-catalogs). diff --git a/extensions/view/README.md b/extensions/view/README.md index d4514be7a..24d9dd6a0 100644 --- a/extensions/view/README.md +++ b/extensions/view/README.md @@ -3,6 +3,7 @@ - **Title: View Geometry** - **Identifier: view** - **Prefix: -** +- **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** This document explains the fields of the View Geometry Extension to a STAC Item. View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data. It will often be combined with other extensions that describe the actual data, such as the `eo`, `sat` or `sar` extensions. From 7068f39718886b4492fcc85ee87e6dace21971b7 Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Thu, 13 Feb 2020 11:50:10 -0500 Subject: [PATCH 05/19] fixed view prefix and datacube typo --- collection-spec/collection-spec.md | 26 +++++++++++++------------- extensions/README.md | 2 +- extensions/datacube/README.md | 2 +- extensions/view/README.md | 2 +- 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/collection-spec/collection-spec.md b/collection-spec/collection-spec.md index cc1947ad0..b11e15f28 100644 --- a/collection-spec/collection-spec.md +++ b/collection-spec/collection-spec.md @@ -23,19 +23,19 @@ Implementations are encouraged, however, as good effort will be made to not chan ## Collection fields -| Element | Type | Description | -| -------------- | ----------------- | ------------------------------------------------------------ | -| stac_version | string | **REQUIRED.** The STAC version the Collection implements. STAC versions can be mixed, but please keep the [recommended best practices](../best-practices.md#mixing-stac-versions) in mind. | -| stac_extensions | [string] | A list of extension identifiers the Collection implements. | -| id | string | **REQUIRED.** Identifier for the collection that is unique across the provider. | -| title | string | A short descriptive one-line title for the collection. | -| description | string | **REQUIRED.** Detailed multi-line description to fully explain the collection. [CommonMark 0.29](http://commonmark.org/) syntax MAY be used for rich text representation. | -| keywords | [string] | List of keywords describing the collection. | -| license | string | **REQUIRED.** Collection's license(s), either a SPDX [License identifier](https://spdx.org/licenses/), `various` if multiple licenses apply or `proprietary` for all other cases. | -| providers | [[Provider Object](#provider-object)] | A list of providers, which may include all organizations capturing or processing the data or the hosting provider. Providers should be listed in chronological order with the most recent provider being the last element of the list. | -| extent | [Extent Object](#extent-object) | **REQUIRED.** Spatial and temporal extents. | -| summaries | Map | A map of property summaries, either a set of values or statistics such as a range. | -| links | [[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. | +| Element | Type | Description | +| --------------- | ----------------------------------------------- | ------------------------------------------------ | +| stac_version | string | **REQUIRED.** The STAC version the Collection implements. STAC versions can be mixed, but please keep the [recommended best practices](../best-practices.md#mixing-stac-versions) in mind. | +| stac_extensions | [string] | A list of extension identifiers the Collection implements. | +| id | string | **REQUIRED.** Identifier for the collection that is unique across the provider. | +| title | string | A short descriptive one-line title for the collection. | +| description | string | **REQUIRED.** Detailed multi-line description to fully explain the collection. [CommonMark 0.29](http://commonmark.org/) syntax MAY be used for rich text representation. | +| keywords | [string] | List of keywords describing the collection. | +| license | string | **REQUIRED.** Collection's license(s), either a SPDX [License identifier](https://spdx.org/licenses/), `various` if multiple licenses apply or `proprietary` for all other cases. | +| providers | [[Provider Object](#provider-object)] | A list of providers, which may include all organizations capturing or processing the data or the hosting provider. Providers should be listed in chronological order with the most recent provider being the last element of the list. | +| extent | [Extent Object](#extent-object) | **REQUIRED.** Spatial and temporal extents. | +| summaries | Map | A map of property summaries, either a set of values or statistics such as a range. | +| links | [[Link Object](#link-object)] | **REQUIRED.** A list of references to other documents. | **stac_extensions**: A list of extensions the Collection implements. This does NOT declare the extensions of child Catalogs or Items. The list contains URLs to the JSON Schema files it can be validated against. For official [content extensions](../extensions/README.md#list-of-content-extensions), a "shortcut" can be used. This means you can specify the folder name of the extension, for example `version` for the Versioning Indicators extension. This does *not* apply for API extensions. If the versions of the extension and the collection diverge, you can specify the URL of the JSON schema file. This list must only contain extensions that extend the Collection itself, see the the 'Scope' column in the list of extensions. If an extension such as the Commons extension has influence on multiple parts of the whole catalog structure, it must be listed in all affected parts (e.g. Collection and Item for the Commons extension). If a structure such as the summaries or the Commons extension provide fields in their JSON structure, these extensions must not be listed here as they don't extend the Collection itself. For example, if a Collection includes the field `sat:platform` in the summaries, the Collection still does not list the `sat` extension in the `stac_extensions` field. diff --git a/extensions/README.md b/extensions/README.md index 2e25281af..cd0331696 100644 --- a/extensions/README.md +++ b/extensions/README.md @@ -60,7 +60,7 @@ An extension can add new fields to STAC entities (content extension), or can add | [Scientific](scientific/README.md) | scientific | sci | Item, Collection | *Proposal* | Scientific metadata is considered to be data that indicate from which publication data originates and how the data itself should be cited or referenced. | | [Single File STAC](single-file-stac/README.md) | single-file-stac | - | ItemCollection | *Proposal* | An extension to provide a set of Collections and Items as a single file catalog. | | [Versioning Indicators](version/README.md) | version | - | Item, Collection | *Proposal* | Provides fields and link relation types to provide a version and indicate deprecation. | -| [View Geometry](view/README.md) | view | - | Item | *Proposal* | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | +| [View Geometry](view/README.md) | view | view | Item | *Proposal* | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | ## Third-party / vendor extensions diff --git a/extensions/datacube/README.md b/extensions/datacube/README.md index 1473ae707..458717d14 100644 --- a/extensions/datacube/README.md +++ b/extensions/datacube/README.md @@ -2,7 +2,7 @@ - **Title: Data Cube** - **Identifier: datacube** -- **Prefix:cube-** +- **Prefix: cube** - **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/view/README.md b/extensions/view/README.md index 24d9dd6a0..c0d28c35d 100644 --- a/extensions/view/README.md +++ b/extensions/view/README.md @@ -2,7 +2,7 @@ - **Title: View Geometry** - **Identifier: view** -- **Prefix: -** +- **Prefix: view** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** From 332f08d14ef0811118e50516a8708248bcdd3932 Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Thu, 13 Feb 2020 11:56:01 -0500 Subject: [PATCH 06/19] renamed extension Prefix titles to Field Name Prefix --- extensions/README.md | 32 +++++++++++++-------------- extensions/asset/README.md | 2 +- extensions/checksum/README.md | 2 +- extensions/commons/README.md | 2 +- extensions/datacube/README.md | 2 +- extensions/eo/README.md | 2 +- extensions/label/README.md | 2 +- extensions/pointcloud/README.md | 2 +- extensions/projection/README.md | 2 +- extensions/sar/README.md | 2 +- extensions/sat/README.md | 2 +- extensions/scientific/README.md | 2 +- extensions/single-file-stac/README.md | 2 +- extensions/version/README.md | 2 +- extensions/view/README.md | 2 +- 15 files changed, 30 insertions(+), 30 deletions(-) diff --git a/extensions/README.md b/extensions/README.md index cd0331696..53561439f 100644 --- a/extensions/README.md +++ b/extensions/README.md @@ -45,22 +45,22 @@ stable for over a year and are used in twenty or more implementations. An extension can add new fields to STAC entities (content extension), or can add new endpoints or behavior to the API (API extension). Below is a list of content extensions, while API extensions given under [api-spec](../api-spec/) in a folder for [API extensions](../api-spec/extensions/). -| Extension Title | Identifier | Prefix | Scope | Maturity | Description | -| ---------------------------------------------- | ---------------- | -------- | ------------------------- | ---------- | ---------------------------------- | -| [Asset Definition](asset/README.md) | asset | - | Collection | *Proposal* | Provides a way to specify details about what assets may be found in Items belonging to a collection. | -| [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. | -| [Commons](commons/README.md) | commons | - | Item, Collection | *Proposal* | Provides a way to specify data fields in a collection that are common across the STAC Items in that collection, so that each does not need to repeat all the same information. | -| [Data Cube](datacube/README.md) | datacube | cube | Item, Collection | *Proposal* | Data Cube related metadata, especially to describe their dimensions. | -| [EO](eo/README.md) | eo | eo | Item | *Pilot* | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | -| [Label](label/README.md) | label | label | Item | *Proposal* | Items that relate labeled AOIs with source imagery | -| [Point Cloud](pointcloud/README.md) | pointcloud | pc | Item | *Proposal* | Provides a way to describe point cloud datasets. The point clouds can come from either active or passive sensors, and data is frequently acquired using tools such as LiDAR or coincidence-matched imagery. | -| [Projection](projection/README.md) | projection | proj | Item | *Proposal* | Provides a way to describe items whose assets are in a geospatial projection. | -| [SAR](sar/README.md) | sar | sar | Item | *Proposal* | Covers synthetic-aperture radar data that represents a snapshot of the earth for a single date and time. | -| [Satellite](sat/README.md) | sat | sat | Item | *Proposal* | Satellite related metadata for data collected from satellites. | -| [Scientific](scientific/README.md) | scientific | sci | Item, Collection | *Proposal* | Scientific metadata is considered to be data that indicate from which publication data originates and how the data itself should be cited or referenced. | -| [Single File STAC](single-file-stac/README.md) | single-file-stac | - | ItemCollection | *Proposal* | An extension to provide a set of Collections and Items as a single file catalog. | -| [Versioning Indicators](version/README.md) | version | - | Item, Collection | *Proposal* | Provides fields and link relation types to provide a version and indicate deprecation. | -| [View Geometry](view/README.md) | view | view | Item | *Proposal* | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | +| Extension Title | Identifier | Field Name Prefix | Scope | Maturity | Description | +| ---------------------------------------------- | ---------------- | ------------------- | ------------------------- | ---------- | ---------------------------------- | +| [Asset Definition](asset/README.md) | asset | - | Collection | *Proposal* | Provides a way to specify details about what assets may be found in Items belonging to a collection. | +| [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. | +| [Commons](commons/README.md) | commons | - | Item, Collection | *Proposal* | Provides a way to specify data fields in a collection that are common across the STAC Items in that collection, so that each does not need to repeat all the same information. | +| [Data Cube](datacube/README.md) | datacube | cube | Item, Collection | *Proposal* | Data Cube related metadata, especially to describe their dimensions. | +| [EO](eo/README.md) | eo | eo | Item | *Pilot* | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | +| [Label](label/README.md) | label | label | Item | *Proposal* | Items that relate labeled AOIs with source imagery | +| [Point Cloud](pointcloud/README.md) | pointcloud | pc | Item | *Proposal* | Provides a way to describe point cloud datasets. The point clouds can come from either active or passive sensors, and data is frequently acquired using tools such as LiDAR or coincidence-matched imagery. | +| [Projection](projection/README.md) | projection | proj | Item | *Proposal* | Provides a way to describe items whose assets are in a geospatial projection. | +| [SAR](sar/README.md) | sar | sar | Item | *Proposal* | Covers synthetic-aperture radar data that represents a snapshot of the earth for a single date and time. | +| [Satellite](sat/README.md) | sat | sat | Item | *Proposal* | Satellite related metadata for data collected from satellites. | +| [Scientific](scientific/README.md) | scientific | sci | Item, Collection | *Proposal* | Scientific metadata is considered to be data that indicate from which publication data originates and how the data itself should be cited or referenced. | +| [Single File STAC](single-file-stac/README.md) | single-file-stac | - | ItemCollection | *Proposal* | An extension to provide a set of Collections and Items as a single file catalog. | +| [Versioning Indicators](version/README.md) | version | - | Item, Collection | *Proposal* | Provides fields and link relation types to provide a version and indicate deprecation. | +| [View Geometry](view/README.md) | view | view | Item | *Proposal* | View Geometry adds metadata related to angles of sensors and other radiance angles that affect the view of resulting data | ## Third-party / vendor extensions diff --git a/extensions/asset/README.md b/extensions/asset/README.md index ad1a80de3..8e306614d 100644 --- a/extensions/asset/README.md +++ b/extensions/asset/README.md @@ -2,7 +2,7 @@ - **Title: Asset Definition** - **Identifier: asset** -- **Prefix: -** +- **Field Name Prefix: -** - **Scope: Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/checksum/README.md b/extensions/checksum/README.md index 2a07ae4b5..e00bd7a7b 100644 --- a/extensions/checksum/README.md +++ b/extensions/checksum/README.md @@ -2,7 +2,7 @@ - **Title: Checksum** - **Identifier: checksum** -- **Prefix: checksum** +- **Field Name Prefix: checksum** - **Scope: Item, Catalog, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/commons/README.md b/extensions/commons/README.md index eb44dd6c3..6849f100e 100644 --- a/extensions/commons/README.md +++ b/extensions/commons/README.md @@ -2,7 +2,7 @@ - **Title: Commons** - **Identifier: commons** -- **Prefix: -** +- **Field Name Prefix: -** - **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/datacube/README.md b/extensions/datacube/README.md index 458717d14..976fca4fc 100644 --- a/extensions/datacube/README.md +++ b/extensions/datacube/README.md @@ -2,7 +2,7 @@ - **Title: Data Cube** - **Identifier: datacube** -- **Prefix: cube** +- **Field Name Prefix: cube** - **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/eo/README.md b/extensions/eo/README.md index 7310e22a1..66ce7fd9c 100644 --- a/extensions/eo/README.md +++ b/extensions/eo/README.md @@ -2,7 +2,7 @@ - **Title: EO** - **Identifier: eo** -- **Prefix: eo** +- **Field Name Prefix: eo** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Pilot** diff --git a/extensions/label/README.md b/extensions/label/README.md index 4b8fe18b0..ab31ec20b 100644 --- a/extensions/label/README.md +++ b/extensions/label/README.md @@ -2,7 +2,7 @@ - **Title: Label** - **Identifier: label** -- **Prefix: label** +- **Field Name Prefix: label** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/pointcloud/README.md b/extensions/pointcloud/README.md index cf5033bee..aeb0f8b0d 100644 --- a/extensions/pointcloud/README.md +++ b/extensions/pointcloud/README.md @@ -2,7 +2,7 @@ - **Title: Point Cloud** - **Identifier: pointcloud** -- **Prefix: pc** +- **Field Name Prefix: pc** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/projection/README.md b/extensions/projection/README.md index 04dfeb1e1..29e16030c 100644 --- a/extensions/projection/README.md +++ b/extensions/projection/README.md @@ -2,7 +2,7 @@ - **Title: Projection** - **Identifier: projection** -- **Prefix: proj** +- **Field Name Prefix: proj** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/sar/README.md b/extensions/sar/README.md index 26050592f..6efc1a52d 100644 --- a/extensions/sar/README.md +++ b/extensions/sar/README.md @@ -2,7 +2,7 @@ - **Title: SAR** - **Identifier: sar** -- **Prefix: sar** +- **Field Name Prefix: sar** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/sat/README.md b/extensions/sat/README.md index adfc832af..8a665fee2 100644 --- a/extensions/sat/README.md +++ b/extensions/sat/README.md @@ -2,7 +2,7 @@ - **Title: Satellite** - **Identifier: sat** -- **Prefix: sat** +- **Field Name Prefix: sat** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/scientific/README.md b/extensions/scientific/README.md index 7a34483ab..058bb056e 100644 --- a/extensions/scientific/README.md +++ b/extensions/scientific/README.md @@ -2,7 +2,7 @@ - **Title: Scientific** - **Identifier: scientific** -- **Prefix: sci** +- **Field Name Prefix: sci** - **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/single-file-stac/README.md b/extensions/single-file-stac/README.md index caa4da896..b7da080c4 100644 --- a/extensions/single-file-stac/README.md +++ b/extensions/single-file-stac/README.md @@ -2,7 +2,7 @@ - **Title: Single File STAC** - **Identifier: single-file-stac** -- **Prefix: -** +- **Field Name Prefix: -** - **Scope: ItemCollection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/version/README.md b/extensions/version/README.md index ed26ee14d..8f17aebe0 100644 --- a/extensions/version/README.md +++ b/extensions/version/README.md @@ -2,7 +2,7 @@ - **Title: Versioning Indicators** - **Identifier: version** -- **Prefix: -** +- **Field Name Prefix: -** - **Scope: Item, Collection** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** diff --git a/extensions/view/README.md b/extensions/view/README.md index c0d28c35d..e94541bcc 100644 --- a/extensions/view/README.md +++ b/extensions/view/README.md @@ -2,7 +2,7 @@ - **Title: View Geometry** - **Identifier: view** -- **Prefix: view** +- **Field Name Prefix: view** - **Scope: Item** - **Extension [Maturity Classification](../README.md#extension-maturity): Proposal** From bd43a936ff2e73f5a9197adc1c42a42a488a4e3c Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Thu, 13 Feb 2020 11:56:54 -0500 Subject: [PATCH 07/19] moved the json schema for label extension to json-schema subdir --- extensions/label/README.md | 2 +- extensions/label/{ => json-schema}/schema.json | 0 2 files changed, 1 insertion(+), 1 deletion(-) rename extensions/label/{ => json-schema}/schema.json (100%) diff --git a/extensions/label/README.md b/extensions/label/README.md index ab31ec20b..01f40c478 100644 --- a/extensions/label/README.md +++ b/extensions/label/README.md @@ -32,7 +32,7 @@ This document explains the fields of the STAC Label Extension to a STAC Item. It - [Example World Bank Zanzibar Building Item 1](examples/multidataset/zanzibar/znz001.json) - [Example World Bank Zanzibar Building Item 2](examples/multidataset/zanzibar/znz029.json) ## Schema -- [JSON Schema](schema.json) +- [JSON Schema](json-schema/schema.json) ## Item fields diff --git a/extensions/label/schema.json b/extensions/label/json-schema/schema.json similarity index 100% rename from extensions/label/schema.json rename to extensions/label/json-schema/schema.json From a3d79df34566d50680f13b282b3ebf5c5ad56ded Mon Sep 17 00:00:00 2001 From: Josh Fix Date: Thu, 13 Feb 2020 12:18:07 -0500 Subject: [PATCH 08/19] Changed EO extension title to Electro-Optical --- extensions/README.md | 2 +- extensions/eo/README.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/extensions/README.md b/extensions/README.md index 53561439f..16a6e69da 100644 --- a/extensions/README.md +++ b/extensions/README.md @@ -51,7 +51,7 @@ An extension can add new fields to STAC entities (content extension), or can add | [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. | | [Commons](commons/README.md) | commons | - | Item, Collection | *Proposal* | Provides a way to specify data fields in a collection that are common across the STAC Items in that collection, so that each does not need to repeat all the same information. | | [Data Cube](datacube/README.md) | datacube | cube | Item, Collection | *Proposal* | Data Cube related metadata, especially to describe their dimensions. | -| [EO](eo/README.md) | eo | eo | Item | *Pilot* | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | +| [Electro-Optical](eo/README.md) | eo | eo | Item | *Pilot* | Covers electro-optical data that represents a snapshot of the earth for a single date and time. It could consist of multiple spectral bands, for example visible bands, infrared bands, red edge bands and panchromatic bands. The extension provides common fields like bands, cloud cover, gsd and more. | | [Label](label/README.md) | label | label | Item | *Proposal* | Items that relate labeled AOIs with source imagery | | [Point Cloud](pointcloud/README.md) | pointcloud | pc | Item | *Proposal* | Provides a way to describe point cloud datasets. The point clouds can come from either active or passive sensors, and data is frequently acquired using tools such as LiDAR or coincidence-matched imagery. | | [Projection](projection/README.md) | projection | proj | Item | *Proposal* | Provides a way to describe items whose assets are in a geospatial projection. | diff --git a/extensions/eo/README.md b/extensions/eo/README.md index 66ce7fd9c..5fcacf862 100644 --- a/extensions/eo/README.md +++ b/extensions/eo/README.md @@ -1,6 +1,6 @@ -# EO Extension Specification +# Electro-Optical Extension Specification -- **Title: EO** +- **Title: Electro-Optical** - **Identifier: eo** - **Field Name Prefix: eo** - **Scope: Item** From be4833d3f2741410756a2c0b6331cce3ec9a827c Mon Sep 17 00:00:00 2001 From: Matthias Mohr Date: Fri, 14 Feb 2020 16:38:00 +0100 Subject: [PATCH 09/19] Fixed description for sar:pixel_spacing_range --- extensions/sar/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/sar/README.md b/extensions/sar/README.md index 6efc1a52d..bb1545871 100644 --- a/extensions/sar/README.md +++ b/extensions/sar/README.md @@ -31,7 +31,7 @@ It is not necessary, but recommended to use the [Commons extension](../commons/R | sar:product_type | string | **REQUIRED.** The product type, for example `SSC`, `MGD`, or `SGC` | | sar:resolution_range | number | The range resolution, which is the maximum ability to distinguish two adjacent targets perpendicular to the flight path, in meters (m). | | sar:resolution_azimuth | number | The azimuth resolution, which is the maximum ability to distinguish two adjacent targets parallel to the flight path, in meters (m). | -| sar:pixel_spacing_range | number | The range azimuth, which is the distance between adjacent pixels perpendicular to the flight path, in meters (m). Strongly RECOMMENDED to be specified for products of type `GRD`. | +| sar:pixel_spacing_range | number | The range pixel spacing, which is the distance between adjacent pixels perpendicular to the flight path, in meters (m). Strongly RECOMMENDED to be specified for products of type `GRD`. | | sar:pixel_spacing_azimuth | number | The azimuth pixel spacing, which is the distance between adjacent pixels parallel to the flight path, in meters (m). Strongly RECOMMENDED to be specified for products of type `GRD`. | | sar:looks_range | number | Number of range looks, which is the number of groups of signal samples (looks) perpendicular to the flight path. | | sar:looks_azimuth | number | Number of azimuth looks, which is the number of groups of signal samples (looks) parallel to the flight path. | From 7b5e6b1731230ae2ccd757cb4722ac5db21f7874 Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Wed, 26 Feb 2020 09:25:38 -0800 Subject: [PATCH 10/19] updated examples to not use items endpoint (which implies an api), and to be a bit more accurate --- collection-spec/examples/landsat-collection.json | 8 ++++---- collection-spec/examples/landsat-item.json | 6 +++--- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/collection-spec/examples/landsat-collection.json b/collection-spec/examples/landsat-collection.json index 8e18ee857..3c9b1081b 100644 --- a/collection-spec/examples/landsat-collection.json +++ b/collection-spec/examples/landsat-collection.json @@ -136,19 +136,19 @@ "links": [ { "rel": "self", - "href": "https://example.com/stac/collections/landsat-8-l1" + "href": "https://landsat-stac.s3.amazonaws.com/landsat-8-l1/catalog.json" }, { "rel": "parent", - "href": "https://example.com/stac" + "href": "https://landsat-stac.s3.amazonaws.com/catalog.json" }, { "rel": "root", - "href": "https://example.com/stac" + "href": "https://landsat-stac.s3.amazonaws.com/catalog.json" }, { "rel": "child", - "href": "https://example.com/stac/collections/landsat-8-l1/items" + "href": "https://landsat-stac.s3.amazonaws.com/landsat-8-l1/paths" } ] } \ No newline at end of file diff --git a/collection-spec/examples/landsat-item.json b/collection-spec/examples/landsat-item.json index 000281f73..e3972a814 100644 --- a/collection-spec/examples/landsat-item.json +++ b/collection-spec/examples/landsat-item.json @@ -166,15 +166,15 @@ "links": [ { "rel": "self", - "href": "https:///search?id=LC08_L1TP_107018_20181001_20181001_01_RT" + "href": "https://landsat-stac.s3.amazonaws.com/landsat-8-l1/107/018/2018-10-01/LC08_L1TP_107018_20181001_20181001_01_RT.json" }, { "rel": "parent", - "href": "https:///stac/collections/landsat-8-l1" + "href": "https://landsat-stac.s3.amazonaws.com/landsat-8-l1/107/018/catalog.json" }, { "rel": "root", - "href": "https:///stac" + "href": "https://https://landsat-stac.s3.amazonaws.com/catalog.json" } ] } \ No newline at end of file From dc7d753c632ecb732d26359bc268a7bcb8727501 Mon Sep 17 00:00:00 2001 From: Matthew Hanson Date: Wed, 26 Feb 2020 12:27:40 -0500 Subject: [PATCH 11/19] global search and replace versions --- CHANGELOG.md | 4 ++-- README.md | 2 +- api-spec/STAC-extensions.yaml | 10 +++++----- api-spec/STAC.yaml | 10 +++++----- api-spec/openapi/STAC.yaml | 10 +++++----- api-spec/package-lock.json | 2 +- api-spec/package.json | 2 +- catalog-spec/catalog-spec.md | 4 ++-- catalog-spec/examples/catalog.json | 2 +- catalog-spec/json-schema/catalog.json | 2 +- collection-spec/examples/landsat-collection.json | 2 +- collection-spec/examples/landsat-item.json | 2 +- collection-spec/examples/sentinel2.json | 2 +- extensions/asset/examples/example-landsat8.json | 2 +- extensions/checksum/examples/sentinel1.json | 2 +- extensions/commons/README.md | 6 +++--- extensions/commons/examples/landsat-collection.json | 2 +- extensions/commons/examples/landsat-item.json | 2 +- extensions/datacube/examples/example-collection.json | 2 +- extensions/datacube/examples/example-item.json | 2 +- extensions/eo/README.md | 4 ++-- extensions/eo/examples/example-landsat8.json | 2 +- extensions/label/examples/multidataset/catalog.json | 2 +- .../spacenet-buildings/AOI_2_Vegas_img2636.json | 2 +- .../spacenet-buildings/AOI_3_Paris_img1648.json | 2 +- .../spacenet-buildings/AOI_4_Shanghai_img3344.json | 2 +- .../multidataset/spacenet-buildings/collection.json | 2 +- .../examples/multidataset/zanzibar/collection.json | 2 +- .../label/examples/multidataset/zanzibar/znz001.json | 2 +- .../label/examples/multidataset/zanzibar/znz029.json | 2 +- .../examples/spacenet-roads/roads_collection.json | 2 +- .../label/examples/spacenet-roads/roads_item.json | 2 +- .../label/examples/spacenet-roads/roads_source.json | 2 +- extensions/pointcloud/examples/example-autzen.json | 2 +- extensions/projection/examples/example-landsat8.json | 2 +- extensions/sar/examples/envisat.json | 2 +- extensions/sar/examples/sentinel1.json | 2 +- extensions/sat/examples/example-landsat8.json | 2 +- extensions/scientific/examples/collection.json | 2 +- extensions/scientific/examples/item.json | 2 +- .../single-file-stac/examples/example-search.json | 2 +- extensions/version/examples/collection.json | 2 +- extensions/version/examples/item.json | 2 +- extensions/view/README.md | 2 +- extensions/view/examples/example-landsat8.json | 2 +- .../examples/CBERS_4_MUX_20181029_177_106_L4.json | 2 +- item-spec/examples/datetimerange.json | 2 +- item-spec/examples/digitalglobe-sample.json | 2 +- item-spec/examples/itemcollection-sample-full.json | 4 ++-- item-spec/examples/itemcollection-sample-minimal.json | 2 +- item-spec/examples/landsat8-sample.json | 2 +- item-spec/examples/planet-sample.json | 2 +- item-spec/examples/sample-full.json | 2 +- item-spec/examples/sample.json | 2 +- item-spec/examples/sentinel2-sample.json | 2 +- item-spec/json-schema/item.json | 2 +- item-spec/json-schema/itemcollection.json | 2 +- 57 files changed, 75 insertions(+), 75 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 408428f63..6d661c9f1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0. ## Unreleased -## [v0.9.0-rc2] - 2020-02-12 +## [v0.9.0] - 2020-02-12 ### Added - [Basics](item-spec/common-metadata.md#basics) added to Common Metadata definitions with new `description` field for @@ -311,7 +311,7 @@ Thanks @hgs-msmith, @matthewhanson, @hgs-trutherford, @rouault, @joshfix, @alkam [Unreleased]: https://github.com/radiantearth/stac-spec/compare/master...dev -[v0.9.0-rc2]: https://github.com/radiantearth/stac-spec/compare/v0.9.0-rc1...v0.9.0-rc2 +[v0.9.0]: https://github.com/radiantearth/stac-spec/compare/v0.9.0-rc1...v0.9.0 [v0.9.0-rc1]: https://github.com/radiantearth/stac-spec/compare/v0.8.0...v0.9.0-rc1 [v0.8.1]: https://github.com/radiantearth/stac-spec/compare/v0.8.0...v0.8.1 [v0.8.0]: https://github.com/radiantearth/stac-spec/compare/v0.7.0...v0.8.0 diff --git a/README.md b/README.md index d835cfd6a..882fb0290 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ The minimal amount is specified right now, but best practices should emerge with ## Current version and branches The [master branch](https://github.com/radiantearth/stac-spec/tree/master) is the 'stable' version of the spec. It is currently version -**0.9.0-rc2** of the specification. The +**0.9.0** of the specification. The [dev](https://github.com/radiantearth/stac-spec/tree/dev) branch is where active development takes place, and may have inconsistent examples. Whenever dev stabilizes a release is cut and we merge dev in to master. So master should be stable at any given time. It is possible that there may be small releases in quick succession, especially if they are nice improvements that do diff --git a/api-spec/STAC-extensions.yaml b/api-spec/STAC-extensions.yaml index 94678f179..4cbda15b4 100644 --- a/api-spec/STAC-extensions.yaml +++ b/api-spec/STAC-extensions.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: The SpatioTemporal Asset Catalog API + Extensions - version: 0.9.0-rc2 + version: 0.9.0 license: name: Apache License 2.0 url: 'http://www.apache.org/licenses/LICENSE-2.0' @@ -786,7 +786,7 @@ components: - type: string - type: number example: - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 stac_extensions: [] id: Sentinel-2 title: 'Sentinel-2 MSI: MultiSpectral Instrument, Level-1C' @@ -1610,7 +1610,7 @@ components: stac_version: title: STAC version type: string - example: 0.9.0-rc2 + example: 0.9.0 stac_extensions: title: STAC extensions type: array @@ -1696,7 +1696,7 @@ components: assets: $ref: '#/components/schemas/itemAssets' example: - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 stac_extensions: - eo - view @@ -2106,7 +2106,7 @@ components: rel: search type: application/json title: Search across feature collections - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 id: naip text/html: schema: diff --git a/api-spec/STAC.yaml b/api-spec/STAC.yaml index db7fba3a1..eced971be 100644 --- a/api-spec/STAC.yaml +++ b/api-spec/STAC.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: The SpatioTemporal Asset Catalog API - version: 0.9.0-rc2 + version: 0.9.0 license: name: Apache License 2.0 url: 'http://www.apache.org/licenses/LICENSE-2.0' @@ -490,7 +490,7 @@ components: - type: string - type: number example: - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 stac_extensions: [] id: Sentinel-2 title: 'Sentinel-2 MSI: MultiSpectral Instrument, Level-1C' @@ -1311,7 +1311,7 @@ components: stac_version: title: STAC version type: string - example: 0.9.0-rc2 + example: 0.9.0 stac_extensions: title: STAC extensions type: array @@ -1378,7 +1378,7 @@ components: assets: $ref: '#/components/schemas/itemAssets' example: - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 stac_extensions: - eo - view @@ -1554,7 +1554,7 @@ components: rel: search type: application/json title: Search across feature collections - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 id: naip text/html: schema: diff --git a/api-spec/openapi/STAC.yaml b/api-spec/openapi/STAC.yaml index 577ed1693..d1d239d3f 100644 --- a/api-spec/openapi/STAC.yaml +++ b/api-spec/openapi/STAC.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: The SpatioTemporal Asset Catalog API - version: 0.9.0-rc2 + version: 0.9.0 description: >- This is an OpenAPI definition of the core SpatioTemporal Asset Catalog API specification. Any service that implements this endpoint to allow search of @@ -200,7 +200,7 @@ components: content: application/json: example: - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 id: naip title: NAIP Imagery description: Catalog of NAIP Imagery. @@ -291,7 +291,7 @@ components: - type: string - type: number example: - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 stac_extensions: [] id: Sentinel-2 title: 'Sentinel-2 MSI: MultiSpectral Instrument, Level-1C' @@ -660,7 +660,7 @@ components: stac_version: title: STAC version type: string - example: 0.9.0-rc2 + example: 0.9.0 stac_extensions: title: STAC extensions type: array @@ -737,7 +737,7 @@ components: assets: $ref: '#/components/schemas/itemAssets' example: - stac_version: 0.9.0-rc2 + stac_version: 0.9.0 stac_extensions: - eo - view diff --git a/api-spec/package-lock.json b/api-spec/package-lock.json index 3e1ea51fc..2d3b39496 100644 --- a/api-spec/package-lock.json +++ b/api-spec/package-lock.json @@ -1,6 +1,6 @@ { "name": "api-spec", - "version": "0.9.0-rc2", + "version": "0.9.0", "lockfileVersion": 1, "requires": true, "dependencies": { diff --git a/api-spec/package.json b/api-spec/package.json index 4161747fd..864824eec 100644 --- a/api-spec/package.json +++ b/api-spec/package.json @@ -1,6 +1,6 @@ { "name": "api-spec", - "version": "0.9.0-rc2", + "version": "0.9.0", "description": "Generate STAC openapi defintions from fragments.", "repository": "https://github.com/radiantearth/stac-spec", "license": "Apache-2.0", diff --git a/catalog-spec/catalog-spec.md b/catalog-spec/catalog-spec.md index 2aa97cfd8..898af4422 100644 --- a/catalog-spec/catalog-spec.md +++ b/catalog-spec/catalog-spec.md @@ -145,7 +145,7 @@ might look something like this: ```json { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "id": "NAIP", "description": "Catalog of NAIP Imagery", "links": [ @@ -163,7 +163,7 @@ A typical '_child_' sub-catalog could look similar: ```json { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "id": "NAIP", "description": "Catalog of NAIP Imagery - 30087", "links": [ diff --git a/catalog-spec/examples/catalog.json b/catalog-spec/examples/catalog.json index b9d3e5922..1cbab3295 100644 --- a/catalog-spec/examples/catalog.json +++ b/catalog-spec/examples/catalog.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "id": "sample", "description": "This is a very basic sample catalog.", "links": [ diff --git a/catalog-spec/json-schema/catalog.json b/catalog-spec/json-schema/catalog.json index 18cec5bf8..9c78573d0 100644 --- a/catalog-spec/json-schema/catalog.json +++ b/catalog-spec/json-schema/catalog.json @@ -22,7 +22,7 @@ "stac_version": { "title": "STAC version", "type": "string", - "const": "0.9.0-rc2" + "const": "0.9.0" }, "stac_extensions": { "title": "STAC extensions", diff --git a/collection-spec/examples/landsat-collection.json b/collection-spec/examples/landsat-collection.json index 0dd0ec39f..42e58ec9d 100644 --- a/collection-spec/examples/landsat-collection.json +++ b/collection-spec/examples/landsat-collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "commons", "view", diff --git a/collection-spec/examples/landsat-item.json b/collection-spec/examples/landsat-item.json index 76d377b7f..643c0e151 100644 --- a/collection-spec/examples/landsat-item.json +++ b/collection-spec/examples/landsat-item.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "commons", "eo", diff --git a/collection-spec/examples/sentinel2.json b/collection-spec/examples/sentinel2.json index cce11aec1..635028595 100644 --- a/collection-spec/examples/sentinel2.json +++ b/collection-spec/examples/sentinel2.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [], "id": "COPERNICUS/S2", "title": "Sentinel-2 MSI: MultiSpectral Instrument, Level-1C", diff --git a/extensions/asset/examples/example-landsat8.json b/extensions/asset/examples/example-landsat8.json index 96f916e5e..cbe0276f6 100644 --- a/extensions/asset/examples/example-landsat8.json +++ b/extensions/asset/examples/example-landsat8.json @@ -7,7 +7,7 @@ "earth observation", "usgs" ], - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "asset", "commons" diff --git a/extensions/checksum/examples/sentinel1.json b/extensions/checksum/examples/sentinel1.json index d32a04c48..82d444bb6 100644 --- a/extensions/checksum/examples/sentinel1.json +++ b/extensions/checksum/examples/sentinel1.json @@ -1,7 +1,7 @@ { "id": "S1A_EW_GRDM_1SSH_20181103T235855_20181103T235955_024430_02AD5D_5616", "type": "Feature", - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "checksum" ], diff --git a/extensions/commons/README.md b/extensions/commons/README.md index 6849f100e..6e918ed04 100644 --- a/extensions/commons/README.md +++ b/extensions/commons/README.md @@ -48,7 +48,7 @@ To get the complete record of an Item (both individual and commons properties), An incomplete Collection: ``` { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": ["commons"], "id": "landsat-8-l1", "title": "Landsat 8 L1", @@ -78,7 +78,7 @@ An incomplete Collection: An incomplete item: ``` { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": ["commons", "eo", "view"], "type": "Feature", "id": "LC08_L1TP_107018_20181001_20181001_01_RT", @@ -100,7 +100,7 @@ The merged Item then looks like this: ``` { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": ["eo", "view"], "type": "Feature", "id": "LC08_L1TP_107018_20181001_20181001_01_RT", diff --git a/extensions/commons/examples/landsat-collection.json b/extensions/commons/examples/landsat-collection.json index 145007e79..4d775456a 100644 --- a/extensions/commons/examples/landsat-collection.json +++ b/extensions/commons/examples/landsat-collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "commons" ], diff --git a/extensions/commons/examples/landsat-item.json b/extensions/commons/examples/landsat-item.json index 87f73a265..f35c749b4 100644 --- a/extensions/commons/examples/landsat-item.json +++ b/extensions/commons/examples/landsat-item.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "commons", "eo", diff --git a/extensions/datacube/examples/example-collection.json b/extensions/datacube/examples/example-collection.json index 7373563a3..2e70bc41e 100644 --- a/extensions/datacube/examples/example-collection.json +++ b/extensions/datacube/examples/example-collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "datacube" ], diff --git a/extensions/datacube/examples/example-item.json b/extensions/datacube/examples/example-item.json index f573e869b..341a80ff5 100644 --- a/extensions/datacube/examples/example-item.json +++ b/extensions/datacube/examples/example-item.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "datacube" ], diff --git a/extensions/eo/README.md b/extensions/eo/README.md index 5fcacf862..0d3012614 100644 --- a/extensions/eo/README.md +++ b/extensions/eo/README.md @@ -105,7 +105,7 @@ Asset definitions that contain band data should reference the band index. Each a See [example-landsat8.json](examples/example-landsat8.json) for a full example. ``` { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": ["eo"], "id": "LC08_L1TP_107018_20181001_20181001_01_RT", "type": "Feature", @@ -161,7 +161,7 @@ Planet example: ``` { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": ["eo"], "id": "20171110_121030_1013", "type": "Feature", diff --git a/extensions/eo/examples/example-landsat8.json b/extensions/eo/examples/example-landsat8.json index 900b9bcd1..8db35433d 100644 --- a/extensions/eo/examples/example-landsat8.json +++ b/extensions/eo/examples/example-landsat8.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "view", diff --git a/extensions/label/examples/multidataset/catalog.json b/extensions/label/examples/multidataset/catalog.json index bb7d520d6..a40b38d80 100644 --- a/extensions/label/examples/multidataset/catalog.json +++ b/extensions/label/examples/multidataset/catalog.json @@ -2,7 +2,7 @@ "id": "label_extension_demo", "title": "label extension demo", "description": "Sample ML training data labels in the STAC format", - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "links": [ { diff --git a/extensions/label/examples/multidataset/spacenet-buildings/AOI_2_Vegas_img2636.json b/extensions/label/examples/multidataset/spacenet-buildings/AOI_2_Vegas_img2636.json index 32ab0beb3..76e2f5592 100644 --- a/extensions/label/examples/multidataset/spacenet-buildings/AOI_2_Vegas_img2636.json +++ b/extensions/label/examples/multidataset/spacenet-buildings/AOI_2_Vegas_img2636.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "label", "version" diff --git a/extensions/label/examples/multidataset/spacenet-buildings/AOI_3_Paris_img1648.json b/extensions/label/examples/multidataset/spacenet-buildings/AOI_3_Paris_img1648.json index 6fe3947d4..4c01dfa6f 100644 --- a/extensions/label/examples/multidataset/spacenet-buildings/AOI_3_Paris_img1648.json +++ b/extensions/label/examples/multidataset/spacenet-buildings/AOI_3_Paris_img1648.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "label", "version" diff --git a/extensions/label/examples/multidataset/spacenet-buildings/AOI_4_Shanghai_img3344.json b/extensions/label/examples/multidataset/spacenet-buildings/AOI_4_Shanghai_img3344.json index 00cedce17..c0cf0eada 100644 --- a/extensions/label/examples/multidataset/spacenet-buildings/AOI_4_Shanghai_img3344.json +++ b/extensions/label/examples/multidataset/spacenet-buildings/AOI_4_Shanghai_img3344.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "label", "version" diff --git a/extensions/label/examples/multidataset/spacenet-buildings/collection.json b/extensions/label/examples/multidataset/spacenet-buildings/collection.json index 7b921eb15..0448bd177 100644 --- a/extensions/label/examples/multidataset/spacenet-buildings/collection.json +++ b/extensions/label/examples/multidataset/spacenet-buildings/collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "id": "spacenet-buildings-collection", "title": "spacenet-buildings AoI", "description": "Collection of training labels for spacenet-buildings", diff --git a/extensions/label/examples/multidataset/zanzibar/collection.json b/extensions/label/examples/multidataset/zanzibar/collection.json index 41a111171..b74735f71 100644 --- a/extensions/label/examples/multidataset/zanzibar/collection.json +++ b/extensions/label/examples/multidataset/zanzibar/collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "id": "zanzibar-collection", "title": "zanzibar AoI", "description": "Collection of training labels for zanzibar", diff --git a/extensions/label/examples/multidataset/zanzibar/znz001.json b/extensions/label/examples/multidataset/zanzibar/znz001.json index bc4a744f4..612dd6d61 100644 --- a/extensions/label/examples/multidataset/zanzibar/znz001.json +++ b/extensions/label/examples/multidataset/zanzibar/znz001.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "label", "version" diff --git a/extensions/label/examples/multidataset/zanzibar/znz029.json b/extensions/label/examples/multidataset/zanzibar/znz029.json index bfda5e80c..ce9d94772 100644 --- a/extensions/label/examples/multidataset/zanzibar/znz029.json +++ b/extensions/label/examples/multidataset/zanzibar/znz029.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "label", "version" diff --git a/extensions/label/examples/spacenet-roads/roads_collection.json b/extensions/label/examples/spacenet-roads/roads_collection.json index 6ac238d74..6b488851f 100644 --- a/extensions/label/examples/spacenet-roads/roads_collection.json +++ b/extensions/label/examples/spacenet-roads/roads_collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "id": "spacenet-roads-sample", "description": "A sample of the SpaceNet Roads dataset built during STAC Sprint 4. The dataset contains hand-labeled roads.", "keywords": [ diff --git a/extensions/label/examples/spacenet-roads/roads_item.json b/extensions/label/examples/spacenet-roads/roads_item.json index f77222028..4bfea3dcf 100644 --- a/extensions/label/examples/spacenet-roads/roads_item.json +++ b/extensions/label/examples/spacenet-roads/roads_item.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "label", "version" diff --git a/extensions/label/examples/spacenet-roads/roads_source.json b/extensions/label/examples/spacenet-roads/roads_source.json index a1ecd70e1..93b8b06ec 100644 --- a/extensions/label/examples/spacenet-roads/roads_source.json +++ b/extensions/label/examples/spacenet-roads/roads_source.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [], "type": "Feature", "bbox": [2.23379639995, 49.0178709, 2.23730639995, 49.0213809], diff --git a/extensions/pointcloud/examples/example-autzen.json b/extensions/pointcloud/examples/example-autzen.json index 26ee44acf..5b57b7b28 100644 --- a/extensions/pointcloud/examples/example-autzen.json +++ b/extensions/pointcloud/examples/example-autzen.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "pointcloud" ], diff --git a/extensions/projection/examples/example-landsat8.json b/extensions/projection/examples/example-landsat8.json index 81a9bb44d..8011900b1 100644 --- a/extensions/projection/examples/example-landsat8.json +++ b/extensions/projection/examples/example-landsat8.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "proj" diff --git a/extensions/sar/examples/envisat.json b/extensions/sar/examples/envisat.json index 1f60b2408..a6536500b 100644 --- a/extensions/sar/examples/envisat.json +++ b/extensions/sar/examples/envisat.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "sat", "sar" diff --git a/extensions/sar/examples/sentinel1.json b/extensions/sar/examples/sentinel1.json index 496a2b387..68836edf6 100644 --- a/extensions/sar/examples/sentinel1.json +++ b/extensions/sar/examples/sentinel1.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "checksum", "sar", diff --git a/extensions/sat/examples/example-landsat8.json b/extensions/sat/examples/example-landsat8.json index 53f1e35b9..00ec5dd04 100644 --- a/extensions/sat/examples/example-landsat8.json +++ b/extensions/sat/examples/example-landsat8.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "sat", "view" diff --git a/extensions/scientific/examples/collection.json b/extensions/scientific/examples/collection.json index c5e7c9e92..19a4ee60f 100644 --- a/extensions/scientific/examples/collection.json +++ b/extensions/scientific/examples/collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": ["scientific"], "id": "MERRAclim", "title": "MERRAclim, a high-resolution global dataset of remotely sensed bioclimatic variables for ecological modelling.", diff --git a/extensions/scientific/examples/item.json b/extensions/scientific/examples/item.json index 858378465..3e1c74ae0 100644 --- a/extensions/scientific/examples/item.json +++ b/extensions/scientific/examples/item.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "scientific", "checksum" diff --git a/extensions/single-file-stac/examples/example-search.json b/extensions/single-file-stac/examples/example-search.json index 17baf2ceb..647fc7ab4 100644 --- a/extensions/single-file-stac/examples/example-search.json +++ b/extensions/single-file-stac/examples/example-search.json @@ -346,7 +346,7 @@ "earth observation", "usgs" ], - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "extent": { "spatial": [ -180, diff --git a/extensions/version/examples/collection.json b/extensions/version/examples/collection.json index 797d102cf..e16273e4c 100644 --- a/extensions/version/examples/collection.json +++ b/extensions/version/examples/collection.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": ["version"], "id": "merraclim", "title": "MERRAclim", diff --git a/extensions/version/examples/item.json b/extensions/version/examples/item.json index e4ce689ed..ba8698931 100644 --- a/extensions/version/examples/item.json +++ b/extensions/version/examples/item.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "version" ], diff --git a/extensions/view/README.md b/extensions/view/README.md index e94541bcc..67f15f7bf 100644 --- a/extensions/view/README.md +++ b/extensions/view/README.md @@ -31,7 +31,7 @@ The angles `azimuth` and `sun_azimuth` indicate the position of the viewed scene Example: ``` { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "view", "sat" diff --git a/extensions/view/examples/example-landsat8.json b/extensions/view/examples/example-landsat8.json index a387fc8b4..418ff83c7 100644 --- a/extensions/view/examples/example-landsat8.json +++ b/extensions/view/examples/example-landsat8.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "sat", "view" diff --git a/item-spec/examples/CBERS_4_MUX_20181029_177_106_L4.json b/item-spec/examples/CBERS_4_MUX_20181029_177_106_L4.json index 84a025b11..0a03c0529 100755 --- a/item-spec/examples/CBERS_4_MUX_20181029_177_106_L4.json +++ b/item-spec/examples/CBERS_4_MUX_20181029_177_106_L4.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "proj", diff --git a/item-spec/examples/datetimerange.json b/item-spec/examples/datetimerange.json index f07184f9d..72aaeb101 100644 --- a/item-spec/examples/datetimerange.json +++ b/item-spec/examples/datetimerange.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [], "type":"Feature", "id":"half-moon-bay/video-2018-01-01-0001", diff --git a/item-spec/examples/digitalglobe-sample.json b/item-spec/examples/digitalglobe-sample.json index b7d04489d..053f52ede 100644 --- a/item-spec/examples/digitalglobe-sample.json +++ b/item-spec/examples/digitalglobe-sample.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "proj", diff --git a/item-spec/examples/itemcollection-sample-full.json b/item-spec/examples/itemcollection-sample-full.json index 641e9bc4e..6614d3591 100644 --- a/item-spec/examples/itemcollection-sample-full.json +++ b/item-spec/examples/itemcollection-sample-full.json @@ -1,10 +1,10 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [], "type": "FeatureCollection", "features": [ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [], "type": "Feature", "id": "CS3-20160503_132131_05", diff --git a/item-spec/examples/itemcollection-sample-minimal.json b/item-spec/examples/itemcollection-sample-minimal.json index 0005766cc..c5d879118 100644 --- a/item-spec/examples/itemcollection-sample-minimal.json +++ b/item-spec/examples/itemcollection-sample-minimal.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [], "type": "FeatureCollection", "features": [] diff --git a/item-spec/examples/landsat8-sample.json b/item-spec/examples/landsat8-sample.json index e941ee0c7..a068fa365 100644 --- a/item-spec/examples/landsat8-sample.json +++ b/item-spec/examples/landsat8-sample.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "view", diff --git a/item-spec/examples/planet-sample.json b/item-spec/examples/planet-sample.json index d33a87c9d..10948a04e 100644 --- a/item-spec/examples/planet-sample.json +++ b/item-spec/examples/planet-sample.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "view", diff --git a/item-spec/examples/sample-full.json b/item-spec/examples/sample-full.json index f1586df91..2b50f2552 100644 --- a/item-spec/examples/sample-full.json +++ b/item-spec/examples/sample-full.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "view", diff --git a/item-spec/examples/sample.json b/item-spec/examples/sample.json index 73839ddcd..bd2b02831 100644 --- a/item-spec/examples/sample.json +++ b/item-spec/examples/sample.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [], "type": "Feature", "id": "CS3-20160503_132130_04", diff --git a/item-spec/examples/sentinel2-sample.json b/item-spec/examples/sentinel2-sample.json index 6bc22b4c5..22858b69c 100644 --- a/item-spec/examples/sentinel2-sample.json +++ b/item-spec/examples/sentinel2-sample.json @@ -1,5 +1,5 @@ { - "stac_version": "0.9.0-rc2", + "stac_version": "0.9.0", "stac_extensions": [ "eo", "view", diff --git a/item-spec/json-schema/item.json b/item-spec/json-schema/item.json index 831643649..c434582eb 100644 --- a/item-spec/json-schema/item.json +++ b/item-spec/json-schema/item.json @@ -52,7 +52,7 @@ "stac_version": { "title": "STAC version", "type": "string", - "const": "0.9.0-rc2" + "const": "0.9.0" }, "stac_extensions": { "title": "STAC extensions", diff --git a/item-spec/json-schema/itemcollection.json b/item-spec/json-schema/itemcollection.json index 4b22dda9f..194c8246f 100644 --- a/item-spec/json-schema/itemcollection.json +++ b/item-spec/json-schema/itemcollection.json @@ -30,7 +30,7 @@ "stac_version": { "title": "STAC version", "type": "string", - "const": "0.9.0-rc2" + "const": "0.9.0" }, "stac_extensions": { "title": "STAC extensions", From 3c4086530666bd2f40289e1376cddce410d84ca1 Mon Sep 17 00:00:00 2001 From: Matthew Hanson Date: Wed, 26 Feb 2020 12:28:30 -0500 Subject: [PATCH 12/19] revert CHANGELOG --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6d661c9f1..ad36dff07 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0. ## Unreleased -## [v0.9.0] - 2020-02-12 +## [v0.9.0-rc2] - 2020-02-12 ### Added - [Basics](item-spec/common-metadata.md#basics) added to Common Metadata definitions with new `description` field for From 7abb88c63804fe7029457550a72235f3a495d8e1 Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Wed, 26 Feb 2020 09:29:04 -0800 Subject: [PATCH 13/19] put explicit catalog.json in the example --- collection-spec/examples/landsat-collection.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/collection-spec/examples/landsat-collection.json b/collection-spec/examples/landsat-collection.json index 3c9b1081b..80f6af33d 100644 --- a/collection-spec/examples/landsat-collection.json +++ b/collection-spec/examples/landsat-collection.json @@ -148,7 +148,7 @@ }, { "rel": "child", - "href": "https://landsat-stac.s3.amazonaws.com/landsat-8-l1/paths" + "href": "https://landsat-stac.s3.amazonaws.com/landsat-8-l1/paths/catalog.json" } ] } \ No newline at end of file From 4985ac699889acc1ac5ddfa282d85f7aa228b70b Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Wed, 26 Feb 2020 09:42:02 -0800 Subject: [PATCH 14/19] Update CHANGELOG.md --- CHANGELOG.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 408428f63..cfa830c73 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0. ## Unreleased +### Fixed +- Fixed links in the Landsat example in the collection-spec. + ## [v0.9.0-rc2] - 2020-02-12 ### Added From 4e7003dac11dc32d6367013f9abf3a46e852827f Mon Sep 17 00:00:00 2001 From: Matthew Hanson Date: Wed, 26 Feb 2020 12:44:54 -0500 Subject: [PATCH 15/19] ci: update docker image in circleci --- .circleci/config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.circleci/config.yml b/.circleci/config.yml index 9016b9244..80bafac35 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -3,7 +3,7 @@ jobs: build: working_directory: ~/stac docker: - - image: circleci/python:3.6.9 + - image: circleci/python:3.7.4 steps: - checkout From 2af60ea70bb07b5f145d933de042fa164ddebe1f Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Wed, 26 Feb 2020 09:45:21 -0800 Subject: [PATCH 16/19] Fixed typo on https repeat thanks @philvarner for the catch --- collection-spec/examples/landsat-item.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/collection-spec/examples/landsat-item.json b/collection-spec/examples/landsat-item.json index 440a3b078..97dc1967f 100644 --- a/collection-spec/examples/landsat-item.json +++ b/collection-spec/examples/landsat-item.json @@ -175,7 +175,7 @@ }, { "rel": "root", - "href": "https://https://landsat-stac.s3.amazonaws.com/catalog.json" + "href": "https://landsat-stac.s3.amazonaws.com/catalog.json" } ] } From 5ceeba5b06c7f78d6a636955992eb8f3760b25ae Mon Sep 17 00:00:00 2001 From: Matthew Hanson Date: Wed, 26 Feb 2020 12:52:10 -0500 Subject: [PATCH 17/19] updated CHANGELOG --- CHANGELOG.md | 100 +++++++++++++++++++++++---------------------------- 1 file changed, 45 insertions(+), 55 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ad36dff07..ef970c64d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,69 +6,45 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0. ## Unreleased -## [v0.9.0-rc2] - 2020-02-12 - -### Added -- [Basics](item-spec/common-metadata.md#basics) added to Common Metadata definitions with new `description` field for -Item properties -- New fields to the `link` object to facilitate [pagination support for POST requests](api-spec/api-spec.md#paging-extension) -- Data role, as a suggestion for a common role for data files to be used in case data providers don't come up with their own names and semantics -- Clarification text on HTTP verbs in STAC API -- [View Geometry Extension](extensions/view/README.md) - -### Changed -- Item `title` definition moved from core Item fields to [Common Metadata Basics](item-spec/common-metadata.md#basics) -fields. No change is required for STAC Items. -- `putFeature` can return a `PreconditionFailed` to provide more explicit information when the resource has changed in the server -- [Sort extension](api-spec/extensions/sort) now uses "+" and "-" prefixes for GET requests to denote sort order. -- Clarified how `/search` links must be added to `/` and changed that links to both GET and POST must be provided now that the method can be specified in links. -- Moved angle definitions between extensions `view` and `sat` - - `sat:off_nadir_angle` -> `view:off_nadir` - - `sat:azimuth_angle` -> `view:azimuth` - - `sat:incidence_angle` -> `view:incidence_angle` - - `sat:sun_azimuth_angle` -> `view:sun_azimuth` - - `sat:sun_elevation_angle` -> `view:sun_elevation` - - -### Removed -- In API, removed any mention of using media type `multipart/form-data` and `x-www-form-urlencoded` - -### Fixed -- Fixed Item JSON Schema now `allOf` optional Common Metadata properties are evaluated -- Clarified usage of optional Common Metadata fields for STAC Items -- Clarified usage of paging options, especially in relation to what OGC API - Features offers -- Allow Commonmark in asset description, as it's allowed everywhere else -- Put asset description in the API -- Fixed API spec regarding license expressions -- Added missing schema in the API Version extension - -## [v0.9.0-rc1] - 2020-01-06 +## [v0.9.0] - 2020-02-26 ### Added - ItemCollection requires `stac_version` field, `stac_extensions` has also been added - A `description` field has been added to Item assets (also Asset definitions extension) -- Field `mission` to [Common Metadata fields](item-spec/common-metadata.md). +- Field `mission` to [Common Metadata fields](item-spec/common-metadata.md) - Extensions: - - [Version Indicators extension](extensions/version/README.md), adds `version` and `deprecated` fields to STAC Items and Collections + - [Version Indicators extension](extensions/version/README.md), new `version` and `deprecated` fields in STAC Items and Collections - Data Cube extension can be used in Collections, added new field `description` - - Added `description` and `roles` fields to the Asset in the [Asset Extension](extensions/asset/README.md) - - Projection Extension to describe Items with Assets that have an associated geospatial projection + - [Asset Extension](extensions/asset/README.md): new `description` and `roles` fields + - New [Projection Extension](extensions/proj/README.md) to describe Items with Assets that have an associated geospatial projection + - New [View Geometry Extension](extensions/view/README.md) - STAC API: - Added the [Item and Collection API Version extension](api-spec/extensions/version/README.md) to support versioning in the API specification - Run `npm run serve` or `npm run serve-ext` to quickly render development versions of the OpenAPI spec in the browser +- [Basics](item-spec/common-metadata.md#basics) added to Common Metadata definitions with new `description` field for +Item properties +- New fields to the `link` object to facilitate [pagination support for POST requests](api-spec/api-spec.md#paging-extension) +- `data` role, as a suggestion for a common role for data files to be used in case data providers don't come up with their own names and semantics +- Clarification text on HTTP verbs in STAC API ### Changed - Support for [CommonMark 0.29 instead of CommonMark 0.28](https://spec.commonmark.org/0.29/changes.html) - Collection field `property` and the merge ability moved to a new extension 'Commons' - Added attribute `roles` to Item assets (also Asset definitions extension), to be used similarly to Link `rel` - Updated API yaml to clarify bbox filter should be implemented without brackets. Example: `bbox=160.6,-55.95,-170,-25.89` -- Collection `summaries` merge array fields now. +- Collection `summaries` merge array fields now - Several fields have been moved from extensions or item fields to the [Common Metadata fields](item-spec/common-metadata.md): - - `eo:platform` / `sar:platform` => `platform` - - `eo:instrument` / `sar:instrument` => `instruments`, also changed from string to array of strings - - `eo:constellation` / `sar:constellation` => `constellation` - - `dtr:start_datetime` => `start_datetime` - - `dtr:end_datetime` => `end_datetime` + - `eo:platform` / `sar:platform` => `platform` + - `eo:instrument` / `sar:instrument` => `instruments`, also changed from string to array of strings + - `eo:constellation` / `sar:constellation` => `constellation` + - `dtr:start_datetime` => `start_datetime` + - `dtr:end_datetime` => `end_datetime` +- Moved angle definitions from extensions `eo` and new `view` extension + - `eo:off_nadir` -> `view:off_nadir` + - `eo:azimuth` -> `view:azimuth` + - `eo:incidence_angle` -> `view:incidence_angle` + - `eo:sun_azimuth` -> `view:sun_azimuth` + - `eo:sun_elevation` -> `view:sun_elevation` - Extensions: - Data Cube extension: Changed allowed formats (removed PROJ string, added PROJJSON / WKT2) for reference systems - [Checksum extension](extensions/checksum/README.md) is now using self-identifiable hashes ([Multihash](https://github.com/multiformats/multihash)) @@ -80,28 +56,43 @@ fields. No change is required for STAC Items. - Fields extension has a simplified format for GET parameters - `search` extension renamed to `context` extension. JSON object renamed from `search:metadata` to `context` - Removed "next" from the search metadata and query parameter, added POST body and headers to the links for paging support - - Query Extension - type restrictions on query predicates are more accurate, which may require additional implementation support. + - Query Extension - type restrictions on query predicates are more accurate, which may require additional implementation support +- Item `title` definition moved from core Item fields to [Common Metadata Basics](item-spec/common-metadata.md#basics) +fields. No change is required for STAC Items. +- `putFeature` can return a `PreconditionFailed` to provide more explicit information when the resource has changed in the server +- [Sort extension](api-spec/extensions/sort) now uses "+" and "-" prefixes for GET requests to denote sort order. +- Clarified how `/search` links must be added to `/` and changed that links to both GET and POST must be provided now that the method can be specified in links ### Removed - `version` field in STAC Collections. Use [Version Extension](extensions/version/README.md) instead - `summaries` field from Catalogs. Use Collections instead -- Asset Types (pre-defined values for the keys of individual assets, *not* media types) in Items. Use the asset's `roles` instead. -- `license` field doesn't allow SPDX expressions any longer. Use `various` and links instead. +- Asset Types (pre-defined values for the keys of individual assets, *not* media types) in Items. Use the asset's `roles` instead +- `license` field doesn't allow SPDX expressions any longer. Use `various` and links instead - Extensions: - `eo:platform`, `eo:instrument`, `eo:constellation` from EO extension, and `sar:platform`, `sar:instrument`, `sar:constellation` from the [SAR extension](extensions/sar/README.md) - Removed from EO extension field `eo:epsg` in favor of `proj:epsg` - `gsd` and `accuracy` from `eo:bands` in the [EO extension](extensions/eo/README.md) - `sar:absolute_orbit` and `sar:center_wavelength` fields from the [SAR extension](extensions/sar/README.md) - `data_type` and `unit` from the `sar:bands` object in the [SAR extension](extensions/sar/README.md) - - Datetime Range (`dtr`) extension. Use the [Common Metadata fields](item-spec/common-metadata.md) instead. + - Datetime Range (`dtr`) extension. Use the [Common Metadata fields](item-spec/common-metadata.md) instead - STAC API: - `next` from the search metadata and query parameter +- In API, removed any mention of using media type `multipart/form-data` and `x-www-form-urlencoded` ### Fixed -- The `license` field in Item and Collection spec explicitly mentions that the value `proprietary` without a link means that the data is private. -- Clarified how to fill `stac_extensions`. +- The `license` field in Item and Collection spec explicitly mentions that the value `proprietary` without a link means that the data is private +- Clarified how to fill `stac_extensions` - More clarifications; typos fixed +- Fixed Item JSON Schema now `allOf` optional Common Metadata properties are evaluated +- Clarified usage of optional Common Metadata fields for STAC Items +- Clarified usage of paging options, especially in relation to what OGC API - Features offers +- Allow Commonmark in asset description, as it's allowed everywhere else +- Put asset description in the API +- Fixed API spec regarding license expressions +- Added missing schema in the API Version extension +- Fixed links in the Landsat example in the collection-spec + ## [v0.8.1] - 2019-11-01 @@ -311,8 +302,7 @@ Thanks @hgs-msmith, @matthewhanson, @hgs-trutherford, @rouault, @joshfix, @alkam [Unreleased]: https://github.com/radiantearth/stac-spec/compare/master...dev -[v0.9.0]: https://github.com/radiantearth/stac-spec/compare/v0.9.0-rc1...v0.9.0 -[v0.9.0-rc1]: https://github.com/radiantearth/stac-spec/compare/v0.8.0...v0.9.0-rc1 +[v0.9.0]: https://github.com/radiantearth/stac-spec/compare/v0.8.1...v0.9.0 [v0.8.1]: https://github.com/radiantearth/stac-spec/compare/v0.8.0...v0.8.1 [v0.8.0]: https://github.com/radiantearth/stac-spec/compare/v0.7.0...v0.8.0 [v0.7.0]: https://github.com/radiantearth/stac-spec/compare/v0.6.2...v0.7.0 From e91dff3cb2fdf7b6be3874d4f714c5113c798a94 Mon Sep 17 00:00:00 2001 From: Matthew Hanson Date: Wed, 26 Feb 2020 12:58:09 -0500 Subject: [PATCH 18/19] ci: updated circleci config --- .circleci/config.yml | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/.circleci/config.yml b/.circleci/config.yml index 80bafac35..899251fea 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -3,17 +3,18 @@ jobs: build: working_directory: ~/stac docker: - - image: circleci/python:3.7.4 + - image: circleci/python:3.7 steps: - checkout - run: sudo chown -R circleci:circleci /usr/local/bin - - run: sudo chown -R circleci:circleci /usr/local/lib/python3.6/site-packages + - run: sudo chown -R circleci:circleci /usr/local/lib/python3.7/site-packages - run: name: install command: | pip install stac-validator - sudo apt-get install curl software-properties-common + sudo apt-get update + sudo apt-get install curl -y software-properties-common curl -sL https://deb.nodesource.com/setup_13.x | sudo -E bash - sudo apt-get install -y nodejs sudo npm install -g remark-cli remark-validate-links From b34b5927016332a57a2011a0db45645828ea7094 Mon Sep 17 00:00:00 2001 From: Matthew Hanson Date: Wed, 26 Feb 2020 13:01:34 -0500 Subject: [PATCH 19/19] fix link in CHANGELOG --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ef970c64d..4a89eb607 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -16,7 +16,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0. - [Version Indicators extension](extensions/version/README.md), new `version` and `deprecated` fields in STAC Items and Collections - Data Cube extension can be used in Collections, added new field `description` - [Asset Extension](extensions/asset/README.md): new `description` and `roles` fields - - New [Projection Extension](extensions/proj/README.md) to describe Items with Assets that have an associated geospatial projection + - New [Projection Extension](extensions/projection/README.md) to describe Items with Assets that have an associated geospatial projection - New [View Geometry Extension](extensions/view/README.md) - STAC API: - Added the [Item and Collection API Version extension](api-spec/extensions/version/README.md) to support versioning in the API specification