Merge pull request #4 from ogcincubator/version-agnostic

rob-metalinkage · web-flow · commit 77528ea5a213 · 2025-12-01T06:33:43.000+08:00
Version agnostic - with assets refactored
diff --git a/_sources/collection-v1-0-0/context.jsonld b/_sources/collection-v1-0-0/context.jsonld
diff --git a/_sources/collection-v1-0-0/examples.yaml b/_sources/collection-v1-0-0/examples.yaml
@@ -1,4 +1,7 @@
-- title: Example STAC Collection
-  content: |
-    STAC no longer publishes v1.0.0 examples - to be explored.
+- title:  STAC Collection v1.0.0
+  content: Ref to STAC example using version (1.0.0)
+  snippets:
+    - language: json
+      ref: https://esa-earthcode.github.io/open-science-catalog-metadata-staging/products/polarwarp/collection.json
+      base-uri: 'https://example.com/stac/example1/'
 #
diff --git a/_sources/collection-v1-0-0/schema.yaml b/_sources/collection-v1-0-0/schema.yaml
@@ -3,6 +3,7 @@ description: 'STAC Collection V1.0.0'
 allOf:
   # - $ref: bblocks://ogc.geo.common.data_types.geojson
   - $ref: https://schemas.stacspec.org/v1.0.0/collection-spec/json-schema/collection.json
+  - $ref: bblocks://ogc.contrib.stac.collection
   - type: object
     properties:
       links:
diff --git a/_sources/collection-v1-1-0/bblock.json b/_sources/collection-v1-1-0/bblock.json
@@ -0,0 +1,20 @@
+{
+  "$schema": "https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/master/ogc/bblocks/metadata-schema.yaml",
+  "name": "STAC Collection (v1.1.0)",
+  "highlighted": true,
+  "abstract": "A SpatioTemporal Asset Catalogs (STAC) collection.  This building block implements validation of examples using the canonical schema and a JSON-LD context to a map to a RDF format that can support richer logical constraints and integration with related data.",
+  "status": "under-development",
+  "dateTimeAddition": "2023-12-08T00:00:00Z",
+  "itemClass": "schema",
+  "register": "ogc-incubator-building-block-register",
+  "version": "1.1.0",
+  "dateOfLastChange": "2023-12-09",
+  "sources": [
+    {
+      "title": "STAC Specification",
+      "link": "https://stacspec.org/en/about/stac-spec/"
+    }
+  ],
+  "scope": "contrib",
+  "tags": ["stac", "collection"]
+}
diff --git a/_sources/collection-v1-1-0/examples.yaml b/_sources/collection-v1-1-0/examples.yaml
@@ -0,0 +1,5 @@
+- title: Example STAC Collection
+  snippets:
+    - language: json
+      ref: https://github.com/radiantearth/stac-spec/raw/master/examples/collection-only/collection.json
+      base-uri: 'https://example.com/stac/example1/'
diff --git a/_sources/collection-v1-1-0/schema.yaml b/_sources/collection-v1-1-0/schema.yaml
@@ -0,0 +1,14 @@
+"$schema": https://json-schema.org/draft/2020-12/schema
+description: 'STAC Collection V1.0.0'
+allOf:
+  # - $ref: bblocks://ogc.geo.common.data_types.geojson
+  - $ref: https://schemas.stacspec.org/v1.1.0/collection-spec/json-schema/collection.json
+  - $ref: bblocks://ogc.contrib.stac.collection
+  - type: object
+    properties:
+      stac-version:
+        title: STAC version
+        type: string
+        const: 1.1.0
+    required:
+      - stac_version
diff --git a/_sources/collection/context.jsonld b/_sources/collection/context.jsonld
@@ -24,24 +24,6 @@
       "@id": "stac:end_datetime",
       "@type": "xsd:dateTime"
     },
-    "assets": {
-      "@id": "stac:hasAsset",
-      "@container": "@set",
-      "@context": {
-        "thumbnail": {
-          "@id": "stac:thumbnail"
-        },
-        "overview": "stac:overview",
-        "data": "stac:data",
-        "metadata": "stac:metadata",
-        "type": "dct:format",
-        "title": "dct:title",
-        "roles": {
-          "@id": "stac:roles",
-          "@container": "@set"
-        }
-      }
-    },
     "providers": "stac:hasProvider",
     "media_type": "dct:format",
     "links": "rdfs:seeAlso"
diff --git a/_sources/collection/examples.yaml b/_sources/collection/examples.yaml
@@ -1,5 +1,13 @@
-- title: Example STAC Collection
+- title:  STAC Collection v1.1.0
+  content: Ref to STAC example from current version (1.1.0)
   snippets:
     - language: json
       ref: https://github.com/radiantearth/stac-spec/raw/master/examples/collection-only/collection.json
       base-uri: 'https://example.com/stac/example1/'
