osc:themes -> themes

Author: m-mohr

CHANGELOG.md

@@ -12,10 +12,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Use `themes` instead of the `osc:themes`
+
 ### Deprecated
 
 ### Removed
 
+- `osc:themes`
+
 ### Fixed
 
 ## [1.0.0-rc.3]

README.md

@@ -52,6 +52,7 @@ A set of satellite missions which provided input for the product.
 ## Fields
 
 The fields in the table below can be used in these parts of STAC documents:
+
 - [x] Catalogs
 - [x] Collections
 - [x] Item Properties
@@ -71,23 +72,24 @@ As such the extension does not validate Collection summaries.
 | osc:region    | string    | The name of the geographic region the project or product is dealing with if any, e.g `"Arctic"` or `"Agulhas"`. |
 | osc:variables | \[string] | The names of the variables the product is observing, e.g `"Wind stress"` or `"Geomagnetic field"`. |
 | osc:missions  | \[string] | The names of the satellite missions which provided input for this project or product.  |
-| osc:themes    | \[string] | The names of the themes the project or product is dealing with. |
 
 Fields that apply when the `osc:type` is set to `product`:
+
 - osc:name
 - osc:status - **REQUIRED**
 - osc:project - **REQUIRED**
 - osc:region
 - osc:variables
 - osc:missions
-- osc:themes
+- [themes](#themes)
 
 Fields that apply when the `osc:type` is set to `project`:
+
 - osc:name
 - osc:status - **REQUIRED**
 - osc:region
 - osc:missions
-- osc:themes
+- [themes](#themes)
 - [contacts](#contacts)
 
 ### Contacts
@@ -103,6 +105,17 @@ The following `roles` for contacts SHALL be used:
 - The role for the technical officer of a project is `technical_officer`.
 - The role for consortium partners is `consortium_member`.
 
+### Themes
+
+The following fields should be implemented from the [Themes extension](https://github.com/stac-extensions/themes):
+
+| Field Name | Type | Description |
+| ---------- | ---- | ----------- |
+| themes     | \[[Theme Object](https://github.com/stac-extensions/themes/blob/v1.0.0/README.md#theme-object)] | The names of the themes the project or product is dealing with. |
+
+The themes field can contain concepts from different controlled vocabularies (via `scheme`).
+By default this extension only asks to add concepts for the scheme `https://github.com/stac-extensions/osc#theme`.
+
 ## Contributing
 
 All contributions are subject to the
@@ -118,18 +131,21 @@ To run tests locally, you'll need `npm`, which is a standard part of any [node.j
 
 First you'll need to install everything with npm once. Just navigate to the root of this repository and on
 your command line run:
+
 ```bash
 npm install
 ```
 
 Then to check markdown formatting and test the examples against the JSON schema, you can run:
+
 ```bash
 npm test
 ```
 
 This will spit out the same texts that you see online, and you can then go and fix your markdown or examples.
 
 If the tests reveal formatting problems with the examples, you can fix them with:
+
 ```bash
 npm run format-examples
 ```

examples/4dionosphere-swarm-vip/catalog.json

@@ -5,14 +5,23 @@
   "description": "In the project Swarm satellite data and other datasets are used to determine determine the dominant scales in the ionosphere at different geomagnetic conditions and create a semi-empiric dynamic model of the ionosphere.",
   "stac_extensions": [
     "https://stac-extensions.github.io/osc/v1.0.0-rc.3/schema.json",
+    "https://stac-extensions.github.io/themes/v1.0.0/schema.json",
     "https://stac-extensions.github.io/contacts/v0.1.1/schema.json"
   ],
   "title": "SWARM VIP",
   "osc:name": "4DIONOSPHERE (SWARM VIP)",
   "osc:status": "completed",
   "osc:type": "project",
-  "osc:themes": [
-    "Magnetosphere_Ionosphere"
+  "themes": [
+    {
+      "concepts": [
+        {
+          "id": "magnetosphere-ionosphere",
+          "title": "Magnetosphere Ionosphere"
+        }
+      ],
+      "scheme": "https://github.com/stac-extensions/osc#theme"
+    }
   ],
   "contacts": [
     {

examples/4dionosphere-swarm-vip/model-ionosphere-4dionosphere/collection.json

@@ -3,7 +3,8 @@
   "id": "model-ionosphere-4dionosphere",
   "stac_version": "1.0.0",
   "stac_extensions": [
-    "https://stac-extensions.github.io/osc/v1.0.0-rc.3/schema.json"
+    "https://stac-extensions.github.io/osc/v1.0.0-rc.3/schema.json",
+    "https://stac-extensions.github.io/themes/v1.0.0/schema.json"
   ],
   "description": "Semi-empiric model and improvement of the forecasting capabilities for extreme space weather events. Swarm-VIP project performs extensive and complex statistical analysis on Swarm electron density, electric and magnetic field data focusing on: 1) the ionospheric climate/weather during quiet geomagnetic conditions; 2) the extreme events such as geomagnetic storms / superstorms and 3) the physics of ionospheric perturbations and small-scale variability. Currently the access to the results is restricted. If you would like to gain access, please contact Lasse Clausen (http://www.mn.uio.no/fysikk/english/people/aca/lbnc/) or Wojciech Miloch (http://www.mn.uio.no/fysikk/english/people/aca/wojciecm/index.html).",
   "title": "Semi-empiric model of ionosphere processes_SWARM",
@@ -16,8 +17,16 @@
   ],
   "osc:status": "completed",
   "osc:type": "product",
-  "osc:themes": [
-    "Magnetosphere_Ionosphere"
+  "themes": [
+    {
+      "concepts": [
+        {
+          "id": "magnetosphere-ionosphere",
+          "title": "Magnetosphere Ionosphere"
+        }
+      ],
+      "scheme": "https://github.com/stac-extensions/osc#theme"
+    }
   ],
   "keywords": [
     "theme:Magnetosphere_Ionosphere",

examples/4dionosphere-swarm-vip/model-ionosphere-4dionosphere/item.json

@@ -3,7 +3,8 @@
   "id": "example",
   "stac_version": "1.0.0",
   "stac_extensions": [
-    "https://stac-extensions.github.io/osc/v1.0.0-rc.3/schema.json"
+    "https://stac-extensions.github.io/osc/v1.0.0-rc.3/schema.json",
+    "https://stac-extensions.github.io/themes/v1.0.0/schema.json"
   ],
   "geometry": null,
   "properties": {
@@ -16,8 +17,16 @@
     ],
     "osc:status": "completed",
     "osc:type": "product",
-    "osc:themes": [
-      "Magnetosphere_Ionosphere"
+    "themes": [
+      {
+        "concepts": [
+          {
+            "id": "magnetosphere-ionosphere",
+            "title": "Magnetosphere Ionosphere"
+          }
+        ],
+        "scheme": "https://github.com/stac-extensions/osc#theme"
+      }
     ],
     "keywords": [
       "theme:Magnetosphere_Ionosphere",