TimeSeries Document

Enables users to analyze how index values from a datacube change over time at any selected pixel location.

Reference AIKP

ocli.aikp.timeseries.index - README.md

GeoJSON (DB metadata)

{
  "type": "Feature",
  "geometry": {         // AOI Geometry
    "type": "Polygon",
    "coordinates": [
      [
        [5.0, 52.0],
        [6.0, 52.0],
        [6.0, 53.0],
        [5.0, 53.0],
        [5.0, 52.0]
      ]
    ]
  },
  "properties": {
    "type": "TimeSeries",
    "source": {
      "url": "/s3/${PATH/TO/ZARR}.zarr", // Source Path to the ZARR
      "type": "ZARR"
    },
    "zarr": {
      "stats": {
        "max": [], // float value for every time slice
        "min": [], // float value for every time slice
        "std": [], // float value for every time slice
        "mean": [], // float value for every time slice
        "median": [], // float value for every time slice
      },
      "dimensions": [ "time", "lat", "lon" ], // ZARR dimensions
      "domain_min": -1, // Global minimum
      "domain_max": 1,  // Global maximum
      "time_slices": [
        "2025-06-28T10:46:19.024000000",
        "2025-07-03T10:50:51.025000000",
        // ... Labels for each time slice/layer
      ],
      "variable_name": "NDVI", // Varuable Name 
      "variable_unit": ""  // Unit (could be empty).
    },
    "temporal_extent": {
      "start": 1751107579, // First time point (unit time)
      "count": 7,          // Total points in time
      "end": 1752835579    // Lasttime point (unit time)
    }
    // ... see [Common properties](../common.md) for shared fields like legend, metadata, and classification.
  }
  // ... see [Common properties](../common.md) 
}

Discrete color map

To publish qualitative data please assign to each category integer number and publish it in zarr layers. Then add into properties.zatt.color_map section with "type": "discrete". Please see the example below, in such way you can assign category label and color to the number values. Then this color maps affect how the zarr layers will be rendered by tiler, Y labels in charts and layer`s legend.

{
  "properties": {
  // ...
    "zarr": {
    // ... 
      "color_map": {
        "type": "discrete",
        "categories": [
          {
            "color": "#0000F2",
            "label": "Water",
            "value": 1
          },
          {
            "color": "#008000",
            "label": "Dense Forest",
            "value": 2
          },
          {
            "color": "#90EE90",
            "label": "Grassland / Shrub",
            "value": 3
          },
          {
            "color": "#FFFF00",
            "label": "Cropland",
            "value": 4
          },
          {
            "color": "#FF0000",
            "label": "Urban / Built-up",
            "value": 5
          }
        ]
      },
    }
  }
}