Skip to content

Commit

Permalink
Added stac-prov profile
Browse files Browse the repository at this point in the history
  • Loading branch information
rob-metalinkage committed May 22, 2024
1 parent 497c395 commit 660bbbc
Show file tree
Hide file tree
Showing 7 changed files with 206 additions and 0 deletions.
24 changes: 24 additions & 0 deletions _sources/item-prov/bblock.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
{
"$schema": "https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/master/ogc/bblocks/metadata-schema.yaml",
"name": "STAC Item with Provenance",
"highlighted": true,
"abstract": "A SpatioTemporal Asset Catalogs (STAC) item with a provenance trace supporting the PROV-O model and DAG (directed acyclic graph) through both object nesting and references",
"status": "under-development",
"dateTimeAddition": "2023-12-08T00:00:00Z",
"itemClass": "schema",
"register": "ogcincubator",
"version": "0.1",
"dateOfLastChange": "2023-12-09",
"sources": [
{
"title": "STAC Specification",
"link": "https://stacspec.org/en/about/stac-spec/"
},
{
"title": "PROV-O Specification",
"link": "https://www.w3.org/TR/prov-o/"
}
],
"scope": "contrib",
"tags": ["stac", "item", "provenance"]
}
33 changes: 33 additions & 0 deletions _sources/item-prov/examples.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
- title: STAC item with link to provenance
content: |
This is the simple item example from the STAC specification, augmented with the simplest possible form of provenance - a link to a resource that provides provenance details.
a STAC item is a prov:Entity with the "wasGeneratedBy" property defined by PROV-O.
snippets:
- language: json
ref: examples/item-prov-link.json
base-uri: 'https://example.com/stac/example1/'


- title: STAC item with a generation activity description
content: |
This is the simple item example from the STAC specification, augmented a description of the activity that generated it, with nested set of entities the object derives from.
A STAC item is a prov:Entity with the "wasGeneratedBy" property defined by PROV-O.
snippets:
- language: json
ref: examples/item-prov-nested.json
base-uri: 'https://example.com/stac/example1/'

- title: STAC item with a provenance graph
content: |
This is the simple item example from the STAC specification, augmented an array of Provenance objects that define a DAG (Directed Acyclic Graph) that can fully describe a set of contributing activities, entities and agents.)
A STAC item is a prov:Entity with the "has_provenance" property whose range is an array of objects defined by the PROV-O model.
snippets:
- language: json
ref: examples/item-prov-dag.json
base-uri: 'https://example.com/stac/example1/'
60 changes: 60 additions & 0 deletions _sources/item-prov/examples/item-prov-dag.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
{
"stac_version": "1.0.0",
"stac_extensions": [
"https://stac-extensions.github.io/prov/v1.0.0/schema.json"
],
"type": "Feature",
"id": "20201211_223832_CS2",
"bbox": [
172.91173669923782,
1.3438851951615003,
172.95469614953714,
1.3690476620161975
],
"has_provenance": [
{
"id": "DP-2223",
"provType": "Entity",
"featureType": "ftc:SomeKindOfSurvey",
"wasGeneratedBy": "surveys:DP-1-S1"
},
{
"provType": "Activity",
"id": "surveys:DP-1-S1",
"activityType": "InitialSurvey",
"endedAtTime": "2023-10-05T05:03:15+01:00",
"wasAssociatedWith": "staff:jd234",
"used": {
"id": "regulations:Act3",
"entityType": "Legislation",
"wasAttributedTo": "agents:someGovernment",
"links": [
{
"href": "https://some.gov/linktoact/",
"rel": "related"
}
]
}
}
],
"geometry": {
"type": "Point",
"coordinates": [
172.91173669923782,
1.3438851951615003
]
},
"properties": {
"datetime": "2020-12-11T22:38:32.125000Z"
},
"collection": "simple-collection",
"links": [
{
"rel": "collection",
"href": "./collection.json",
"type": "application/json",
"title": "Simple Example Collection"
}
],
"assets": {}
}
38 changes: 38 additions & 0 deletions _sources/item-prov/examples/item-prov-link.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@

{
"stac_version": "1.0.0",
"stac_extensions": ["https://stac-extensions.github.io/prov/v1.0.0/schema.json"],
"type": "Feature",
"id": "20201211_223832_CS2",
"bbox": [
172.91173669923782,
1.3438851951615003,
172.95469614953714,
1.3690476620161975
],
"wasGeneratedBy": "http://mysystem.io/prov?object=20201211_223832_CS2" ,
"geometry": {
"type": "Point",
"coordinates": [


172.91173669923782,
1.3438851951615003

]
},
"properties": {
"datetime": "2020-12-11T22:38:32.125000Z"
},
"collection": "simple-collection",
"links": [
{
"rel": "collection",
"href": "./collection.json",
"type": "application/json",
"title": "Simple Example Collection"
}
],
"assets": {
}
}
38 changes: 38 additions & 0 deletions _sources/item-prov/examples/item-prov-nested.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@

{
"stac_version": "1.0.0",
"stac_extensions": ["https://stac-extensions.github.io/prov/v1.0.0/schema.json"],
"type": "Feature",
"id": "20201211_223832_CS2",
"bbox": [
172.91173669923782,
1.3438851951615003,
172.95469614953714,
1.3690476620161975
],
"wasGeneratedBy": "http://mysystem.io/prov?object=20201211_223832_CS2" ,
"geometry": {
"type": "Point",
"coordinates": [


172.91173669923782,
1.3438851951615003

]
},
"properties": {
"datetime": "2020-12-11T22:38:32.125000Z"
},
"collection": "simple-collection",
"links": [
{
"rel": "collection",
"href": "./collection.json",
"type": "application/json",
"title": "Simple Example Collection"
}
],
"assets": {
}
}
12 changes: 12 additions & 0 deletions _sources/item-prov/schema.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
"$schema": https://json-schema.org/draft/2020-12/schema
description: 'STAC Collection'
allOf:
- $ref: bblocks://ogc.ogc-utils.prov#/$defs/Entity
- $ref: https://github.com/radiantearth/stac-spec/raw/master/item-spec/json-schema/item.json
- type: object
properties:
stac_extensions:
type: array
contains:
const: https://stac-extensions.github.io/prov/v1.0.0/schema.json

1 change: 1 addition & 0 deletions bblocks-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,3 +15,4 @@ imports:
- default
- https://ogcincubator.github.io/bblocks-ogcapi-features/build/register.json
- https://ogcincubator.github.io/bblocks-ogcapi-records/build/register.json
- https://ogcincubator.github.io/bblock-prov-schema/build/register.json

0 comments on commit 660bbbc

Please sign in to comment.