DEA data product naming conventions | Content Management Interface

NOTE: Naming conventions listed here have evolved. Please see Simon or Susannah, or look at the Naming conventions spreadsheet.

WARNING - the following information may be out of date.

For help with naming your product please see Simon, Susannah or the Naming conventions spreadsheet.

On this page

Data product titles and IDs

Titles

IDs

Naming pick-list

Data product files

Example 1 - DEA Surface Reflectance 3 (Landsat 5 TM)

Example 2 - DEA Surface Reflectance 3 (Landsat 7 ETM+)

Example 3 - DEA Surface Reflectance 3 (Landsat 8 OLI-TIRS)

Data product titles and IDs

From Landsat Collection 3 onwards, DEA data product titles and IDs have followed a specific naming convention.

Titles

DEA products are grouped into catalog / product suites that may comprise of multiple products:

1) Catalog / Product suite

DEA products have two product names:

1) Main title (plain English alias)

2) Full technical name

The titles follow the naming convention below:

Title	Convention	Examples
Product Suite	DEA {product}	DEA Surface Reflectance DEA Fractional Cover DEA High and Low Tide Image
Plain English alias	DEA {product} {collection number} ({platform} {platform sensors})	DEA Surface Reflectance 3 (Landsat 5 TM) DEA Fractional Cover 3 (Landsat) DEA High and Low Tide Imagery 3 (Landsat)
Full technical name	{organisation} {platform} {platform sensors} {product} {collection number}	Geoscience Australia Landsat 5 Thematic Mapper Analysis Ready Data Collection 3 Geoscience Australia Landsat Fractional Cover Collection 3 Geoscience Australia Landsat High Tide and Low Tide Composites Collection 3

IDs

The IDs follow the naming convention below:

Convention	Examples
{organisation}_{platform}{platform sensors}_{product}_{collection number}	ga_ls5t_nbar_3 ga_ls_fc_3 ga_ls_hltc_3

Naming pick-list

Organisation	Platform	Platform sensors	Product	Collection number
ga \| Geoscience Australia usgs \| United States Geological Survey nasa \| National Aeronautics and Space Administration esa \| European Space Agency ec \| European Commission noaa \| National Oceanic and Atmospheric Administration jaxa \| Japan Aerospace Exploration Agency	ls5 \| Landsat 5 ls7 \| Landsat 7 ls8 \| Landsat 8 ls9 \| Landsat 9 ls \| Multiple Landsat s1a \| Sentinel-1A s1b \| Sentinel-1b s1 \| All Sentinel-1 s2a \| Sentinel-2A s2b \| Sentinel-2B s2 \| All Sentinel-2 s3a \| Sentinel-3A s3b \| Sentinel-3B s3 \| All Sentinel-3 ter \| Terra aqu \| Aqua teraqu \| Terra/Aqua hi8 \| Himawari 8	t \| Thematic Mapper (TM) m \| Multispectral Scanner (MSS) e \| Enhanced Thematic Mapper Plus (ETM+) o \| Operational Land Imager (OLI) t \| Thermal Infrared Sensor (TIRS) c \| C-Band Synthetic Aperture Radar (C-SAR) m \| Multispectral Instrument (MSI) a \| Advanced Spaceborne Thermal Emission and Reflection Radiometer (ASTER) m \| Moderate Resolution Imaging Spectroradiometer (MODIS) a \| Advanced Himawari Imager (AHI) c \| Sensors combined (on the one platform)	ard \| Analysis Ready Data dlcd \| Dynamic Land Cover Dataset fc \| Fractional Cover geomed \| Geomedian hl \| High Tide Image lt \| Low Tide Image item \| Intertidal Extents Model level1 \| Level 1 Satellite Data level2 \| Level 2 Satellite Data mangrove \| Mangrove Canopy Cover mcd43a1 \| MODIS mcd43a1 mod43 \| Bidirectional Reflectance Distribution Function Average nawr \| Nadir Adjusted Water-Leaving Reflectance nbar \| Nadir BRDF Adjusted Reflectance nbart \| Nadir BRDF Adjusted Reflectance (Terrain) nidem \| National Intertidal Digital Elevation Model oa \| Observation Attributes prwtr \| Precipital Water rsi \| RADAR backscatter intensity sbt \| Surface Brightness Temperature tcw \| Tasselled Cap Percentiles tmad \| Surface Reflectance Triple Median Absolute Deviation wb \| Waterbodies wo \| Water Observations wofiltstats \| Water Observations Filtered Statistics wostats \| Water Observations Statistics	The first digit of the version number. e.g. 3.0.0

