Skip to content

Commit 27e5036

Browse files
MatMattMatMatt
committed
feat: add CLMS filenaming guidelines (tree + design principles)
1 parent 80ccf64 commit 27e5036

2 files changed

Lines changed: 554 additions & 0 deletions

File tree

‎DOCS/filenaming/clms-filename-tree_v1.qmd‎

Lines changed: 206 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,206 @@
1+
---
2+
author: European Environment Agency (EEA)
3+
category: guidelines
4+
date: '2026-07-24'
5+
subtitle: Copernicus Land Monitoring Service - Technical Library
6+
title: CLMS Filename Tree
7+
---
8+
9+
# CLMS Filename Tree
10+
11+
*A visual navigation of all possible CLMS filename variants. Each level shows the options for that field. All structural variants are shown, but the lists of variables, tiles, dates & values are exemplary — not exhaustive.*
12+
13+
---
14+
15+
```
16+
CLMS_{CODE}-{VARIABLE}[-{SUBVARIABLE}]_{TEMPORAL}_{RES}_{EXTENT}_{EPSG}_{VERSION}-{RELEASE}.ext
17+
```
18+
19+
## By Product Code
20+
21+
```
22+
CLMS_
23+
├── VLCC- Vegetated Land Cover Characteristics (upgraded HRL)
24+
│ ├── GRA_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
25+
│ ├── DLT_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
26+
│ └── CTY_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
27+
│
28+
├── HRL- High Resolution Layers (legacy, not yet upgraded)
29+
│ ├── TCD_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
30+
│ ├── FTY_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
31+
│ ├── IMD_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
32+
│ ├── IBU_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
33+
│ ├── WAW_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
34+
│ ├── SWF_S{YYYY}_R5m_E{XXX}N{YYY}_3035_V01-R00.tif
35+
│ ├── TCD_C{YYYY}-{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
36+
│ └── IMD_C{YYYY}-{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
37+
│
38+
├── NVLCC- Non-Vegetated Land Cover Characteristics
39+
│ └── IMCCS_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
40+
│
41+
├── SLF- Small Landscape Features
42+
│ └── SFW_S{YYYY}_R5m_E{XXX}N{YYY}_3035_V01-R01.tif
43+
│
44+
├── WSI- Water & Snow/Ice
45+
│ ├── SP-SCD_A{YYYYMMDD}P1Y_R20m_T{ZZ}{GZD}{AA}_V01-R00.tif
46+
│ ├── SWS-WSM_{YYYYMMDD}T{HHMMSS}_R60m_T{ZZ}{GZD}{AA}_S1B_V01-R00.tif
47+
│ └── WDS-SSC_{YYYYMMDD}T{HHMMSS}_R60m_T{ZZ}{GZD}{AA}_S1B_V01-R00.tif
48+
│
49+
├── EUHYDRO- EU Hydro
50+
│ └── NET_S{YYYY}_R10m_EUROPE_3035_V02-R00.gpkg
51+
│
52+
├── UA- Urban Atlas
53+
│ ├── LCU_S{YYYY}_V025ha_{FUA}_3035_V01-R00.gpkg
54+
│ └── LCU_C{YYYY}-{YYYY}_V025ha_{FUA}_3035_V01-R00.gpkg
55+
│
56+
├── CLCPLUS- CLC+ Raster
57+
│ └── LCU_S{YYYY}_R10m_E{XXX}N{YYY}_3035_V01-R00.tif
58+
│
59+
├── VPP2- Vegetation Phenology & Productivity v2
60+
│ ├── ST-PPI_A{YYYYMMDD}P10D_R10m_T{ZZ}{GZD}{AA}_V01-R00.tif
61+
│ ├── VPP-SOSD-S1_A{YYYYMMDD}P1Y_R10m_T{ZZ}{GZD}{AA}_V01-R00.tif
62+
│ ├── GPP-TOTAL_A{YYYYMMDD}P1Y_R10m_T{ZZ}{GZD}{AA}_V01-R00.tif
63+
│ └── GPP-TOTAL-QFLAG_A{YYYYMMDD}P1Y_R10m_T{ZZ}{GZD}{AA}_V01-R00.tif
64+
│
65+
├── CLC- Corine Land Cover
66+
│ └── LCU_S{YYYY}_V25ha_EUROPE_3035_V01-R00.gpkg
67+
│
68+
└── EGMS- European Ground Motion Service
69+
├── L3-U_T{YYYYMMDD}P{duration}_V100m_E{XXX}N{YYY}_3035_V01-R00.csv
70+
├── L3-EW_T{YYYYMMDD}P{duration}_R100m_E{XXX}N{YYY}_3035_V01-R00.tif
71+
├── L2a-A_T{YYYYMMDD}P{duration}_V20-5m_{Orbit}-{BurstID}-{SubSwath}_V01-R00.csv
72+
└── L2b-D_T{YYYYMMDD}P{duration}_V20-5m_{Orbit}-{BurstID}-{SubSwath}_V01-R00.csv
73+
```
74+
75+
## By Temporal Situation
76+
77+
```
78+
{TEMPORAL}_
79+
├── {YYYYMMDD}T{HHMMSS}_ Sensing instant (satellite scene)
80+
│ └── e.g. 20210217T053159_
81+
│
82+
├── A{YYYYMMDD}P{duration}_ Aggregated (sub-annual composite)
83+
│ ├── A20240101P10D_ dekadal
84+
│ ├── A20240101P1M_ monthly
85+
│ └── A20240101P1Y_ annual NRT
86+
│
87+
├── S{YYYY}_ Status (single reference year)
88+
│ └── S2021_
89+
│
90+
├── C{YYYY}-{YYYY}_ Change (change between two Status years)
91+
│ └── C2018-2021_ 3-year change
92+
│
93+
└── T{YYYYMMDD}P{duration}_ Timeseries (multi-year aggregate)
94+
└── T20190101P5Y_ 5-year timeseries
95+
```
96+
97+
## By Resolution
98+
99+
```
100+
{RES}_
101+
├── R{value}[unit]_ Raster (pixel spacing)
102+
│ ├── R1m
103+
│ ├── R5m
104+
│ ├── R10m
105+
│ ├── R20m
106+
│ ├── R60m
107+
│ ├── R100m
108+
│ ├── R300m
109+
│ ├── R1km
110+
│ └── R20-5m irregular grid
111+
│
112+
└── V{value}[unit]_ Vector MMU / point grid
113+
├── V025ha vector MMU 0.25ha
114+
├── V25ha vector MMU 25ha
115+
├── V100m point grid (regular)
116+
└── V20-5m point grid (irregular)
117+
```
118+
119+
## By Spatial Extent
120+
121+
```
122+
{EXTENT}_
123+
├── T{ZZ}{GZD}{AA}_ MGRS (S2 raster tile)
124+
│ └── T33UVS_
125+
│
126+
├── E{XXX}N{YYY}_ LAEA 100km (pan-European grid)
127+
│ └── E27N48_
128+
│
129+
├── {Orbit}-{BurstID}-{SubSwath}_ IW burst (EGMS InSAR swath)
130+
│ └── 054-0154-IW1_
131+
│
132+
├── {NNN}{CC}C{L}_ FUA code (Functional Urban Area)
133+
│ └── DK004L3_
134+
│
135+
├── {CC}_ Country code (nation-level vector)
136+
│ ├── DE_
137+
│ └── IT_
138+
│
139+
├── DU{NNN}_ Delivery Unit (large-area tiling)
140+
│ └── DU001_
141+
│
142+
├── EUROPE_ Continental (entire European continent)
143+
│
144+
├── NORTHERNHEMISPHERE_ Hemispherical (Northern Hemisphere)
145+
│
146+
├── SOUTHERNHEMISPHERE_ Hemispherical (Southern Hemisphere)
147+
│
148+
└── GLOBAL_ Global (full Earth coverage)
149+
```
150+
151+
## By Variable (Sub-product)
152+
153+
*The variable is hyphen-appended to the product code at position 2:* `CLMS_{CODE}-{VARIABLE}[-{SUBVARIABLE}]_…`
154+
155+
```
156+
{CODE}-{VARIABLE}_
157+
├── {PARAM} Single token (VLCC, NVLCC, SLF, HRL)
158+
│ ├── GRA, DLT, CTY (VLCC)
159+
│ ├── IMCCS, SBCC, SFW, CM (NVLCC, SLF)
160+
│ ├── TCD, FTY, IMD, IBU, WAW (HRL — 10m)
161+
│ └── SWF (HRL — 5m)
162+
│
163+
├── {SUB}-{PARAM} Two-level (WSI, VPP2)
164+
│ ├── SP-SCD
165+
│ ├── SWS-WSM, WDS-SSC
166+
│ └── ST-PPI, VPP-SOSD, GPP-TOTAL
167+
│
168+
├── {SUB}-{PARAM}-{SEASON} With season (VPP2)
169+
│ ├── VPP-SOSD-S1
170+
│ └── GPP-SEASONAL-S1
171+
│
172+
├── {SUB}[-{PARAM}]-QFLAG Quality flag (all products)
173+
│ ├── ST-PPI-QFLAG (leaf-level)
174+
│ ├── VPP-SOSD-QFLAG (product-level)
175+
│ └── VPP-QFLAG (family-level)
176+
│
177+
├── LCU Land Cover Land Use status/change (UA, CLC, CLCPLUS, RZ, …)
178+
│
179+
├── L3-U, L3-EW EGMS velocity grid (EGMS L3)
180+
│
181+
├── L2a-A, L2a-D, L2b-A, L2b-D EGMS calibrated (EGMS L2)
182+
│
183+
└── NET, DIR, SUB EU Hydro (EUHYDRO)
184+
```
185+
186+
## Full Example Walkthrough
187+
188+
```
189+
CLMS_
190+
├── WSI-SP-SCD_ Water & Snow/Ice — Snow Cover Duration
191+
│ └── A20240101P1Y_ annual composite
192+
│ └── R20m_ raster 20m
193+
│ └── T38TKL_ MGRS tile
194+
│ └── 3035_ EPSG 3035
195+
│ └── V01-R00.tif version 1, release 0
196+
│
197+
└── EGMS-L2a-A_ European Ground Motion — L2a ascending
198+
└── T20190101P5Y_ 5-year timeseries
199+
└── R20-5m_ irregular grid 20x5m
200+
└── 054-0154-IW1_ IW burst
201+
└── V01-R00.tif version 1, release 0
202+
```
203+
204+
---
205+
206+
*Tree version: draft. Each branch represents a valid structural variant of the CLMS filename convention. See CLMS_Filenaming_Design_Principles.md for the full rules.*

0 commit comments

Comments
 (0)