{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://stac-extensions.github.io/datacube/v2.3.0/schema.json",
  "title": "Datacube Extension",
  "description": "STAC Datacube Extension for STAC Items and STAC Collections.",
  "oneOf": [
    {
      "$comment": "This is the schema for STAC Items.",
      "allOf": [
        {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "const": "Feature"
            }
          }
        },
        {
          "$ref": "#/definitions/stac_extensions"
        }
      ],
      "anyOf": [
        {
          "type": "object",
          "required": [
            "properties"
          ],
          "properties": {
            "properties": {
              "allOf": [
                {
                  "$ref": "#/definitions/require_field"
                },
                {
                  "$ref": "#/definitions/fields"
                }
              ]
            }
          }
        },
        {
          "$comment": "This validates the fields in Item Assets.",
          "required": [
            "assets"
          ],
          "properties": {
            "assets": {
              "type": "object",
              "not": {
                "additionalProperties": {
                  "not": {
                    "allOf": [
                      {
                        "$ref": "#/definitions/require_field"
                      },
                      {
                        "$ref": "#/definitions/fields"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      ]
    },
    {
      "$comment": "This is the schema for STAC Collections.",
      "type": "object",
      "allOf": [
        {
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "const": "Collection"
            }
          }
        },
        {
          "$ref": "#/definitions/stac_extensions"
        }
      ],
      "anyOf": [
        {
          "$comment": "This is the schema for the top-level fields in a Collection.",
          "allOf": [
            {
              "$ref": "#/definitions/require_field"
            },
            {
              "$ref": "#/definitions/fields"
            }
          ]
        },
        {
          "$comment": "This validates the fields in Collection Assets.",
          "required": [
            "assets"
          ],
          "properties": {
            "assets": {
              "type": "object",
              "not": {
                "additionalProperties": {
                  "not": {
                    "allOf": [
                      {
                        "$ref": "#/definitions/require_field"
                      },
                      {
                        "$ref": "#/definitions/fields"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        {
          "$comment": "This is the schema for the fields in Item Asset Definitions.",
          "required": [
            "item_assets"
          ],
          "properties": {
            "item_assets": {
              "type": "object",
              "not": {
                "additionalProperties": {
                  "not": {
                    "allOf": [
                      {
                        "$ref": "#/definitions/require_any_field"
                      },
                      {
                        "$ref": "#/definitions/fields"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        {
          "$comment": "This is the schema for the fields in Summaries. By default, only checks the existance of the properties, but not the schema of the summaries.",
          "required": [
            "summaries"
          ],
          "properties": {
            "summaries": {
              "$ref": "#/definitions/require_any_field"
            }
          }
        }
      ]
    }
  ],
  "definitions": {
    "stac_extensions": {
      "type": "object",
      "required": [
        "stac_extensions"
      ],
      "properties": {
        "stac_extensions": {
          "type": "array",
          "contains": {
            "const": "https://stac-extensions.github.io/datacube/v2.3.0/schema.json"
          }
        }
      }
    },
    "require_any_field": {
      "$comment": "Please list all fields here so that we can force the existance of one of them in other parts of the schemas.",
      "anyOf": [
        {"required": ["cube:dimensions"]},
        {"required": ["cube:variables"]}
      ]
    },
    "require_field": {
      "required": [
        "cube:dimensions"
      ]
    },
    "fields": {
      "$comment": "Add your new fields here. Don't require them here, do that above in the corresponding schema.",
      "type": "object",
      "properties": {
        "cube:dimensions": {
          "$ref": "#/definitions/cube:dimensions"
        },
        "cube:variables": {
          "$ref": "#/definitions/cube:variables"
        }
      },
      "patternProperties": {
        "^(?!cube:)": {}
      },
      "additionalProperties": false
    },
    "cube:dimensions": {
      "type": "object",
      "additionalProperties": {
        "anyOf": [
          {
            "$ref": "#/definitions/vector_dimension"
          },
          {
            "$ref": "#/definitions/horizontal_spatial_dimension"
          },
          {
            "$ref": "#/definitions/vertical_spatial_dimension"
          },
          {
            "$ref": "#/definitions/temporal_dimension"
          },
          {
            "$ref": "#/definitions/additional_dimension"
          }
        ]
      }
    },
    "cube:variables": {
      "type": "object",
      "additionalProperties": {
          "$ref": "#/definitions/variable"
      }
    },
    "additional_dimension": {
      "title": "Additional Dimension Object",
      "type": "object",
      "anyOf": [
        {
          "required": [
            "type",
            "extent"
          ]
        },
        {
          "required": [
            "type",
            "values"
          ]
        }
      ],
      "not": {
        "required": [
          "axis"
        ]
      },
      "properties": {
        "type": {
          "type": "string",
          "not": {
            "enum": [
              "spatial",
              "geometry"
            ]
          }
        },
        "description": {
          "$ref": "#/definitions/description"
        },
        "extent": {
          "$ref": "#/definitions/extent_open"
        },
        "values": {
          "$ref": "#/definitions/values"
        },
        "step": {
          "$ref": "#/definitions/step"
        },
        "unit": {
          "$ref": "#/definitions/unit"
        },
        "reference_system": {
          "type": "string"
        },
        "dimensions": {
          "type": "array",
          "items": {
            "type": [
              "string"
            ]
          }
        }
      }
    },
    "horizontal_spatial_dimension": {
      "title": "Horizontal Spatial Raster Dimension Object",
      "type": "object",
      "required": [
        "type",
        "axis",
        "extent"
      ],
      "properties": {
        "type": {
          "$ref": "#/definitions/type_spatial"
        },
        "axis": {
          "$ref": "#/definitions/axis_xy"
        },
        "description": {
          "$ref": "#/definitions/description"
        },
        "extent": {
          "$ref": "#/definitions/extent_closed"
        },
        "values": {
          "$ref": "#/definitions/values_numeric"
        },
        "step": {
          "$ref": "#/definitions/step"
        },
        "reference_system": {
          "$ref": "#/definitions/reference_system_spatial"
        }
      }
    },
    "vertical_spatial_dimension": {
      "title": "Vertical Spatial Dimension Object",
      "type": "object",
      "anyOf": [
        {
          "required": [
            "type",
            "axis",
            "extent"
          ]
        },
        {
          "required": [
            "type",
            "axis",
            "values"
          ]
        }
      ],
      "properties": {
        "type": {
          "$ref": "#/definitions/type_spatial"
        },
        "axis": {
          "$ref": "#/definitions/axis_z"
        },
        "description": {
          "$ref": "#/definitions/description"
        },
        "extent": {
          "$ref": "#/definitions/extent_open"
        },
        "values": {
          "$ref": "#/definitions/values"
        },
        "step": {
          "$ref": "#/definitions/step"
        },
        "unit": {
          "$ref": "#/definitions/unit"
        },
        "reference_system": {
          "$ref": "#/definitions/reference_system_spatial"
        }
      }
    },
    "vector_dimension": {
      "title": "Spatial Vector Dimension Object",
      "type": "object",
      "required": [
        "type",
        "bbox"
      ],
      "properties": {
        "type": {
          "type": "string",
          "const": "geometry"
        },
        "axes": {
          "type": "array",
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "x",
              "y",
              "z"
            ]
          }
        },
        "description": {
          "$ref": "#/definitions/description"
        },
        "bbox": {
          "title": "Spatial extent",
          "type": "array",
          "oneOf": [
            {
              "minItems":4,
              "maxItems":4
            },
            {
              "minItems":6,
              "maxItems":6
            }
          ],
          "items": {
            "type": "number"
          }
        },
        "values": {
          "type": "array",
          "minItems": 1,
          "items": {
            "description": "WKT or Identifier",
            "type": "string"
          }
        },
        "geometry_types":  {
          "type": "array",
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "Point",
              "MultiPoint",
              "LineString",
              "MultiLineString",
              "Polygon",
              "MultiPolygon",
              "GeometryCollection"
            ]
          }
        },
        "reference_system": {
          "$ref": "#/definitions/reference_system_spatial"
        }
      }
    },
    "temporal_dimension": {
      "title": "Temporal Dimension Object",
      "type": "object",
      "required": [
        "type",
        "extent"
      ],
      "not": {
        "required": [
          "axis"
        ]
      },
      "properties": {
        "type": {
          "type": "string",
          "const": "temporal"
        },
        "description": {
          "$ref": "#/definitions/description"
        },
        "values": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "string"
          }
        },
        "extent": {
          "type": "array",
          "minItems": 2,
          "maxItems": 2,
          "items": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "step": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "variable": {
      "title": "Variable Object",
      "type": "object",
      "required": [
        "dimensions"
      ],
      "properties": {
        "variable_type": {
          "type": "string",
          "enum": [
            "data",
            "auxiliary"
          ]
        },
        "description": {
          "$ref": "#/definitions/description"
        },
        "dimensions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "values": {
          "type": "array",
          "minItems": 1
        },
        "extent": {
          "type": "array",
          "minItems": 2,
          "maxItems": 2,
          "items": {
            "type": [
              "string",
              "number",
              "null"
            ]
          }
        },
        "unit": {
          "$ref": "#/definitions/unit"
        },
        "nodata": {
          "$ref": "#/definitions/nodata"
        },
        "data_type": {
          "$ref": "#/definitions/data_type"
        }
      }
    },
    "type_spatial": {
      "type": "string",
      "const": "spatial"
    },
    "axis_xy": {
      "type": "string",
      "enum": [
        "x",
        "y"
      ]
    },
    "axis_z": {
      "type": "string",
      "const": "z"
    },
    "extent_closed": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": "number"
      }
    },
    "extent_open": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": [
          "number",
          "null"
        ]
      }
    },
    "values_numeric": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "number"
      }
    },
    "values": {
      "type": "array",
      "minItems": 1,
      "items": {
        "oneOf": [
          {
            "type": "number"
          },
          {
            "type": "string"
          }
        ]
      }
    },
    "step": {
      "type": [
        "number",
        "null"
      ]
    },
    "unit": {
      "$comment": "The schema is from common metadata, see https://github.com/radiantearth/stac-spec/blob/v1.1.0/item-spec/json-schema/data-values.json",
      "type": "string"
    },
    "data_type": {
      "$comment": "The schema is from common metadata, see https://github.com/radiantearth/stac-spec/blob/v1.1.0/item-spec/json-schema/data-values.json",
      "type": "string",
      "enum": [
        "int8",
        "int16",
        "int32",
        "int64",
        "uint8",
        "uint16",
        "uint32",
        "uint64",
        "float16",
        "float32",
        "float64",
        "cint16",
        "cint32",
        "cfloat32",
        "cfloat64",
        "other"
      ]
    },
    "nodata": {
      "$comment": "The schema is from common metadata, see https://github.com/radiantearth/stac-spec/blob/v1.1.0/item-spec/json-schema/data-values.json",
      "oneOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "enum": [
            "nan",
            "inf",
            "-inf"
          ]
        }
      ]
    },
    "reference_system_spatial": {
      "oneOf": [
        {
          "description": "WKT2",
          "type": "string"
        },
        {
          "description": "EPSG code",
          "type": "integer",
          "minimum": 0
        },
        {
          "$ref": "https://proj.org/schemas/v0.7/projjson.schema.json"
        }
      ],
      "default": 4326
    },
    "description": {
      "type": "string"
    }
  }
}