Data product files

The files contained within the DEA data products also follow a specific naming convention on Open Data Cube:

For ARD:

{product}-{minor version}-{patch version}_{spatial reference}_{acquisition date}_{maturity}_{measurement}.{extension}

For Derivatives:

{product}_{spatial reference}_{acquisition date}_{maturity}_{measurement}.{extension}

The fields are defined as follows:

For ARD:

{product} Open Data Cube product ID (as above; e.g. ga_ls5t_nbar_3)

{minor version} A single integer

{patch version} A single integer

{spatial reference} The combination of 'path' and 'row' locations. Both 'path' and 'low' are zero-padded strings of length 3, which make a 6-integer number when combined (e.g. 092 and 084 make 092084)

{acquisition date} Has the form yyyy-mm-dd

{maturity} Represents dataset maturity and can be one of the following:

nrt

If the acquisition file is processed within 48 hours of the acquisition date

interim

If the acquisition date is pre-2002-07-01 AND fallback water vapour data is used (i.e. water vapour is not sourced from the same day as the acquisition date)
OR
If the acquisition date is post-2002-07-01 AND fallback water vapour data is used
OR
If the acquisition date is post-2002-07-01, fallback water vapour data is not used (i.e. water vapour is sourced from the same day as the acquisition date) AND fallback BRDF data is used

final

If the acquisition date is pre-2002-07-01 AND fallback water vapour data is not used
OR
If the acquisition date is post-2002-07-01, fallback water vapour is not used AND fallback BRDF data is not used

See flow process diagram below.

{measurement} e.g. band01, band02, band03, thumbnail, fmask, satellite-view

{extension} e.g. tif, jpg

Flow process for determining maturity (nrt, interim or final)

Example files

Below is a list of representative samples which demonstrate the application of the naming conventions. The folders follow the product ID, path, row, year, month, day format.

Example 1 - Surface Reflectance 3 (Landsat 5 TM)

└── ga_ls5t_ard_3   product ID
   └── 092   path
       └── 084   row
           └── 2009   year
               └── 12   month
                   └── 17   day
                       ├── ga_ls5t_ard_3-0-0_092084_2009-12-17_final.odc-metadata.yaml
                       ├── ga_ls5t_ard_3-0-0_092084_2009-12-17_final.proc-info.yaml
                       ├── ga_ls5t_ard_3-0-0_092084_2009-12-17_final.sha1
                       ├── ga_ls5t_nbar_3-0-0_092084_2009-12-17_final_band01.tif
                       ├── ga_ls5t_nbar_3-0-0_092084_2009-12-17_final_band02.tif
                       ├── ga_ls5t_nbar_3-0-0_092084_2009-12-17_final_band03.tif
                       ├── ga_ls5t_nbar_3-0-0_092084_2009-12-17_final_band04.tif
                       ├── ga_ls5t_nbar_3-0-0_092084_2009-12-17_final_band05.tif
                       ├── ga_ls5t_nbar_3-0-0_092084_2009-12-17_final_band07.tif
                       ├── ga_ls5t_nbar_3-0-0_092084_2009-12-17_final_thumbnail.jpg
                       ├── ga_ls5t_nbart_3-0-0_092084_2009-12-17_final_band01.tif
                       ├── ga_ls5t_nbart_3-0-0_092084_2009-12-17_final_band02.tif
                       ├── ga_ls5t_nbart_3-0-0_092084_2009-12-17_final_band03.tif
                       ├── ga_ls5t_nbart_3-0-0_092084_2009-12-17_final_band04.tif
                       ├── ga_ls5t_nbart_3-0-0_092084_2009-12-17_final_band05.tif
                       ├── ga_ls5t_nbart_3-0-0_092084_2009-12-17_final_band07.tif
                       ├── ga_ls5t_nbart_3-0-0_092084_2009-12-17_final_thumbnail.jpg
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_azimuthal-exiting.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_azimuthal-incident.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_combined-terrain-shadow.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_exiting-angle.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_fmask.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_incident-angle.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_nbar-contiguity.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_nbart-contiguity.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_relative-azimuth.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_relative-slope.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_satellite-azimuth.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_satellite-view.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_solar-azimuth.tif
                       ├── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_solar-zenith.tif
                       └── ga_ls5t_oa_3-0-0_092084_2009-12-17_final_time-delta.tif

