Output Format
Data organization
The data are organized in a gridded data structure, i.e. data cubes. The tiles manifest as directories in the file system, and the images are stored within.
See also
Check out this tutorial, which explains what a datacube is, how it is parameterized, how you can find a POI, how to visualize the tiling grid, and how to conveniently display cubed data.
Data Cube definition
The spatial data cube definition is appended to each data cube, i.e. to each directory containing tiled datasets, see Data Cube definition.
Naming convention
Following 42 to 46-digit naming convention is applied to all output files:
Example filename: 1984-2020_182-274_HL_TSA_LNDLG_TCG_STM.tif
Table 1: Naming convention
Digits |
Description |
|
---|---|---|
1–9 |
Temporal range for the years as YYYY–YYYY |
|
11-17 |
Temporal range for the DOY as DDD–DDD |
|
19-20 |
Product Level |
|
22-24 |
Submodule |
|
26-30 |
Sensor ID |
|
LNDLG |
Landsat legacy bands |
|
SEN2L |
Sentinel-2 land bands |
|
SEN2H |
Sentinel-2 high-res bands |
|
R-G-B |
Visible bands |
|
VVVHP |
VV/VH Dual Polarized |
|
32–34 |
Index Short Name |
|
BLU |
Blue band |
|
GRN |
Green band |
|
RED |
Red band |
|
NIR |
Near Infrared band |
|
SW1 |
Shortwave Infrared band 1 |
|
SW2 |
Shortwave Infrared band 2 |
|
RE1 |
Red Edge band 1 |
|
RE2 |
Red Edge band 2 |
|
RE3 |
Red Edge band 3 |
|
BNR |
Broad Near Infrared band |
|
NDV |
Normalized Difference Vegetation Index |
|
EVI |
Enhanced Vegetation Index |
|
NBR |
Normalized Burn Ratio |
|
ARV |
Atmospherically Resistant Vegetation Index |
|
SAV |
Soil Adjusted Vegetation Index |
|
SRV |
Soil and Atmospherically Resistant Vegetation Index |
|
TCB |
Tasseled Cap Brightness |
|
TCG |
Tasseled Cap Greenness |
|
TCW |
Tasseled Cap Wetness |
|
TCD |
Tasseled Cap Disturbance Index (without rescaling) |
|
NDB |
Normalized Difference Building Index |
|
NDW |
Normalized Difference Water Index |
|
MNW |
modified Normalized Difference Water Index |
|
NDS |
Normalized Difference Snow Index |
|
SMA |
Spectral Mixture Analysis abundance |
|
BVV |
VV Polarized band |
|
BVH |
VH Polarized band |
|
ND1 |
Normalized Difference Red Edge Index 1 |
|
ND2 |
Normalized Difference Red Edge Index 2 |
|
CRE |
Chlorophyll Index Red Edge |
|
NR1 |
Normalized Difference Vegetation Index red edge 1 |
|
NR2 |
Normalized Difference Vegetation Index red edge 2 |
|
NR3 |
Normalized Difference Vegetation Index red edge 3 |
|
N1N |
Normalized Difference Vegetation Index red edge 1 narrow |
|
N2N |
Normalized Difference Vegetation Index red edge 2 narrow |
|
N3N |
Normalized Difference Vegetation Index red edge 3 narrow |
|
MRE |
Modified Simple Ratio red edge |
|
MRN |
Modified Simple Ratio red edge narrow |
|
CCI |
Chlorophyll Carotenoid Index |
|
36-38 |
Product Type |
|
TSS |
Time Series Stack |
|
TSI |
Time Series Interpolation |
|
RMS |
RMSE Time Series of SMA |
|
STM |
Spectral Temporal Metrics |
|
FBX |
Fold-by-X Time Series (replace X with Table 2) |
|
TRX |
Trend Analysis on Folds (replace X with Table 2) |
|
CAX |
Extended CAT Analysis on Folds (replace X with Table 2) |
|
SPL |
Spline fitted Time Series |
|
36-42 |
Product Type: Phenometrics (replace XXX with Table 3) |
|
XXX-LSP |
Phenometrics |
|
XXX-TRP |
Trend Analysis on Phenometrics |
|
XXX-CAP |
Extended CAT Analysis on Phenometrics |
|
36-42 |
Product Type: Polarmetrics (replace XXX with Table 3) |
|
XXX-POL |
Polarmetrics |
|
XXX-TRO |
Trend Analysis on Polarmetrics |
|
XXX-CAO |
Extended CAT Analysis on Polarmetrics |
|
40-42 / 44-46 |
File extension |
|
tif |
image data in compressed GeoTiff format |
|
dat |
image data in flat binary ENVI format |
|
hdr |
metadata for ENVI format |
|
Folding
Table 2: Folding tags
Letter |
Description |
---|---|
Y |
Fold by Year |
Q |
Fold by Quarter |
M |
Fold by Month |
W |
Fold by Week |
D |
Fold by Day |
Phenology
Table 3: Phenology name tags
Tag |
Description |
Polar |
SPLITS |
---|---|---|---|
DEM |
Date of Early Minimum |
X |
X |
DSS |
Date of Start of Season |
X |
X |
DRI |
Date of Rising Inflection |
X |
|
DPS |
Date of Peak of Season |
X |
X |
DMS |
Date of Mid of Season |
X |
|
DFI |
Date of Falling Inflection |
X |
|
DES |
Date of End of Season |
X |
X |
DLM |
Date of Late Minimum |
X |
X |
DEV |
Date of Early Average Vector |
X |
|
DAV |
Date of Average Vector |
X |
|
DLV |
Date of Late Average Vector |
X |
|
DPY |
Date of Start of Phenological Year |
X |
|
DPV |
delta Date of adaptive Start of Phenological Year |
X |
|
LTS |
Length of Total Season |
X |
X |
LGS |
Length of Green Season |
X |
X |
LGV |
Length of between early/late vectors |
X |
|
VEM |
Value of Early Minimum |
X |
X |
VSS |
Value of Start of Season |
X |
X |
VRI |
Value of Rising Inflection |
X |
|
VPS |
Value of Peak of Season |
X |
X |
VMS |
Value of Mid of Season |
X |
|
VFI |
Value of Falling Inflection |
X |
|
VES |
Value of End of Season |
X |
X |
VLM |
Value of Late Minimum |
X |
X |
VEV |
Value of Early Average Vector |
X |
|
VAV |
Value of Average Vector |
X |
|
VLV |
Value of Late Average Vector |
X |
|
VBL |
Value of Base Level |
X |
X |
VSA |
Value of Seasonal Amplitude |
X |
X |
VGA |
Value of Green Amplitude |
X |
|
VPA |
Value of Peak Amplitude |
X |
|
VGM |
Value of Green Mean |
X |
|
VGV |
Value of Green Variability |
X |
|
IST |
Integral of Total Season |
X |
X |
IBL |
Integral of Base Level |
X |
X |
IBT |
Integral of Base+Total |
X |
X |
IGS |
Integral of Green Season |
X |
X |
IRR |
Integral of Rising Rate |
X |
|
IFR |
Integral of Falling Rate |
X |
|
RAR |
Rate of Average Rising |
X |
X |
RAF |
Rate of Average Falling |
X |
X |
RMR |
Rate of Maximum Rising |
X |
X |
RMF |
Rate of Maximum Falling |
X |
X |
File format
The images are provided with signed 16bit datatype and band sequential (BSQ) interleaving in one of the following formats:
GeoTiff
This is the recommended output option. Images are compressed GeoTiff images using LZW compression with horizontal differencing. The images are generated with internal blocks for partial image access. These blocks are strips that are as wide as the
TILE_SIZE
and as high as theBLOCK_SIZE
.ENVI Standard format
This produces flat binary images without any compression. This option might seem tempting as there is no overhead in cracking the compression when reading these data. However, the transfer of the larger data volume from disc to CPU often takes longer than cracking the compression. Therefore, we recommend to use the GeoTiff option.
Metadata
Metadata are written to all output products.
For ENVI format, the metadata are written to the ENVI header (.hdr
extension).
For GeoTiff format, the metadata are written into the GeoTiff file.
If the metadata is larger than allowed by the GeoTiff driver, the excess metadata will be written to an “auxiliary metadata” file with .aux.xml
extension.
FORCE-specific metadata will be written to the FORCE domain, and thus are probably not visible unless the FORCE domain (or all domains) are specifically printed:
gdalinfo -mdd all 20160823_LEVEL2_SEN2A_BOA.tif
Product type
Time Series Time Series products have as many bands as there are available or requested time steps. If no temporal subset was specified: the TSS product contains one band per available acquisition (this may vary between the tiles), the RMS product contains one band per available acquisition (this may vary between the tiles), the TSI product contains one band per interpolation step, the FBY product contains one band per year (do not overdo YEAR_MIN/MAX, this will give many useless bands), the FBM product contains one band per month (up to 12, depends on MONTH_MIN/MAX and DOY_MIN/MAX), the FBW contains one band per week (up to 52, depends on MONTH_MIN/MAX and DOY_MIN/MAX), the FBD product contains one band per DOY (up to 365, depends on MONTH_MIN/MAX and DOY_MIN/MAX), the 26 LSP products contain one band per year (do not overdo YEAR_MIN/MAX, this will give many useless bands).
Trend Analysis
The Trend Analysis products contains trend parameters:
Band |
Description |
---|---|
1 |
Average |
2 |
Intercept |
3 |
Trend |
4 |
relative change |
5 |
absolute change |
6 |
R-squared |
7 |
Significance (-1, 0, 1) |
8 |
Root Mean Squared Error |
9 |
Mean Absolute Error |
10 |
Maximum Absolute Residual |
11 |
Number of used observations |
12 |
Length of time series |
Change and Trend
The Change, Aftereffect, Trend (CAT) product (following [Hird et al. 2016](https://ieeexplore.ieee.org/document/7094220) contains extended change and trend parameters. CAT detects one change per time series, splits the time series into three parts, and derives trend parameters for the three parts:
Band |
Description |
---|---|
1 |
Magnitude of change |
2 |
Relative change |
3 |
Time of change |
4 to 15 |
Trend parameters for complete time series (see Trend product) |
16 to 27 |
Trend parameters for time series before change (see Trend product) |
28 to 39 |
Trend parameters for time series after change (see Trend product) |