STAC ITEM ID AND NAMING CONVENTION – AXIS 3 GOVERNMENTAL HUB¶
STAC Item ID Naming Convention¶
This document defines the structured naming conventions for STAC Item IDs across the AXIS 3 Governmental Hub services. Two distinct ID generation strategies are employed:
- Systematic Products: Generated at predefined intervals (e.g., daily, monthly, yearly), these follow a simple date-based ID format.
- On-Demand / Triggered / Ad-hoc Products: Generated in response to user requests or detected events, these use a timestamp combined with an auto-incrementing counter for uniqueness and traceability.
1. Systematic Products¶
Definition¶
Systematic products are generated at predefined temporal frequencies (e.g., daily, weekly, monthly, yearly) over established Areas of Interest (AOIs) and services.
STAC Item ID Format:¶
<Service_UID>_<YYYYMMDD>
| Component | Description |
|---|---|
Service_UID |
Unique identifier of the service/product (e.g., WS-WQ-MC-AD) |
YYYYMMDD |
Processing or acquisition date in UTC (e.g., 20240724 = 24 July 2024) |
Date Representation Based on Frequency¶
| Frequency | Date Format | Example ID | Notes |
|---|---|---|---|
| Hourly | YYYYMMDDTHHMM |
WS-WQ-MC-AD_20240724T1530 |
UTC date + time with hours & minutes (T separator, ISO 8601 style). |
| Daily | YYYYMMDD |
WS-WQ-MC-AD_20240724 |
Full date in UTC. |
| Weekly | YYYYWww |
WS-WN-IE-BW_2024W30 |
ISO week format (W + week number, e.g., Week 30 of 2024). |
| Bi-weekly | YYYYMMDD (15/30) |
SS-FR-FR-M_20241015 |
Use 15th or 30th as reference date. |
| Monthly | YYYYMM |
FS-FM-FF-A2_202407 |
Year + month. |
| Quarterly | YYYYQn |
LS-UA-UPHI-B_2024Q3 |
Quarter notation (Q1..Q4). |
| Twice a year | YYYYH1, YYYYH2 |
LS-LC-CM-B_2024H2 |
Half-year notation. |
| Yearly | YYYY |
FS-FM-FC-A_2024 |
Year only. |
STAC ITEM [Title] Field Format (Systematic Products Only)¶
<Product Label>_<Frequency-based Year Name>_<Year>
| Component | Description |
|---|---|
Product Label |
A human-readable label representing the service or product type (e.g., Forest Types Maps, Water Quantity Monitoring) |
Frequency-based Year Name |
A custom label that reflects the time period based on the frequency (e.g., Monthly, Weekly, Quarterly, Yearly, etc.) |
Year |
The year of the product generation (e.g., 2024) |
Frequency-based Year Name Determination¶
-
Hourly: Water Quality Monitoring _ July 24 15:30 UTC _ 2024
-
Daily: Water Quantity Monitoring _ Daily _ 2024
-
Weekly: Inland weekly 5m water extent _ Week 30 _ 2024 (ή με μήνα: June Week 1)
-
Bi-weekly: Flood Risk Mapping _ Bi-Weekly 15 _ 2024
-
Monthly: Forest Fuel Mapping _ July _ 2024
-
Quarterly: Agricultural Crop Mapping _ Q2 _ 2024
-
Yearly: Forest Types Maps _ Yearly _ 2024
Systematic Products UID & Name Convention¶
| Service UID | Frequency | Item UID | Title (Product Label _ Frequency-based Year Name _ Year) |
|---|---|---|---|
| Water Services | |||
| WS-WN-IE-AA | Yearly | WS-WN-IE-AA_2024 | Inland annual 10m water extent _ Yearly _ 2024 |
| WS-WN-CE-AA | Yearly | WS-WN-CE-AA_2024 | Coastal annual 10m water extent _ Yearly _ 2024 |
| WS-WN-IE-BW | Weekly | WS-WN-IE-BW_2024W30 | Inland weekly 5m water extent _ Week 30 _ 2024 |
| WS-WN-IE-BM | Monthly | WS-WN-IE-BM_202407 | Inland monthly 5m water extent _ July _ 2024 |
| WS-WN-CE-BM | Monthly | WS-WN-CE-BM_202407 | Coastal monthly 3.3m water extent _ July _ 2024 |
| WS-WQ-MC-AD | Daily | WS-WQ-MC-AD_20240724 | Marine daily 10m chl-a _ Daily _ 2024 |
| WS-WQ-MT-BD | Daily | WS-WQ-MT-BD_20240724 | Marine daily 200m SST _ Daily _ 2024 |
| WS-WQ-IT-AD | Daily | WS-WQ-IT-AD_20240724 | Inland daily 10m oil spills _ Daily _ 2024 |
| WS-WQ-BE-AD | Daily | WS-WQ-BE-AD_20240724 | Inland/Coastal daily muddy waters _ Daily _ 2024 |
| WS-WQ-IF-AD | Daily | WS-WQ-IF-AD_20240724 | Inland daily 10m chl-a/turbidity _ Daily _ 2024 |
| Agricultural Monitoring | |||
| AG-CT-NDVI-S2 | Twice a year | AG-CT-NDVI-S2_2024H1 | NDVI (Sentinel-2) _ H1 _ 2024 |
| Forest Service | |||
| FS-FM-FC-A | Yearly | FS-FM-FC-A_2024 | Forest Types Maps (5m) _ Yearly _ 2024 |
| FS-FM-TC | Yearly | FS-FM-TC_2024 | Tree Cover Density Maps (5m) _ Yearly _ 2024 |
| FS-FM-FF-S1 | Monthly | FS-FM-FF-S1_202407 | SAR mosaicking (10m) _ July _ 2024 |
| FS-FM-FF-S2 | Monthly | FS-FM-FF-S2_202407 | S1&S2 mosaics (10m) _ July _ 2024 |
| FS-FM-FF-A2 | Monthly | FS-FM-FF-A2_202407 | AXIS mosaics (native) _ July _ 2024 |
| FS-FM-FF-A1 | Quarterly | FS-FM-FF-A1_2024Q3 | Hyperspectral mosaics (native) _ Q3 _ 2024 |
| FS-FT-FT-00 | Yearly | FS-FT-FT-00_2024 | Fuel Type Maps (5m) _ Yearly _ 2024 |
| FS-HA-HT-B-A2 | Yearly | FS-HA-HT-B-A2_2024 | Health trends (10m) _ Yearly _ 2024 |
| FS-HA-HT-B-A2 | Bi-Annually | FS-HA-HT-B-A2_2024H1 | Health trends (5m) _ H1 _ 2024 |
| FS-BI-SI | Bi-Annually | FS-BI-SI_2024H1 | Biodiversity Indices _ H1 _ 2024 |
| FS-BI-HS | Bi-Annually | FS-BI-HS_2024H1 | Biodiversity Hot Spots _ H1 _ 2024 |
| FS-BI-BT | Bi-Annually | FS-BI-BT_2024H1 | Biodiversity Trends _ H1 _ 2024 |
| FS-BI-TM | Bi-Annually | FS-BI-TM_2024H1 | Biodiversity in Disturbed Areas _ H1 _ 2024 |
| FS-TM-TM-B-A2 | Yearly | FS-TM-TM-B-A2_2024 | Threat monitoring (10m) _ Yearly _ 2024 |
| FS-TM-TM-B-A2 | Bi-Annually | FS-TM-TM-B-A2_2024H1 | Threat monitoring (5m) _ H1 _ 2024 |
| Land Service | |||
| LS-LC-CM-A | Yearly | LS-LC-CM-A_2024 | Land Cover Classification (10m) _ Yearly _ 2024 |
| LS-LC-CM-B | Twice a year | LS-LC-CM-B_2024H1 | Land Cover Classification (5m) _ H1 _ 2024 |
| LS-LC-CA-A | Yearly | LS-LC-CA-A_2024 | Change Analysis (10m) _ Yearly _ 2024 |
| LS-LC-CA-B | Twice a year | LS-LC-CA-B_2024H1 | Change Analysis (5m) _ H1 _ 2024 |
| LS-UA-LST-BA1 | Quarterly | LS-UA-LST-BA1_2024Q3 | Urban Heat Island (200m) _ Q3 _ 2024 |
| LS-UA-AT-BA1 | Quarterly | LS-UA-AT-BA1_2024Q3 | Air Temperature Map (200m) _ Q3 _ 2024 |
| LS-UA-SUHI-BA1 | Quarterly | LS-UA-SUHI-BA1_2024Q3 | SUHI/UHI Map (200m) _ Q3 _ 2024 |
| LS-UA-UPHI-B | Quarterly | LS-UA-UPHI-B_2024Q3 | Urban Health Index _ Q3 _ 2024 |
| LS-UA-AQ-B | Daily | LS-UA-AQ-B_20240724 | Air Quality Index (100m) _ Daily _ 2024 |
| Safety & Security | |||
| SS-FR-FR-W | Every 5 days (May–Sep) | SS-FR-FR-W_20240705 | Flood risk map (weekly) _ 5-Day (May–Sep) July 05 _ 2024 |
| SS-FR-FR-M | Bi-weekly (Oct–Apr: 15 & 30) | SS-FR-FR-M_20241015 | Flood risk map (bi-weekly) _ Bi-Weekly 15 _ 2024 |
| SS-WS-FDFR | Daily | SS-WS-FDFR_20240724 | Wildfire Danger Forecast _ Daily _ 2024 |
| SS-WS-AF | Every 5/15 min | SS-WS-AF_20240724T1530 | Active Fires _ July 24 15:30 UTC _ 2024 |
2. On-Demand / Triggered / Ad-Hoc Products¶
Definition¶
These products are generated in response to specific events or user requests. Examples include flood delineation, fire severity mapping, triggered surveillance, or on-demand crop analysis.
STAC Item ID Format:¶
<Service_UID>_<YYYYMMDDTHHMMSSmmm>_<NNNNN>
| Component | Description |
|---|---|
Service_UID |
Unique identifier of the service (e.g., SS-WS-BS) |
YYYYMMDDTHHMMSSmmm |
UTC processing timestamp in ISO 8601-like format (e.g., 20240724T1210 = 24 July 2024, 12:10 UTC) with seconds (SS), milliseconds (mmm). |
NNNNNN |
Auto-incrementing 6-digit counter for uniqueness (e.g., 000001, 000002) |
Auto-Incrementing Counter Logic NNNNNN¶
-
The system queries the STAC Catalog for existing items that match the pattern:
-
The number of matching items is counted.
-
The next available 6-digit number is assigned (starting from
000001).
STAC ITEM [Title] Field Format (On-Demand Products Only)¶
<AreaName> - <Processing DateTime> - <Product Label>
| Component | Description |
|---|---|
AreaName |
Derived from a spatial intersection with an administrative shapefile (see 3.) |
Processing DateTime |
UTC timestamp in ISO 8601 format (e.g., 2024-07-24T12:10:00Z) |
Product Label |
Human-readable label (e.g., Flood Delineation, Burn Scar Mapping) |
AreaName AreaName Determination¶
The AreaName is derived by spatially intersecting the product geometry with an official reference administrative shapefile.
- Land areas may use:
- Municipality
- Regional Unit
- Administrative Region
- Marine areas may use:
- Named maritime zones (e.g., “Aegean Sea”, “Ionian Sea”)
High-Level Approach for AreaName Derivation & Title Construction¶
1) Project Centroid (Single Point for Every Product)¶
For every STAC Item we deterministically create one WGS84 point (lon/lat):
properties["proj:centroid"] → (lon, lat)- Else centroid of
geometry - Else center of
bbox
This happens before naming, so all products have a uniform input to the intersection step.
2) Reference Administrative Layer (file - https://planetek-my.sharepoint.com/:u:/r/personal/ieronymaki_planetek_it/Documents/AXIS%203%20HUB%20-%20Services/STAC_Info/Land_Sea_Refernce_Layer/LAND_SEA_MAP.geojson?csf=1&web=1&e=rrqevU ) (CRS: GGRS87 / Greek Grid, EPSG:2100)¶
- The authoritative Land/Sea layer (e.g., GeoJSON, GPKG, Shapefile) is maintained in GGRS87 / Greek Grid (EPSG:2100)
- Can include MultiPolygon geometries
- Key attributes include a human-readable name (e.g.,
NAME, as : “N. Pierias”)
For intersection:
- Reproject the project centroid from WGS84 (EPSG:4326) → EPSG:2100
- Run point-in-polygon on the layer in its native CRS
(Alternatively: reproject the layer to EPSG:4326, but keeping it in 2100 avoids repeated transforms and preserves geometry fidelity.)
3) Point-in-Polygon Identification¶
- Libraries: GeoPandas or Shapely
- Test if centroid lies
withina polygon - Fallback: use
intersectsto handle boundary precision and MultiPolygon edges - Explicit MultiPolygon support is included
4) Attribute Extraction (Name Resolution)¶
-
From the matched feature’s properties, read the first non-empty attribute from a prioritized list:
-
This yields a single, authoritative AreaName
- Examples:
"N. Pierias","Aegean Sea"
5) Title Construction¶
- Extract processing timestamp (priority order):
processing:datetimedatetime-
created -
Construct the STAC
title:- -
> Note*: The authoritative administrative shapefile (covering both land and marine regions) will be formally requested from the Ministry or other competent national authority. It is essential that this shapefile defines the attribute levels required for the naming convention — including municipalities, provinces (regional units), administrative regions for land, and sea or gulf names for marine areas — to ensure consistent and official naming of AOIs in the metadata.
4. Examples¶
Systematic Product¶
| Service UID | Date | STAC Item ID |
|---|---|---|
WS-WQ-MC-AD |
2024-07-24 | WS-WQ-MC-AD_20240724 |
On-Demand Product¶
| Service UID | Timestamp | STAC Item ID | Title |
|---|---|---|---|
SS-WS-BS |
2024-07-24T12:10 UTC | SS-WS-BS_20240724T121008000_000003 |
Peloponnese - 2024-07-24T12:10:00Z - Burn Scar Mapping |
SS-FR-FD-B |
2024-07-18T09:30 UTC | SS-FR-FD-B_20240718T093055111_000001 |
Thessaly - 2024-07-18T09:30:00Z - Flood Delineation |