insula

Insula platform STAC Extension Schema

https://cgi-italy.github.io/insula/schemas/v1.1.1/stac/insula-stac-extension.schema.json

STAC Extension for Insula platform collections.

Abstract	Extensible	Status	Identifiable	Custom Properties	Additional Properties	Access Restrictions	Defined In
Can be instantiated	No	Unknown status	Unknown identifiability	Forbidden	Allowed	none	insula-stac-extension.schema.json

Insula platform STAC Extension Type

merged type (Insula platform STAC Extension)

one (and only one) of

• any of

  • all of

    • Required fields

    • Insula STAC collection fields

Insula platform STAC Extension Examples

{
  "id": "my_raster_collection",
  "type": "Collection",
  "stac_extensions": [
    "https://cgi-italy.github.io/insula/schemas/v1.1.1/stac/insula-stac-extension.schema.json"
  ],
  "insula:metadata": {
    "type": "raster",
    "bands": [
      {
        "id": "B01",
        "name": "NIR Band",
        "color": "#CC0000",
        "domain": {
          "min": 0,
          "max": 4000,
          "noData": -1
        },
        "quantity": {
          "id": "reflectance",
          "name": "Reflectance"
        },
        "default": {
          "colorScale": "turbo",
          "range": {
            "min": 0,
            "max": 3200
          },
          "clamp": true
        }
      }
    ]
  }
}

{
  "id": "my_vector_collection",
  "type": "Collection",
  "stac_extensions": [
    "https://cgi-italy.github.io/insula/schemas/v1.1.1/stac/insula-stac-extension.schema.json"
  ],
  "insula:metadata": {
    "type": "vector",
    "feautreAttributes": [
      {
        "id": "name",
        "name": "Name",
        "type": "string",
        "description": "Entity name",
        "filterable": true,
        "sortable": true
      },
      {
        "id": "total",
        "name": "Total",
        "type": "number",
        "filterable": true,
        "sortable": true
      },
      {
        "id": "class",
        "name": "Class",
        "type": "enum",
        "domain": {
          "values": [
            {
              "value": 1,
              "label": "First Class"
            },
            {
              "value": 2,
              "label": "Second Class"
            }
          ]
        },
        "filterable": true,
        "sortable": true
      },
      {
        "id": "date",
        "name": "Date",
        "type": "date",
        "domain": {
          "min": "1928-12-16T00:00:00Z",
          "max": "1982-03-02T23:59:59Z"
        }
      }
    ],
    "timeDimensionProperty": "date"
  }
}

Insula platform STAC Extension Definitions

Definitions group stac_extensions

Reference this group by using

{"$ref":"https://cgi-italy.github.io/insula/schemas/v1.1.1/stac/insula-stac-extension.schema.json#/$defs/stac_extensions"}

Property	Type	Required	Nullable	Defined by
stac_extensions	array	Required	cannot be null	Insula platform STAC Extension

stac_extensions

stac_extensions

• is required

• Type: array (STAC extensions array)

• cannot be null

• defined in: Insula platform STAC Extension

stac_extensions Type

array (STAC extensions array)

Definitions group fields

Reference this group by using

{"$ref":"https://cgi-italy.github.io/insula/schemas/v1.1.1/stac/insula-stac-extension.schema.json#/$defs/fields"}

Property	Type	Required	Nullable	Defined by
insula:metadata	Merged	Optional	cannot be null	Insula platform STAC Extension
^(?!insula:)	Not specified	Optional	cannot be null	Insula platform STAC Extension

insula:metadata

Platform collection metadata

Regarding raster collections we should probably extend the ‘bands’ array and use the raster extension instead of defining it again

insula:metadata

• is optional

• Type: object (Platform collection)

• cannot be null

• defined in: Insula platform STAC Extension

insula:metadata Type

object (Platform collection)

one (and only one) of

• all of

  • Raster collection tag

  • Raster collection

• all of

  • Vector collection tag

  • Vector collection

Pattern: ^(?!insula:)

Prevent setting additional insula properties

^(?!insula:)

• is optional

• Type: unknown (Namespace sealing)

• cannot be null

• defined in: Insula platform STAC Extension

^(?!insula:) Type

unknown (Namespace sealing)