# Vector TimeSeries Document

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

## Reference AIKP

`ocli.aikp.document.vector_ts`

## GeoJSON (DB metadata)

```jsonc
{
  "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": "VectorTimeSeries",
    "source": {
      "url": "/s3/${PATH/TO/GeoJSON}.zarr", // Source Path to the ZARR
      "type": "GeoJSON"
    },
    "ts_schema": {
      "stats": {
        "max": [], // float value for every time slice
        "min": [], // float value for every time slice
        "mean": [], // float value for every time slice
        "median": [], // float value for every time slice
        "std": [], // float value for every time slice
      },
      "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", // Variable Name 
      "variable_unit": ""  // Unit (could be empty).
    },
    "temporal_extent": {
      "start": 1751107579, // First time point (unit time)
      "count": 7,          // Total points in time
      "end": 1752835579    // Last time point (unit time)
    }
    // ... see [Common properties](../common.md) for shared fields like legend, metadata, and classification.
  }
  // ... see [Common properties](../common.md) 
}
```

## Source Document Format (Input GeoJSON)

The input GeoJSON file supplied via `task set file_path` must be a `FeatureCollection` structured as follows:

```jsonc
{
  "type": "FeatureCollection",
  "properties": {
    "time": [
      1591401600,
      1591920000,
      // ... unix timestamps
    ],
    "labels": [
      "20200606",
      "20200612",
      // ... time point labels matching the timestamps length
    ]
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "pid": "33sMd08sFW",
        "values": [
          -2.1,
          0.1,
          // ... time series values for this point (must match 'time' length)
        ]
        // ... other point properties (e.g. latitude, longitude, mean_velocity)
      },
      "geometry": {
        "type": "Point",
        "coordinates": [26.959554, 67.70663399895567]
      }
    }
    // ... Points 
  ]
}
```