+
+- title:  STAC Collection v1.0.0
+  content: Ref to STAC example using version (1.0.0)
+  snippets:
+    - language: json
+      ref: https://esa-earthcode.github.io/open-science-catalog-metadata-staging/products/polarwarp/collection.json
+      base-uri: 'https://example.com/stac/example1/'
diff --git a/_sources/collection/schema.yaml b/_sources/collection/schema.yaml
@@ -4,6 +4,7 @@ description: This object represents Collections in a SpatioTemporal Asset Catalo
 allOf:
 - "$ref": "#/definitions/collection"
 - "$ref": "https://raw.githubusercontent.com/radiantearth/stac-spec/master/item-spec/json-schema/common.json"
+- $ref: bblocks://ogc.contrib.stac.components.assets
 definitions:
   collection:
     title: STAC Collection
@@ -12,18 +13,13 @@ definitions:
     "$comment": title, description, keywords, providers and license is validated through
       the common metadata.
     required:
-    - stac_version
     - type
     - id
     - description
     - license
     - extent
     - links
     properties:
-      stac_version:
-        title: STAC version
-        type: string
-        const: 1.1.0
       stac_extensions:
         title: STAC extensions
         type: array
@@ -90,8 +86,6 @@ definitions:
                     - 'null'
                     format: date-time
                     pattern: "(\\+00:00|Z)$"
-      assets:
-        "$ref": "bblocks://ogc.contrib.stac.item#/definitions/assets"
       item_assets:
         additionalProperties:
           allOf:
diff --git a/_sources/components/assets/bblock.json b/_sources/components/assets/bblock.json
@@ -0,0 +1,20 @@
+{
+  "$schema": "https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/master/ogc/bblocks/metadata-schema.yaml",
+  "name": "Assets object",
+  "highlighted": true,
+  "abstract": "Assets sub-schema reused in items and collections",
+  "status": "under-development",
+  "dateTimeAddition": "2023-12-08T00:00:00Z",
+  "itemClass": "schema",
+  "register": "ogc-building-block-register",
+  "version": "0.1",
+  "dateOfLastChange": "2023-12-09",
+  "sources": [
+    {
+      "title": "STAC Specification",
+      "link": "https://stacspec.org/en/about/stac-spec/"
+    }
+  ],
+  "scope": "contrib",
+  "tags": ["stac", "item"]
+}
diff --git a/_sources/components/assets/context.jsonld b/_sources/components/assets/context.jsonld
@@ -0,0 +1,22 @@
+{
+  "@context": {
+    "stac": "https://w3id.org/ogc/stac/core/",
+    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
+    "dct": "http://purl.org/dc/terms/",
+    "description": "dct:description",
+    "type": "dct:format",
+        "title": "dct:title",
+        "roles": {
+          "@id": "stac:roles",
+          "@container": "@set"
+        },
+    "@vocab": "https://w3id.org/ogc/stac/assets/",
+    "assets": {
+      "@id": "stac:hasAsset",
+      "@container": "@set",
+      "@context": {
+
+      }
+    }
+  }
+}
diff --git a/_sources/components/assets/examples.yaml b/_sources/components/assets/examples.yaml
@@ -0,0 +1,18 @@
+- title: Core asset types
+  content: |
+    This is the simple item  asset example from the STAC specification.  
+
+  snippets:
+    - language: json
+      ref: examples/core.json
+      base-uri: 'https://example.com/stac/example1/'
+
+- title: Extended asset types
+  content: |
+    Includes asset types not defined by core
+
+  snippets:
+    - language: json
+      ref: examples/coreplus.json
+
+      base-uri: 'https://example.com/stac/example1/'
diff --git a/_sources/components/assets/examples/core.json b/_sources/components/assets/examples/core.json
@@ -0,0 +1,20 @@
+{
+  "assets": {
+    "visual": {
+      "href": "https://storage.googleapis.com/open-cogs/stac-examples/20201211_223832_CS2.tif",
+      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+      "title": "3-Band Visual",
+      "roles": [
+        "visual"
+      ]
+    },
+    "thumbnail": {
+      "href": "https://storage.googleapis.com/open-cogs/stac-examples/20201211_223832_CS2.jpg",
+      "title": "Thumbnail",
+      "type": "image/jpeg",
+      "roles": [
+        "thumbnail"
+      ]
+    }
+  }
+}
diff --git a/_sources/components/assets/examples/coreplus.json b/_sources/components/assets/examples/coreplus.json
@@ -0,0 +1,30 @@
+{
+  "assets": {
+    "visual": {
+      "href": "https://storage.googleapis.com/open-cogs/stac-examples/20201211_223832_CS2.tif",
+      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+      "title": "3-Band Visual",
+      "roles": [
+        "visual"
+      ]
+    },
+    "thumbnail": {
+      "href": "https://storage.googleapis.com/open-cogs/stac-examples/20201211_223832_CS2.jpg",
+      "title": "Thumbnail",
+      "type": "image/jpeg",
+      "roles": [
+        "thumbnail"
+      ]
+    },
+    "model": {
+      "href": "https://huggingface.co/example/model-card",
+      "title": "Pytorch weights checkpoint",
+      "description": "Example model.",
+      "type": "text/html",
+      "roles": [
+        "mlm:model"
+      ],
+      "mlm:artifact_type": "torch.save"
+    }
+  }
+}
diff --git a/_sources/components/assets/schema.yaml b/_sources/components/assets/schema.yaml
@@ -0,0 +1,40 @@
+"$schema": https://json-schema.org/draft/2020-12/schema
+"title": "STAC Asset"
+"type": "object"
+"description": "This object represents a set of assets"
+properties:
+  assets:
+    $ref: "#/definitions/assets"
+
+definitions:
+  assets:
+    title: Asset links
+    description: Links to assets
+    type: object
+    additionalProperties:
+      "$ref": "#/definitions/asset"
+  asset:
+    allOf:
+    - type: object
+      required:
+      - href
+      properties:
+        href:
+          title: Asset reference
+          type: string
+          format: iri-reference
+          minLength: 1
+        title:
+          title: Asset title
+          type: string
+        description:
+          title: Asset description
+          type: string
+        type:
+          title: Asset type
+          type: string
+        roles:
+          title: Asset roles
+          type: array
+          items:
+            type: string
diff --git a/_sources/extensions/mlm/schema.yaml b/_sources/extensions/mlm/schema.yaml
@@ -5,6 +5,4 @@ allOf:
   - anyOf:
     - $ref: bblocks://ogc.contrib.stac.collection
     - $ref: bblocks://ogc.contrib.stac.item