Example 2 - Surface Reflectance 3 (Landsat 7 ETM+)

└── ga_ls7e_ard_3             product ID
   └── 092   path
       └── 084                      row
           └── 2016   year
               └── 06   month
   └── 04   day
                       ├── ga_ls7e_ard_3-0-0_092084_2016-06-04_final.odc-metadata.yaml
                       ├── ga_ls7e_ard_3-0-0_092084_2016-06-04_final.proc-info.yaml
                       ├── ga_ls7e_ard_3-0-0_092084_2016-06-04_final.sha1
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_band01.tif
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_band02.tif
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_band03.tif
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_band04.tif
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_band05.tif
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_band07.tif
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_band08.tif
                       ├── ga_ls7e_nbar_3-0-0_092084_2016-06-04_final_thumbnail.jpg
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_band01.tif
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_band02.tif
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_band03.tif
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_band04.tif
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_band05.tif
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_band07.tif
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_band08.tif
                       ├── ga_ls7e_nbart_3-0-0_092084_2016-06-04_final_thumbnail.jpg
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_azimuthal-exiting.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_azimuthal-incident.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_combined-terrain-shadow.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_exiting-angle.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_fmask.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_incident-angle.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_nbar-contiguity.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_nbart-contiguity.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_relative-azimuth.tif
                         ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_relative-slope.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_satellite-azimuth.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_satellite-view.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_solar-azimuth.tif
                       ├── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_solar-zenith.tif
                       └── ga_ls7e_oa_3-0-0_092084_2016-06-04_final_time-delta.tif

Example 3 - Surface Reflectance 3 (Landsat 8 OLI-TIRS)

└── ga_ls8c_ard_3 product ID
     └── 092   path
       └── 084                      row
             └── 2016   year
                 └── 06   month
                     └── 28   day
                         ├── ga_ls8c_ard_3-0-0_092084_2016-06-28_final.odc-metadata.yaml
                         ├── ga_ls8c_ard_3-0-0_092084_2016-06-28_final.proc-info.yaml
                         ├── ga_ls8c_ard_3-0-0_092084_2016-06-28_final.sha1
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band01.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band02.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band03.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band04.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band05.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band06.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band07.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_band08.tif
                         ├── ga_ls8c_nbar_3-0-0_092084_2016-06-28_final_thumbnail.jpg
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band01.tif
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band02.tif
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band03.tif
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band04.tif
├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band05.tif
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band06.tif
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band07.tif
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_band08.tif
                         ├── ga_ls8c_nbart_3-0-0_092084_2016-06-28_final_thumbnail.jpg
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_azimuthal-exiting.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_azimuthal-incident.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_combined-terrain-shadow.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_exiting-angle.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_fmask.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_incident-angle.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_nbar-contiguity.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_nbart-contiguity.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_relative-azimuth.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_relative-slope.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_satellite-azimuth.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_satellite-view.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_solar-azimuth.tif
                         ├── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_solar-zenith.tif
                         └── ga_ls8c_oa_3-0-0_092084_2016-06-28_final_time-delta.tif