DEA data product naming conventions

NOTE: Naming conventions listed here have evolved. Please see Simon or Susannah.

 

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