-    - $ref: bblocks://ogc.contrib.stac.collection-v1-0-0
-    - $ref: bblocks://ogc.contrib.stac.item-v1-0-0
   - $ref: https://stac-extensions.github.io/mlm/v1.4.0/schema.json
diff --git a/_sources/extensions/themes/schema.yaml b/_sources/extensions/themes/schema.yaml
@@ -5,6 +5,11 @@ allOf:
   - anyOf:
     - $ref: bblocks://ogc.contrib.stac.collection
     - $ref: bblocks://ogc.contrib.stac.item
-    - $ref: bblocks://ogc.contrib.stac.collection-v1-0-0
-    - $ref: bblocks://ogc.contrib.stac.item-v1-0-0
+  # themes schema is version agnostic
   - $ref: https://stac-extensions.github.io/themes/v1.0.0/schema.json
+  # bind the themes property to the lower level building block from Records (Common in future)
+  - properties:
+      themes:
+        type: array
+        items:
+          $ref: bblocks://ogc.api.records.v1.schemas.theme
diff --git a/_sources/item-prov/schema.yaml b/_sources/item-prov/schema.yaml
@@ -4,7 +4,6 @@ allOf:
   - $ref: bblocks://ogc.ogc-utils.prov#/$defs/Entity
   - anyOf:
     - $ref: bblocks://ogc.contrib.stac.item
-    - $ref: bblocks://ogc.contrib.stac.item-v1-0-0
   - type: object
     properties:
       stac_extensions:
diff --git a/_sources/item-v1-0-0/bblock.json b/_sources/item-v1-0-0/bblock.json
@@ -1,8 +1,8 @@
 {
   "$schema": "https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/master/ogc/bblocks/metadata-schema.yaml",
-  "name": "STAC Item v1.0.0",
+  "name": "STAC Item (v1.0.0)",
   "highlighted": true,
-  "abstract": "A SpatioTemporal Asset Catalogs (STAC) item",
+  "abstract": "A SpatioTemporal Asset Catalogs (STAC) item. This version specific building block enforces the schema restriction on STAC version by importing the canonical STAC 1.0 schema, but also cross-validates against the STAC version agnostic schema.",
   "status": "under-development",
   "dateTimeAddition": "2023-12-08T00:00:00Z",
   "itemClass": "schema",
diff --git a/_sources/item-v1-0-0/context.jsonld b/_sources/item-v1-0-0/context.jsonld
diff --git a/_sources/item-v1-0-0/schema.yaml b/_sources/item-v1-0-0/schema.yaml
diff --git a/_sources/item-v1-1-0/bblock.json b/_sources/item-v1-1-0/bblock.json
diff --git a/_sources/item-v1-1-0/examples.yaml b/_sources/item-v1-1-0/examples.yaml
diff --git a/_sources/item-v1-1-0/schema.yaml b/_sources/item-v1-1-0/schema.yaml
diff --git a/_sources/item/bblock.json b/_sources/item/bblock.json
diff --git a/_sources/item/context.jsonld b/_sources/item/context.jsonld
diff --git a/_sources/item/schema.yaml b/_sources/item/schema.yaml
