DEA data product naming conventions

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

Data product files

 


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)

flow chart

 

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