diff --git a/docs/_files/land_cover/1.degradation-urban_false_positives-level3.gif b/docs/_files/land_cover/1.degradation-urban_false_positives-level3.gif new file mode 100644 index 000000000..31c59fa99 Binary files /dev/null and b/docs/_files/land_cover/1.degradation-urban_false_positives-level3.gif differ diff --git a/docs/_files/land_cover/10.improvement-woody_cover_pine_plantation-zoomed-in-level4.gif b/docs/_files/land_cover/10.improvement-woody_cover_pine_plantation-zoomed-in-level4.gif new file mode 100644 index 000000000..66af378d0 Binary files /dev/null and b/docs/_files/land_cover/10.improvement-woody_cover_pine_plantation-zoomed-in-level4.gif differ diff --git a/docs/_files/land_cover/11b.example_cultivated_degradation_level4._2015gif.gif b/docs/_files/land_cover/11b.example_cultivated_degradation_level4._2015gif.gif new file mode 100644 index 000000000..ebf147e7e Binary files /dev/null and b/docs/_files/land_cover/11b.example_cultivated_degradation_level4._2015gif.gif differ diff --git a/docs/_files/land_cover/12b.improvement_cultivated_level3_2015.gif b/docs/_files/land_cover/12b.improvement_cultivated_level3_2015.gif new file mode 100644 index 000000000..b4575ba4d Binary files /dev/null and b/docs/_files/land_cover/12b.improvement_cultivated_level3_2015.gif differ diff --git a/docs/_files/land_cover/2.degr_ocean_water_persistance-degr_stripes-impr_urban.gif b/docs/_files/land_cover/2.degr_ocean_water_persistance-degr_stripes-impr_urban.gif new file mode 100644 index 000000000..611c92f29 Binary files /dev/null and b/docs/_files/land_cover/2.degr_ocean_water_persistance-degr_stripes-impr_urban.gif differ diff --git a/docs/_files/land_cover/9.degradation-missing_pixels_waterbodies-level_3.gif b/docs/_files/land_cover/9.degradation-missing_pixels_waterbodies-level_3.gif new file mode 100644 index 000000000..28347567d Binary files /dev/null and b/docs/_files/land_cover/9.degradation-missing_pixels_waterbodies-level_3.gif differ diff --git a/docs/_files/cmi/DEA-datasets-used.PNG b/docs/_files/land_cover/DEA-datasets-used.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/DEA-datasets-used.PNG rename to docs/_files/land_cover/DEA-datasets-used.PNG diff --git a/docs/_files/cmi/DEACoastLines_DEAMaps_1.gif b/docs/_files/land_cover/DEACoastLines_DEAMaps_1.gif old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/DEACoastLines_DEAMaps_1.gif rename to docs/_files/land_cover/DEACoastLines_DEAMaps_1.gif diff --git a/docs/_files/cmi/DEACoastLines_DEAMaps_2.gif b/docs/_files/land_cover/DEACoastLines_DEAMaps_2.gif old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/DEACoastLines_DEAMaps_2.gif rename to docs/_files/land_cover/DEACoastLines_DEAMaps_2.gif diff --git a/docs/_files/land_cover/Perth_urban_timeseries_lc_lvl3_gmad.gif b/docs/_files/land_cover/Perth_urban_timeseries_lc_lvl3_gmad.gif new file mode 100644 index 000000000..171d11171 Binary files /dev/null and b/docs/_files/land_cover/Perth_urban_timeseries_lc_lvl3_gmad.gif differ diff --git a/docs/_files/land_cover/c3_l3-10.png b/docs/_files/land_cover/c3_l3-10.png new file mode 100644 index 000000000..46768e7f9 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-10.png differ diff --git a/docs/_files/land_cover/c3_l3-11.png b/docs/_files/land_cover/c3_l3-11.png new file mode 100644 index 000000000..a52b5faa2 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-11.png differ diff --git a/docs/_files/land_cover/c3_l3-12.png b/docs/_files/land_cover/c3_l3-12.png new file mode 100644 index 000000000..18a2182c9 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-12.png differ diff --git a/docs/_files/land_cover/c3_l3-13.png b/docs/_files/land_cover/c3_l3-13.png new file mode 100644 index 000000000..5fdb8bf1e Binary files /dev/null and b/docs/_files/land_cover/c3_l3-13.png differ diff --git a/docs/_files/land_cover/c3_l3-14.png b/docs/_files/land_cover/c3_l3-14.png new file mode 100644 index 000000000..f4e5abc22 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-14.png differ diff --git a/docs/_files/land_cover/c3_l3-15.png b/docs/_files/land_cover/c3_l3-15.png new file mode 100644 index 000000000..80f90eb0f Binary files /dev/null and b/docs/_files/land_cover/c3_l3-15.png differ diff --git a/docs/_files/land_cover/c3_l3-16.png b/docs/_files/land_cover/c3_l3-16.png new file mode 100644 index 000000000..8dc216214 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-16.png differ diff --git a/docs/_files/land_cover/c3_l3-17.png b/docs/_files/land_cover/c3_l3-17.png new file mode 100644 index 000000000..069c0a9d0 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-17.png differ diff --git a/docs/_files/land_cover/c3_l3-18.png b/docs/_files/land_cover/c3_l3-18.png new file mode 100644 index 000000000..28f7294d4 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-18.png differ diff --git a/docs/_files/land_cover/c3_l3-19.png b/docs/_files/land_cover/c3_l3-19.png new file mode 100644 index 000000000..7f202d1b7 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-19.png differ diff --git a/docs/_files/land_cover/c3_l3-20.png b/docs/_files/land_cover/c3_l3-20.png new file mode 100644 index 000000000..3988c969c Binary files /dev/null and b/docs/_files/land_cover/c3_l3-20.png differ diff --git a/docs/_files/land_cover/c3_l3-9.png b/docs/_files/land_cover/c3_l3-9.png new file mode 100644 index 000000000..80a5b29f4 Binary files /dev/null and b/docs/_files/land_cover/c3_l3-9.png differ diff --git a/docs/_files/cmi/cut_back_0.PNG b/docs/_files/land_cover/cut_back_0.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/cut_back_0.PNG rename to docs/_files/land_cover/cut_back_0.PNG diff --git a/docs/_files/cmi/eo-limitations-table.PNG b/docs/_files/land_cover/eo-limitations-table.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/eo-limitations-table.PNG rename to docs/_files/land_cover/eo-limitations-table.PNG diff --git a/docs/_files/land_cover/ga_ls_landcover_class_cyear_3_style.qml b/docs/_files/land_cover/ga_ls_landcover_class_cyear_3_style.qml new file mode 100644 index 000000000..8483e284f --- /dev/null +++ b/docs/_files/land_cover/ga_ls_landcover_class_cyear_3_style.qml @@ -0,0 +1,154 @@ + + + + 1 + 1 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + None + WholeRaster + Estimated + 0.02 + 0.98 + 2 + + + + + + + + + + + + + + + + + resamplingFilter + + 0 + diff --git a/docs/_files/cmi/inter-assessor-agreement.PNG b/docs/_files/land_cover/inter-assessor-agreement.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/inter-assessor-agreement.PNG rename to docs/_files/land_cover/inter-assessor-agreement.PNG diff --git a/docs/_files/land_cover/lake_amadeus_timeseries_lc_lvl4_gmad.gif b/docs/_files/land_cover/lake_amadeus_timeseries_lc_lvl4_gmad.gif new file mode 100644 index 000000000..ada897752 Binary files /dev/null and b/docs/_files/land_cover/lake_amadeus_timeseries_lc_lvl4_gmad.gif differ diff --git a/docs/_files/land_cover/legend_LC_level4.png b/docs/_files/land_cover/legend_LC_level4.png new file mode 100644 index 000000000..9eb385f84 Binary files /dev/null and b/docs/_files/land_cover/legend_LC_level4.png differ diff --git a/docs/_files/land_cover/legend_lc_level3.png b/docs/_files/land_cover/legend_lc_level3.png new file mode 100644 index 000000000..ac28cacd5 Binary files /dev/null and b/docs/_files/land_cover/legend_lc_level3.png differ diff --git a/docs/_files/land_cover/legend_lc_level3_horizontal.png b/docs/_files/land_cover/legend_lc_level3_horizontal.png new file mode 100644 index 000000000..775decdd2 Binary files /dev/null and b/docs/_files/land_cover/legend_lc_level3_horizontal.png differ diff --git a/docs/_files/land_cover/legend_lc_level4_horizontal.png b/docs/_files/land_cover/legend_lc_level4_horizontal.png new file mode 100644 index 000000000..3b55d16f9 Binary files /dev/null and b/docs/_files/land_cover/legend_lc_level4_horizontal.png differ diff --git a/docs/_files/cmi/level3-dataflow.PNG b/docs/_files/land_cover/level3-dataflow.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/level3-dataflow.PNG rename to docs/_files/land_cover/level3-dataflow.PNG diff --git a/docs/_files/cmi/level4-dataflow.PNG b/docs/_files/land_cover/level4-dataflow.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/level4-dataflow.PNG rename to docs/_files/land_cover/level4-dataflow.PNG diff --git a/docs/_files/land_cover/mt_beggary_bushfire_timeseries_lc_lvl4_gmad.gif b/docs/_files/land_cover/mt_beggary_bushfire_timeseries_lc_lvl4_gmad.gif new file mode 100644 index 000000000..cc9e21391 Binary files /dev/null and b/docs/_files/land_cover/mt_beggary_bushfire_timeseries_lc_lvl4_gmad.gif differ diff --git a/docs/_files/cmi/overall-accuracy_0.PNG b/docs/_files/land_cover/overall-accuracy_0.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/overall-accuracy_0.PNG rename to docs/_files/land_cover/overall-accuracy_0.PNG diff --git a/docs/_files/cmi/per-class-accuracy.PNG b/docs/_files/land_cover/per-class-accuracy.PNG old mode 100755 new mode 100644 similarity index 100% rename from docs/_files/cmi/per-class-accuracy.PNG rename to docs/_files/land_cover/per-class-accuracy.PNG diff --git a/docs/_files/land_cover/shallow_inlet_timeseries_lc_lvl3_gmad.gif b/docs/_files/land_cover/shallow_inlet_timeseries_lc_lvl3_gmad.gif new file mode 100644 index 000000000..4757937ce Binary files /dev/null and b/docs/_files/land_cover/shallow_inlet_timeseries_lc_lvl3_gmad.gif differ diff --git a/docs/_files/logos/dea-logo-inline.png b/docs/_files/logos/dea-logo-inline.png index 6402bc321..eb9a757fb 100644 Binary files a/docs/_files/logos/dea-logo-inline.png and b/docs/_files/logos/dea-logo-inline.png differ diff --git a/docs/_templates/product-v2.rst b/docs/_templates/product-v2.rst index c5844c03b..7278bca24 100644 --- a/docs/_templates/product-v2.rst +++ b/docs/_templates/product-v2.rst @@ -10,7 +10,7 @@ {% set max_page_title_length = 200 %} {% set no_data_terms = { - "dash": "\-", + "dash": "\-" } %} {% set access_labels = { @@ -63,11 +63,15 @@ {# Macros #} {% macro format_version_number(version_number) -%} {# If the version number starts with a number, add a 'v' to it e.g. "v1.0.0". #} +{%- if version_number -%} {%- if (version_number|string)[0].isdigit() -%} {{ "v" ~ version_number }} {%- else -%} {{ version_number }} {%- endif -%} +{%- else -%} +{{ no_data_terms.dash }} +{%- endif -%} {%- endmacro %} {# Computed values #} diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_access.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_access.md new file mode 100644 index 000000000..69f68ba73 --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_access.md @@ -0,0 +1,121 @@ +% ## Access constraints + +## Use constraints + +DEA Land Cover is appropriate to use at the national scale where other more detailed information on land cover is not available. Where DEA land cover shows conflicting information to state or local datasets, those datasets should be considered authoritative. + +:::{dropdown} How to view the data in a web map + +To view and access the data interactively: +1) Visit [DEA Maps](https://maps.dea.ga.gov.au). + +2) Click `Explore map data`. + +3) Select `Land and vegetation` > `DEA Land Cover` > `DEA Land Cover (Landsat)`. + +5) Click `Add to the map`, or the `+` symbol to add the data to the map. +::: + +:::{dropdown} How to load data with Python in the DEA Sandbox + +DEA Sandbox allows you to explore DEA’s Earth Observation datasets in a JupyterLab environment. To sign up for DEA Sandbox see the [user guide](/guides/setup/Sandbox/sandbox/) + +Once you have access, click into the `DEA products` directory to find the `Introduction to DEA Land Cover` notebook on the Sandbox. This notebook will walk you through loading and visualising the DEA Land Cover data. +::: + +:::{dropdown} Downloading the DEA Landcover data + +DEA Land Cover data can be downloaded from DEA’s public data holdings through a web browser, or using Amazon Web Service’s Command Line Interface (AWS CLI). + +***via web browser:*** + +From [here](https://data.dea.ga.gov.au/?prefix=derivative/ga_ls_landcover_class_cyear_2/1-0-0/), simply navigate to the year and tile* of interest and directly download the GeoTIFF file for the layer you’re after. + +**To find x and y tile values for an area, see the Explorer [here](https://explorer.dea.ga.gov.au/products/ga_ls_landcover_class_cyear_2).** + +***Bulk download using AWS CLI (for technical users):*** + +First you need to install AWS CLI, instructions [here](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) + +Then you can download data from the command line with a command such as: +``` +aws s3 --no-sign-request sync s3://dea-public-data/derivative/ga_ls_landcover_class_cyear_2/1-0-0/2020 C:/landcover/ --exclude "*" --include "*_level4.tif" +``` + +(This downloads all level4 tiles for 2020 into a folder called ‘landcover’) + +**Basis of the command:** +``` +aws s3 --no-sign-request sync [1][2][3][4] +``` +Where: + +[1] The s3 bucket and folder to download data from: e.g., +``` +s3://dea-public-data/derivative/ga_ls_landcover_class_cyear_2/1-0-0/2020 +``` +[2] The directory to download to: e.g., +``` +C:/landcover/ +``` +[3] When you want to specify specific files to download, first you need to exclude everything +``` +--exclude "*" +``` +[4] Then you can define what you want to include (you can add this multiple times), e.g., +``` +--include "*_level4.tif" --include "*_level4_rgb.tif" +``` +::: + +:::{dropdown} Adding DEA Landcover to QGIS + +*(for the time dimension to work you need version 3.22+)* + +From the drop down menus at the top select `Layer` > `Add Layer` > `Add WMS/WMTS Layer` + +Click 'New' to setup a new data source, then enter +``` + Name: DEA Services + + URL: [https://ows.dea.ga.gov.au/](https://ows.dea.ga.gov.au/) +``` +Click `Connect` + +Once the items appear you can choose which layers to add. + +Select `Land and Vegetation` > `DEA Land Cover`, then either: + +* `DEA Land Cover Calendar Year (Landsat)`, then the **basic** or **detailed** +* `DEA Land Cover Environmental Descriptors`, then any of the various descriptor layers (lifeform, water seasonality etc) + +Once you have selected a layer, click `Add` at the bottom of the window to add it to your project. + +Temporal information can be accessed by clicking the clock icon next to the name of the layer in the layers list. + +::: + +:::{dropdown} Adding DEA Landcover to ArcMap + +First add Digital Earth Australia to the GIS Servers: + +1. Select `Windows` > `Catalog` > `GIS Servers` > `Add WMTS Server` + +2. Enter [https://ows.dea.ga.gov.au/](https://ows.dea.ga.gov.au/) into the URL field + +3. Click `OK` + +Now add the layer to your map: + +1. From the drop down menus at the top select `File` > `Add Data` > `Add Data...` + +2. Click the `Look in` selector, and choose `GIS Servers` + +3. Double click `Digital Earth Australia – OGC Web Services...` + +4. Select `DEA Land Cover Calendar Year (Landsat)` or `DEA Land Cover Environmental Descriptors` + +5. Click `Add` + +::: + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_credits.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_credits.md new file mode 100644 index 000000000..4ce14de91 --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_credits.md @@ -0,0 +1,15 @@ +## Acknowledgments + +DEA acknowledges the contribution of several collaborators who helped to create this Land Cover product: +* CSIRO - Anna Richards, Becky Schmidt, Kristen Williams +* UNSW - Graciela Metternicht +* Department of Agriculture, Water and Environment - Jane Stewart, Lucy Randall, Lucy Gramenz +* ANU - Albert van Dijk +* Tasmania DPIPWE - Lindsay Mitchell + +## License and copyright + +© Commonwealth of Australia (Geoscience Australia). + +Released under [Creative Commons Attribution 4.0 International Licence](https://creativecommons.org/licenses/by/4.0/). + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_data.yaml b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_data.yaml new file mode 100644 index 000000000..dcf1694d8 --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_data.yaml @@ -0,0 +1,81 @@ +# See the Product metadata fields documentation: +# https://docs.dev.dea.ga.gov.au/public_services/dea_knowledge_hub/product_metadata_fields.html + +# Overview + +title: DEA Land Cover (Landsat) +long_title: "Geoscience Australia Landsat Land Cover 25m " +header_image: /_files/cmi/DEA_Land_Cover_1_0_0_Lvl4_2015.jpg +version: 1.0.0 +is_latest_version: true +latest_version_link: null +is_provisional: false +product_type: Derivative +spatial_data_type: Raster +time_span: + start: 1988 + end: 2020 +update_frequency: Yearly +next_update: No updates planned +product_ids: + - ga_ls_landcover_class_cyear_2 + +parent_products: + name: null + link: null +collection: + name: Geoscience Australia Landsat Collection 2 + link: null +doi: 10.26186/146090 +ecat: "146090" +nci: null +licence: + name: Creative Commons Attribution 4.0 International Licence + link: https://creativecommons.org/licenses/by/4.0/ + +citations: + data_citation: "Tissott, B., Mueller, N., 2022. DEA Land Cover 25m. Geoscience Australia, Canberra. https://dx.doi.org/10.26186/146090" + paper_citation: "Lucas, R., Mueller, N., Siggins, A., Owers, C., Clewley, D., Bunting, P., Kooymans, C., Tissott, B., Lewis, B., Lymburner, L., Metternicht, G., 2019. Land Cover Mapping using Digital Earth Australia. Data. 4(4):143. https://doi.org/10.3390/data4040143" +custom_citations: null + +tags: + - land_cover_and_land_use + +# Access + +maps: + - link: https://maps.dea.ga.gov.au/story/DEALandCover + name: See it on a map + +explorers: + - link: https://explorer.dea.ga.gov.au/products/ga_ls_landcover_class_cyear_2 + name: Data explorer + +data: + - link: http://dea-public-data.s3-website-ap-southeast-2.amazonaws.com/?prefix=derivative/ga_ls_landcover_class_cyear_2/ + name: Access the data on AWS + +code_examples: + - link: /notebooks/DEA_products/DEA_Land_Cover/ + name: Code examples + +web_services: + - link: https://ows.dea.ga.gov.au/ + name: Web Services + +custom: null + +# History + +old_versions: null + +# Settings + +enable_overview: true +enable_access: true +enable_details: true +enable_quality: true +enable_history: true +enable_faqs: false +enable_credits: true + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_details.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_details.md new file mode 100644 index 000000000..f50d77f02 --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_details.md @@ -0,0 +1,408 @@ +## Background + +Land cover is the observed physical cover on the Earth's surface including trees, shrubs, grasses, soils, exposed rocks, water bodies, plantations, crops and built structures. A consistent, Australia-wide land cover product helps understanding of how the different parts of the environment change and inter-relate. Earth observation data recorded over a period of time firstly allows the observation of the state of land cover at a specific time and secondly the way that land cover changes by comparison between times. + +## What this product offers + +DEA Land Cover provides annual land cover classifications for Australia using the Food and Agriculture Organisation Land Cover Classification System taxonomy Version 2 (Di Gregorio and Jansen, 1998; 2005). + +DEA Land Cover divides the landscape into six base land cover types, which are then further detailed through the addition of environmental descriptors. The structure is as follows: +* Cultivated Terrestrial Vegetation + * percentage of cover + * life form (herbaceous only) +* Natural Terrestrial Vegetation + * percentage of cover + * life form (woody or herbaceous) +* Natural Aquatic Vegetation + * percentage of cover + * life form (woody or herbaceous) + * water seasonality +* Artificial Surfaces +* Natural Bare + * percentage of bare cover +* Aquatic + * water persistence + * intertidal area + +% ## Data description + +## Applications + +Annual Land Cover information can be used in a number of ways to support the monitoring and management of environments in Australia. These include, but are not limited to, the following areas in environmental monitoring, primary industries and the interests and safety of the Australian community: +* Environmental monitoring + * Ecosystem mapping + * Carbon dynamics + * Erosion management +* Agriculture Sector + * Monitoring crop responses to water availability + * Understanding drought impact on vegetation +* Community interests + * Map urban expansion within Australia + * Mapping impacts of natural disasters + * Bushfire recovery + +## Technical information + +DEA Land Cover is based on the globally applicable Food and Agriculture Organisation's (FAO) Land Cover Classification System (LCCS) taxonomy Version 2 (Di Gregorio and Jansen, 1998; 2005). DEA Land Cover classifications have been generated by combining quantitative (continuous) or qualitative (thematic) environmental information (referred to as Essential Descriptors; EDs) derived from Landsat satellite sensor data. Several EDs have been generated previously by Geoscience Australia, including [annual water summaries](/data/product/dea-water-observations-statistics-landsat/) (Mueller et al., 2016), [vegetation fractional cover](/data/category/dea-fractional-cover/) (Scarth et al., 2010), [mangrove extent](/data/product/dea-mangrove-canopy-cover-landsat/) (Lymburner et al., 2020) and the [Inter Tidal Extent Model](/data/product/dea-intertidal-extents-landsat/) (ITEM; Sagar et al., 2017), whilst others have been developed more recently. These EDs have been combined to generate detailed, consistent and expandable annual classifications of Australia’s land cover from 1986 through to 2020. + +DEA Land Cover consists of eight datasets: The base (level 3) classification, seven additional descriptor layers, and the final (level 4) classification combining the base classes with their associated descriptors. + +Detailed layer descriptions, including known issues, are provided in the following sections. + +### Datasets, values and definitions + +:::{dropdown} Level 3 +The base Level 3 land cover classification + + 0: No data + + 111: Cultivated Terrestrial Vegetation (CTV) + + 112: (Semi-)Natural Terrestrial Vegetation (NTV) + + 124: Natural Aquatic Vegetation (NAV) + + 215: Artificial Surface (AS) + + 216: Natural Bare Surface (NS) + + 220: Water + +**Lifeform** + +Describes the detail of vegetated classes, separating woody from herbaceous + + 0: Not applicable (such as in water areas) + + 1: Woody (trees, shrubs) + + 2: Herbaceous (grasses, forbs) + +**Vegetation Cover** + +The measured cover of vegetated areas + + 0: Not applicable (such as in bare areas) + + 10: Closed (>65 %) + + 12: Open (40 to 65 %) + + 13: Open (15 to 40 %) + + 15: Sparse (4 to 15 %) + + 16: Scattered (1 to 4 %) + +**Water Seasonality** + +The length of time an aquatic vegetated area was measured as being inundated + + 0: Not applicable (not an aquatic environment) + + 1: Semi-permanent or permanent (> 3 months) + + 2: Temporary or seasonal (< 3 months) + +**Water State** + +Describes whether the detected water is snow, ice or liquid water. Only liquid water is described in this release + + 0: Not applicable (not water) + + 1: Water + +**Intertidal** + +Delineates the intertidal zone + + 0: Not applicable (not intertidal) + + 3: Intertidal zone + +**Water Persistence** + +Describes the number of months a water body contains water + + 0: Not applicable (not an aquatic environment) + + 1: > 9 months + + 7: 7-9 months + + 8: 4-6 months + + 9: 1-3 months + +**Bare Gradation** + +Describes the percentage of bare in naturally bare areas + + 0: Not applicable (not a naturally bare area) + + 10: Sparsely vegetated (< 20 % bare) + + 12: Very sparsely vegetated (20 to 60 % bare) + + 15: Bare areas, unvegetated (> 60 % bare) +::: + +:::{dropdown} Level 4 +All level 3 and level 4 classes for a given pixel are combined to give a single classification value + + 0: No data + + 1: Cultivated Terrestrial Vegetated + + 3: Cultivated Terrestrial Vegetated: Herbaceous + + 4: Cultivated Terrestrial Vegetated: Closed (> 65 %) + + 5: Cultivated Terrestrial Vegetated: Open (40 to 65 %) + + 6: Cultivated Terrestrial Vegetated: Open (15 to 40 %) + + 7: Cultivated Terrestrial Vegetated: Sparse (4 to 15 %) + + 8: Cultivated Terrestrial Vegetated: Scattered (1 to 4 %) + + 14: Cultivated Terrestrial Vegetated: Herbaceous Closed (> 65 %) + + 15: Cultivated Terrestrial Vegetated: Herbaceous Open (40 to 65 %) + + 16: Cultivated Terrestrial Vegetated: Herbaceous Open (15 to 40 %) + + 17: Cultivated Terrestrial Vegetated: Herbaceous Sparse (4 to 15 %) + + 18: Cultivated Terrestrial Vegetated: Herbaceous Scattered (1 to 4 %) + + 19: Natural Terrestrial Vegetated + + 20: Natural Terrestrial Vegetated: Woody + + 21: Natural Terrestrial Vegetated: Herbaceous + + 22: Natural Terrestrial Vegetated: Closed (> 65 %) + + 23: Natural Terrestrial Vegetated: Open (40 to 65 %) + + 24: Natural Terrestrial Vegetated: Open (15 to 40 %) + + 25: Natural Terrestrial Vegetated: Sparse (4 to 15 %) + + 26: Natural Terrestrial Vegetated: Scattered (1 to 4 %) + + 27: Natural Terrestrial Vegetated: Woody Closed (> 65 %) + + 28: Natural Terrestrial Vegetated: Woody Open (40 to 65 %) + + 29: Natural Terrestrial Vegetated: Woody Open (15 to 40 %) + + 30: Natural Terrestrial Vegetated: Woody Sparse (4 to 15 %) + + 31: Natural Terrestrial Vegetated: Woody Scattered (1 to 4 %) + + 32: Natural Terrestrial Vegetated: Herbaceous Closed (> 65 %) + + 33: Natural Terrestrial Vegetated: Herbaceous Open (40 to 65 %) + + 34: Natural Terrestrial Vegetated: Herbaceous Open (15 to 40 %) + + 35: Natural Terrestrial Vegetated: Herbaceous Sparse (4 to 15 %) + + 36: Natural Terrestrial Vegetated: Herbaceous Scattered (1 to 4 %) + + 55: Natural Aquatic Vegetated + + 56: Natural Aquatic Vegetated: Woody + + 57: Natural Aquatic Vegetated: Herbaceous + + 58: Natural Aquatic Vegetated: Closed (> 65 %) + + 59: Natural Aquatic Vegetated: Open (40 to 65 %) + + 60: Natural Aquatic Vegetated: Open (15 to 40 %) + + 61: Natural Aquatic Vegetated: Sparse (4 to 15 %) + + 62: Natural Aquatic Vegetated: Scattered (1 to 4 %) + + 63: Natural Aquatic Vegetated: Woody Closed (> 65 %) + + 64: Natural Aquatic Vegetated: Woody Closed (> 65 %) Water > 3 months (semi-) permanent + + 65: Natural Aquatic Vegetated: Woody Closed (> 65 %) Water < 3 months (temporary or seasonal) + + 66: Natural Aquatic Vegetated: Woody Open (40 to 65 %) + + 67: Natural Aquatic Vegetated: Woody Open (40 to 65 %) Water > 3 months (semi-) permanent + + 68: Natural Aquatic Vegetated: Woody Open (40 to 65 %) Water < 3 months (temporary or seasonal) + + 69: Natural Aquatic Vegetated: Woody Open (15 to 40 %) + + 70: Natural Aquatic Vegetated: Woody Open (15 to 40 %) Water > 3 months (semi-) permanent + + 71: Natural Aquatic Vegetated: Woody Open (15 to 40 %) Water < 3 months (temporary or seasonal) + + 72: Natural Aquatic Vegetated: Woody Sparse (4 to 15 %) + + 73: Natural Aquatic Vegetated: Woody Sparse (4 to 15 %) Water > 3 months (semi-) permanent + + 74: Natural Aquatic Vegetated: Woody Sparse (4 to 15 %) Water < 3 months (temporary or seasonal) + + 75: Natural Aquatic Vegetated: Woody Scattered (1 to 4 %) + + 76: Natural Aquatic Vegetated: Woody Scattered (1 to 4 %) Water > 3 months (semi-) permanent + + 77: Natural Aquatic Vegetated: Woody Scattered (1 to 4 %) Water < 3 months (temporary or seasonal) + + 78: Natural Aquatic Vegetated: Herbaceous Closed (> 65 %) + + 79: Natural Aquatic Vegetated: Herbaceous Closed (> 65 %) Water > 3 months (semi-) permanent + + 80: Natural Aquatic Vegetated: Herbaceous Closed (> 65 %) Water < 3 months (temporary or seasonal) + + 81: Natural Aquatic Vegetated: Herbaceous Open (40 to 65 %) + + 82: Natural Aquatic Vegetated: Herbaceous Open (40 to 65 %) Water > 3 months (semi-) permanent + + 83: Natural Aquatic Vegetated: Herbaceous Open (40 to 65 %) Water < 3 months (temporary or seasonal) + + 84: Natural Aquatic Vegetated: Herbaceous Open (15 to 40 %) + + 85: Natural Aquatic Vegetated: Herbaceous Open (15 to 40 %) Water > 3 months (semi-) permanent + + 86: Natural Aquatic Vegetated: Herbaceous Open (15 to 40 %) Water < 3 months (temporary or seasonal) + + 87: Natural Aquatic Vegetated: Herbaceous Sparse (4 to 15 %) + + 88: Natural Aquatic Vegetated: Herbaceous Sparse (4 to 15 %) Water > 3 months (semi-) permanent + + 89: Natural Aquatic Vegetated: Herbaceous Sparse (4 to 15 %) Water < 3 months (temporary or seasonal) + + 90: Natural Aquatic Vegetated: Herbaceous Scattered (1 to 4 %) + + 91: Natural Aquatic Vegetated: Herbaceous Scattered (1 to 4 %) Water > 3 months (semi-) permanent + + 92: Natural Aquatic Vegetated: Herbaceous Scattered (1 to 4 %) Water < 3 months (temporary or seasonal) + + 93: Artificial Surface + + 94: Natural Surface + + 95: Natural Surface: Sparsely vegetated + + 96: Natural Surface: Very sparsely vegetated + + 97: Natural Surface: Bare areas, unvegetated + + 98: Water + + 99: Water: (Water) + + 100: Water: (Water) Tidal area + + 101: Water: (Water) Perennial (> 9 months) + + 102: Water: (Water) Non-perennial (7 to 9 months) + + 103: Water: (Water) Non-perennial (4 to 6 months) + + 104: Water: (Water) Non-perennial (1 to 3 months) +::: + +:::{dropdown} Level 3 Class descriptions +**Cultivated Terrestrial Vegetation (CTV)** + +Cultivated Terrestrial Vegetation (CTV) is associated with agricultural areas where active cultivation has been observed. In version 1.0 only herbaceous cultivation is shown and describes vegetation of strongly varying cover, ranging from bare (e.g. ploughed) areas to fully developed crops. Whilst the continental product describes land cover, interpretation is complicated as the same terminology is used to report on land use. + +The definition of cultivated, and the difference to natural or semi-natural land covers, can be contentious particularly as much of the Australian landscape is used for agricultural food production. This includes areas of natural terrestrial vegetation (NTV) and natural aquatic vegetation (NAV) that are grazed by stock and which can be regarded as either semi-natural or cultivated. + +CTV in the DEA Land Cover map is associated with areas where management practices aimed at cultivation (including for grass production) are actively performed during the year being shown. These practices include crop planting and harvesting, fertilization and ploughing. These practices often lead to highly dynamic spectral signals within and between years but also regular transitions between vegetation of different cover amounts as well as bare soil. This also means that agricultural areas will transition between natural and cultivated covers as management practices transition an area between actively cropped or grazed, to areas left fallow, areas reduced to low cover due to climate effects such as drought, or to other covers depending on what the predominant conditions are through the year being shown. + +**Natural Terrestrial Vegetation (NTV)** + +Natural Terrestrial Vegetation (NTV) represents areas that have all or most of the characteristics of natural or semi-natural herbaceous or woody vegetation (based primarily on floristics, structure, function and dynamics). These areas are identified as primarily vegetated, with either a photosynthetic vegetation fraction (PV) or non-photosynthetic fraction (NPV) greater than the bare soil fraction (BS) for at least two consecutive months. This approach considers that vegetation can exist in, and transition between, PV and NPV states during the year. In effect this approach classifies the landscape as primarily vegetated where the vegetated fraction of a pixel is greater than 30 %. Where the proportion of the landscape is under 30 % vegetated, it is regarded as sparsely vegetated or natural surface, but the cover proportions can still be quantified. Urban areas that are vegetated (e.g. suburbs with trees) are associated with NTV if the pixel is at least 30 % vegetated but artificial surfaces (AS) otherwise. The implementation allows areas of semi-natural vegetation (e.g. native grasslands/pastureland) to be included in the NTV class. + +**Natural Aquatic Vegetation (NAV)** + +Natural Aquatic Vegetation (NAV) is associated primarily with wetlands that are dominated by woody and/or herbaceous vegetation (as with NTV). NAV is generally associated with swamps, fens, flooded forests, saltmarshes or mangroves. Only mangroves are included in the current release. + +**Artificial Surfaces (AS)** + +Artificial Surfaces (AS) are areas of non-vegetated land cover created by human activities and are primarily represented by impervious surfaces (e.g. urban and industrial buildings, roads and railways). These can be more readily identified when the area is larger than the spatial resolution (25 m) provided by the sensor. Open cut extraction sites are often included in AS. However, there is considerable misclassification of NS as AS in areas where vegetated cover is very low and very consistent through the year. + +**Natural Surfaces (NS)** + +Natural Surfaces (NS) are comprised primarily of unconsolidated (often pervious, e.g. mudflats, saltpans) and/or consolidated (e.g. bare rock or bare soil) materials. In Australia, the proportional area of natural surfaces is relatively low and primarily confined to the deserts and semi-arid areas, river channels (e.g. dry riverbeds) and the coastline (e.g. sand dunes, mudflats). Much of the interior of Australia is sparsely vegetated and can be dominated by herbaceous (annual or perennial) or woody lifeforms. + +**Water** + +The Water class captures terrestrial and coastal open water such as dams, lakes, large rivers and the coastal and near-shore zone. +::: + +:::{dropdown} Level 4 Class Descriptions +**Lifeform (NTV, NAV and CTV; 2 classes)** + +Lifeform represents the dominant vegetation type of a primarily vegetated area, discriminating woody from non-woody (herbaceous) vegetation. The Woody Cover Fraction models woody as vegetation of at least 2m in height and at least 20 % canopy cover. Hence the dominant vegetation in areas designated as woody in this product is considered to be composed of shrubs and trees. However where woody vegetation is not dominant in an area, the cover will be essentially herbaceous or bare. Hence some areas containing sparse trees or shrubs will likely be represented as herbaceous. + +**Vegetation Cover (NTV, NAV and CTV; 5 classes)** + +Vegetation cover is defined using the statistics of annual fractional cover of PV (for a calendar year). This relates to the upper-most foliage as observed from the Landsat satellite sensor, and describes the percentage of an area that is vegetated rather than bare. + +**Water Seasonality (NAV; 2 classes)** + +Water seasonality refers to the typical hydrological conditions in NAV within a year and is relevant to both coastal and inland wetlands. The current implementation utilises the Water Observations from Space (WOfS) dataset, identifying hydro-periods for NAV areas where water is (semi-) permanent (over 3 months) or temporary or seasonal (under 3 months). + +**Water State (Water; 1 class)** + +Water state establishes whether water is present in liquid form or as snow or ice. The current product only identifies areas where water is present as liquid for at least 20 % of observations (based on WOfS). + +**Water Persistence (Water; 4 classes)** + +Water persistence (or hydro-period) describes the maximum duration (in months) that water is seen to be covering the surface in the year. + +**Intertidal (Water; 1 class)** + +Intertidal water refers to primarily non-vegetated aquatic areas with systematic, tidal water variations. + +**Bare Gradation (NS; 3 classes)** + +The bare gradation describes the percentage of bare surface in areas which contain sporadic or little persistent green vegetation through the year. The percentage reflects that much of the remaining area is brown or dead vegetation and is characteristic of the more arid parts of Australia. +::: + +## Lineage + +The FAO LCCS taxonomy (Figure 1) is hierarchical and consists of a dichotomous phase (Level 1 to 3) and a modular phase (referred to as Level 4). In Level 1, vegetated and non-vegetated areas are first separated. These are then divided into terrestrial or aquatic categories to form Level 2. In the vegetated terrestrial category, cultivated and natural (including semi-natural) areas are differentiated. The non-vegetated category is further divided into artificial surfaces, and natural surfaces incorporating low vegetation cover and bare areas. Including the non-vegetated aquatic class (from Level 2), this results in the creation of six base land cover categories. + +![Diagram showing the portion of the LCCS taxonomy which is implemented in DEA Land Cover v1.0.0](/_files/cmi/cut_back_0.PNG) + +*Figure 1 - Diagrammatic representation of the implementation of the FAO LCCS (Version 2) classification within the DEA Land Cover product version 1.0.* + +At Level 4, vegetated areas are further classified using information that differentiates lifeform (woody and herbaceous) and quantifies vegetation cover percent and water seasonality (for Natural Aquatic Vegetation). Natural Surface areas have information added (bare gradation) which describes the level of remaining vegetation present (sparse, very sparse or not detectable). Non-vegetated aquatic areas (Water) are further described on the basis of their persistence (hydroperiod) over a calendar year. The FAO LCCS differentiates water in different physical states (liquid or frozen; ice or snow), however only liquid water is included in the current release. + +![Diagram showing the data products which go into producing the level 3 classification.](/_files/cmi/level3-dataflow.PNG) + +*Figure 2 - Input data products used to produce Level 3 classification* + +![Diagram showing input data products used to produce the Level 4 classification](/_files/cmi/level4-dataflow.PNG) + +*Figure 3 - Input data products used to produce Level 4 classification* + +% ## Processing steps + +## Software + +* [https://bitbucket.org/au-eoed/livingearth\_lccs/src/main/](https://bitbucket.org/au-eoed/livingearth_lccs/src/main/) +* [https://bitbucket.org/geoscienceaustralia/livingearth\_australia/src/master/](https://bitbucket.org/geoscienceaustralia/livingearth_australia/src/master/) + +## References + +Lucas R, Mueller N, Siggins A, Owers C, Clewley D, Bunting P, Kooymans C, Tissott B, Lewis B, Lymburner L, Metternicht G. Land Cover Mapping using Digital Earth Australia. *Data*. 2019; 4(4):143. [https://doi.org/10.3390/data4040143](https://doi.org/10.3390/data4040143) + +Christopher J. Owers, Richard M. Lucas, Daniel Clewley, Carole Planque, Suvarna Punalekar, Belle Tissott, Sean M. T. Chua, Pete Bunting, Norman Mueller & Graciela Metternicht (2021) *Living Earth*: Implementing national standardised land cover classification systems for Earth Observation in support of sustainable development, Big Earth Data, 5:3, 368-390, DOI: [10.1080/20964471.2021.1948179](https://doi.org/10.1080/20964471.2021.1948179) + +Metternicht, G., Mueller, N., Lucas, R., Digital Earth for Sustainable Development Goals, Manual of Digital Earth, pp 443 - 471, Springer Singapore. [https://doi.org/10.1007/978-981-32-9915-3\_13](https://doi.org/10.1007/978-981-32-9915-3_13) + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_faqs.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_faqs.md new file mode 100644 index 000000000..8373c80bd --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_faqs.md @@ -0,0 +1,5 @@ +% ## Frequently asked questions + +% :::{dropdown} What is the question? +% ::: + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_history.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_history.md new file mode 100644 index 000000000..06c307340 --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_history.md @@ -0,0 +1,2 @@ +% ## Changelog + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_overview_1.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_overview_1.md new file mode 100644 index 000000000..9a2a5969d --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_overview_1.md @@ -0,0 +1,10 @@ +## About + +Digital Earth Australia (DEA) Land Cover translates over 30 years of satellite imagery into evidence of how Australia's land, vegetation and waterbodies have changed over time. + +:::{admonition} New version in development +:class: note + +A new version of this product is being developed. Subscribe to the [DEA newsletter](https://communication.ga.gov.au/dea-news-subscribe) to be notified of product releases. +::: + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_overview_2.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_overview_2.md new file mode 100644 index 000000000..8e89c580b --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_overview_2.md @@ -0,0 +1,10 @@ +% ## Cite this product + +% > Your citation + +## Publications + +Lucas R, Mueller N, Siggins A, Owers C, Clewley D, Bunting P, Kooymans C, Tissott B, Lewis B, Lymburner L, Metternicht G. Land Cover Mapping using Digital Earth Australia. *Data*. 2019; 4(4):143. [https://doi.org/10.3390/data4040143](https://doi.org/10.3390/data4040143) + +Christopher J. Owers, Richard M. Lucas, Daniel Clewley, Carole Planque, Suvarna Punalekar, Belle Tissott, Sean M. T. Chua, Pete Bunting, Norman Mueller & Graciela Metternicht (2021) *Living Earth*: Implementing national standardised land cover classification systems for Earth Observation in support of sustainable development, Big Earth Data, 5:3, 368-390, DOI: [10.1080/20964471.2021.1948179](https://doi.org/10.1080/20964471.2021.1948179) + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_quality.md b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_quality.md new file mode 100644 index 000000000..34c85048a --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_quality.md @@ -0,0 +1,89 @@ +## Accuracy + +The product was validated using 6000 points spatially distributed over Australia. These points were created using a stratified random sampling approach slightly adjusted for oversampling. This process was conducted for 2010 and 2015 creating 12000 samples in total. After removing points with No Data and spurious values the total number was 11750. The sample points were divided into clusters for visual assessment against the outputs from the classification and assessed individually from a pool of 10 people. To compare the individual biases of the individual assessors, an additional set of validation points were created that all assessors evaluated, the results are shown in Table 4. Where assessors could identify a predominant land cover (i.e. not ‘mixed’ pixels or ‘unsure’), all assessors agreed 75 % of the time. + +Table 2 contains the overall accuracy for all classes. The term ‘support’ refers to the number of validation points used in the calculation of that accuracy value. + +![Overall accuracy of DEA Land Cover is 80%. 2010 accuracy is 82%, 2015 accuracy is 78%.](/_files/cmi/overall-accuracy_0.PNG) + +Table 3 contains per-class accuracy information. “Precision” refers to the ability of a classification model to return only relevant instances. “Recall” refers to the ability to identify all relevant instances. The “F1 score” is a combination of precision and recall and an overall measure of accuracy. Classes such as artificial surfaces, natural aquatic vegetation and water had high accuracies. Classifying cultivated terrestrial vegetation and bare surfaces was challenging and accuracies were the lowest of the six classes presented here. + +![Table showing accuracy per class, including precision, recall, F1 score and support values per class. ](/_files/cmi/per-class-accuracy.PNG) + +![table showing the agreement between assessors.](/_files/cmi/inter-assessor-agreement.PNG) + +### Limitations of the Implementation Method + +DEA Land Cover is created by combining multiple layers that each describe features in the landscape. In doing so the extents of each layer do not necessarily completely align, and some no-data points can cross between outputs. As a result, there are some level 4 classes that only report detail to level 3 as the details of cover fraction and water persistence do not have corresponding data in the respective datasets. This specifically relates the classes of Water, NS and NAV in areas near water bodies and the intertidal zone, however the number of affected pixels is small. + +:::{dropdown} Level 3 Class Limitations +**Cultivated Terrestrial Vegetation (CTV)** + +Managed plantations and some orchards and tree crops are not currently distinguishable from semi-natural or natural terrestrial vegetation and are not yet incorporated in the area of CTV. Reference can be made to Australia’s National Plantation Inventory. In savanna regions (e.g. Queensland, Northern Territory and Western Australia), variable cycles associated with fires, inundation, drought and rainfall lead to greening or browning of natural vegetation that mirrors the seasonal or management-induced behavior of cultivated land. This leads to some areas of NTV, NS or NAV being misclassified as CTV. For example, the anomalous high levels of rainfall in 2010 led to vegetation growth patterns that were classified as cultivated vegetation, these false positives reduced the precision of the class in that year. Several natural vegetation types, particularly in the monsoonal north, are mapped as CTV due to burning, which can be associated with the indigenous management cycle. Saltmarsh and surface algae on mudflats can also be misclassified. Areas of bare soil exposed for long periods during the agricultural cycle or management activities, and sparse vegetation (when areas are not in use or fallow such as during drought periods) can be assigned as Natural Surfaces (NS). This is particularly the case where areas have experienced low cover for prolonged periods within a year. + +**Natural Terrestrial Vegetation (NTV)** + +The NTV category can transition into the NS category between years when a highly variable Landsat satellite spectral signature is observed due to changes in vegetation productivity and moisture content. The transition of NTV to NS is particularly evident when comparing periods with rainfall above (as in 2010) or below (e.g. drought; as in 2015) the average. Some confusion between surfaces that are primarily bare surfaces and non-photosynthetic vegetation remains and is also partly a function of the spectral reflectance of the underlying soil type. Vegetated areas shadowed by terrain can also be misclassified as non-vegetated. Areas of very low vegetation coverage are associated with the NS rather than NTV category, with the cover percentages shown as percentage bare. The assignment of vegetated suburbs to NTV is largely correct, but AS surfaces located beneath the canopy are not currently represented in the product. Some confusion between CTV and NTV can occur because of natural seasonal changes in native vegetation. The edges of salt lakes may be misclassified as NTV. + +**Natural Aquatic Vegetation (NAV)** + +Currently only mangroves are mapped in the NAV class. Other vegetated natural landscapes (e.g. saltmarsh, river red gum forests in the Murray Valley, surface algae and other inland wetlands) where water significantly influences edaphic conditions of substrate are not mapped. This is because, in the current implementation, the water mask is included to assist in the differentiation of vegetation and non-vegetation as the presence of water creates excess noise in the underlying Fractional Cover product. To reduce this noise, the WOfS product is used as a water mask in the Fractional Cover product, and hence it is unlikely to produce the combination of vegetation and water required for the NAV class. + +**Artificial Surfaces (AS)** + +Misclassification occurs with natural surfaces, particularly in the arid and semi-arid regions, open cut mine sites, salt lakes and pans, sand dunes and beaches. This is attributed to similarities in the variance of spectral signatures over a year. Misclassification occurs in some cultivated areas attributable to the predominance of sparse vegetation or when land is left fallow for most of the year. The current temporal variance mask is 250 m in spatial resolution, compared to the 25 m land cover product, resulting in artefacts appearing in the land cover from the masking process. In addition, urban areas with an area less than 250 m are often excluded. Cloud and data quality issues can lead to incorrect assignment of other land cover classes to AS such as in south-west Tasmania. + +**Natural Surfaces (NS)** + +Land used for agriculture may be associated with an NS class if ploughing or tillage has occurred and the vegetation cover remains low during the calendar year. Areas mapped as NS may, under certain circumstances (e.g. during drought) temporarily transition to or from CTV. This occurs because of the dominance of non-persistent vegetation (e.g. short crop life spans), desiccation, removal during dry periods or management practices (e.g. left as fallow). Where acquisition of cloud-free Landsat satellite sensor data has been infrequent, less information on the inter-annual variability of vegetation is provided. Where cloud cover is extensive (e.g. in Tasmania), the number of scenes for land cover classification is reduced and this can compromise classification of NS, particularly where bare surfaces alternate with vegetation. Confusion between natural surfaces and urban areas occurs because of similar spectral variation over an annual period. + +**Water** + +Areas of artificial and natural water are not differentiated, although the extent of the former is mapped within the existing Bureau of Meteorology Geofabric product. Due to the 25 m pixel size, rivers and water courses that cover less than a pixel, or with highly vegetated riverbanks are not captured, resulting in a patch-like representation of narrower rivers. Areas of dark, wet soil are often misclassified as water, including in cultivated areas and mud flats. +::: + +:::{dropdown} Level 4 Class Limitations +**Lifeform** + +The woody discrimination is implemented using the Woody Cover Fraction product (Liao et al, 2020), which models woody cover from inputs of LiDAR including ICESat/GLAS, L-band SAR, field observation and Landsat satellite data. Issues arise in this dataset in areas dominated by short, woody vegetation such as heathland, and swampy regions where underlying water can introduce errors. Areas of woody savannah are also underrepresented due to the influence of the herbaceous understory dominating the observation. + +**Vegetation Cover** + +The cover of vegetation is derived from the fractional cover product (Scarth et al, 2010), and as such reflects the limitations of that product, mainly difficulty with measurement of non-photosynthetic vegetation, and noise due to the presence of water in a pixel. Thus arid areas can be difficult to fully analyse for cover, leading to misclassifications between NTV, NS and CTV where cover is sparse (lower than 15 %). + +**Water Seasonality** + +This product does not yet identify consecutive months but rather the frequency of wet observations in the year, based on the WOfS product. Therefore, monthly statements are unlikely to be consistent across the continent. Mangroves are currently the only consistently identified NAV and water cannot be easily observed beneath their canopies, which are often dense. Hence, the hydroperiod (and hence seasonality metrics) should be treated with some caution. + +**Water State** + +Mapping of ice and snow states has yet to be undertaken. Hence the water state class is currently limited to liquid only. + +**Intertidal** + +The intertidal areas carry the limitations of the ITEM product: + +* Intertidal areas are determined as a coastal mask, which currently identifies some non-tidal inland water bodies as tidal because of intra-annual changes in water extent. + +* This product is static and cannot be used to demonstrate change between two annual continental products. + + +**Bare Gradation** + +Bare gradation is produced from the fractional cover product. Unlike the Vegetation Cover class, Bare Gradation is calculated from the median bare fraction, rather than consecutive, monthly green and non-photosynthetic fractions. Hence the bare fraction can be as low as 20 %, however this does not imply that the remaining fraction is healthy vegetation. Rather the remaining fraction is a mix of brown, dead and green vegetation, with intermittent green periods through the year, reflective of arid area vegetation types. +::: + +### Earth Observation Limitations + +To generate the land cover classification for each calendar year, annual (January – December) statistics derived from Landsat-5, -7 and -8 observations are currently used, with each satellite sensor potentially observing the Australian landscape every 16 days. This brings an intrinsic limitation to land cover mapping as persistent cloud in some regions reduces the number of useable observations. This is particularly evident in Tasmania, and northern Australia during the monsoon period, where areas may not be observed for extended periods and parts or all of the intra-annual land cover cycle may be missed. These limitations can lead to misclassifications of land cover, particularly in dynamic environments. In a future release, a confidence layer will be included to help identify areas with poor observation frequency or other factors impacting the classification. + +An additional limitation of the Landsat series is the availability of data due to the ageing of each satellite. Landsat 5 was operational for over 25 years, but for much of the later years, data were only acquired when sunlight directly illuminated its solar panels. This limited its operation across Australia, with coverage being seasonally dependent, and contracting north to a minimum in winter. In its last years the winter coverage usually only covered the northern coasts of Australia. Landsat 5 ceased regular operations over Australia in 2011, leaving just Landsat 7 until Landsat 8 was launched in 2013. Landsat 7 began service in 1999 as a replacement for Landsat 5. Initially Landsat 5 was switched off, but when Landsat 7 suffered a serious problem in 2003 due to the failure of its scan-line corrector (termed SLC-Off) Landsat 5 resumed service. The SLC-Off failure of Landsat 7 results in severe striping across every image from mid 2003 onwards, apparent in subsequent derived products. Landsat 8 has operated well since launch in 2013, with improved sensitivity, noise characteristics and data correction in comparison to the earlier sensors. + +The result of the availability of the satellites is that the most consistent data availability occurs when two satellites are in operation (most of the 2003 to present period). The least data availability is in 2011 – 2012 when only Landsat 7 was available with data containing the SLC-Off striping issue. The overall data availability for the Landsat satellites is shown in Table 5. The datasets used in this analysis are shown in Table 6. + +![table detailing availability of different Landsat satellites since 1986 and any known issues.](/_files/cmi/eo-limitations-table.PNG) + +![datasets within DEA used to provide essential descriptor information](/_files/cmi/DEA-datasets-used.PNG) + +% ## Quality assurance + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/_unused_data.yaml b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_unused_data.yaml new file mode 100644 index 000000000..1feafb42e --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/_unused_data.yaml @@ -0,0 +1,123 @@ +# Unused data migrated from the CMI. +# READ-ONLY - Don't edit this file. +# This data is saved here for record-keeping purposes and is likely out-of-date; it isn't displayed on the Knowledge Hub. + +# General + +cmi_node: 607 +cmi_url: https://cmi.ga.gov.au/data-products/dea/607/dea-land-cover-landsat +published_date: "2021-11-18" +author: C. K. @ ga.gov.au +created: 2020-11-30T19:36:43+1100 + +# Basics tab + +program: dea +theme: Land and vegetation +catalogue: DEA Land Cover +collection_slug: null +is_deprecated: null +is_primary_record: null +project_leader: N. M. @ ga.gov.au +branch_head: M. W. @ ga.gov.au +related_items: + - DEA Water Observations (Landsat) + - DEA Water Observations Statistics (Landsat) + - DEA Water Observations Filtered Statistics (Landsat) + - DEA Surface Reflectance Geomedian (Landsat) + - DEA Surface Reflectance Median Absolute Deviation (Landsat) + - DEA Fractional Cover (Landsat) + - DEA Fractional Cover Percentiles (Landsat) + - DEA Mangrove Canopy Cover (Landsat) + - DEA Intertidal Extents (Landsat) +anzsrc_research_code: EARTH SCIENCES + +# Access tab + +map_names: + - Land Cover Story Map on DEA Maps +ecat_url: http://pid.geoscience.gov.au/dataset/ga/146090 +doi_url: https://dx.doi.org/10.26186/146090 +open_data_cube_configuration: null +security_classification: Unclassified +time_span_full: + start: null + end: null + +# Details tab + +relevant_websites: + - link: http://www.fao.org/3/X0596E/X0596e00.htm + name: "Land Cover Classification System (LCCS): Classification concepts and user manual" + - link: https://www.dea.ga.gov.au/ + name: DEA web pages on the Geoscience Australia website + +# Processing tab + +data_sources: + - DEA Water Observations (Landsat) + - DEA Water Observations Statistics (Landsat) + - DEA Water Observations Filtered Statistics (Landsat) + - DEA Surface Reflectance Geomedian (Landsat) + - DEA Surface Reflectance Median Absolute Deviation (Landsat) + - DEA Fractional Cover (Landsat) + - DEA Fractional Cover Percentiles (Landsat) + - DEA Mangrove Canopy Cover (Landsat) + - DEA Intertidal Extents (Landsat) +major_algorithms: null +schema_spatial_extent: + temporal_extent: + start: 1986-08-15T14:00:00+1000 + end: 2017-07-31T13:59:59+1000 + min_longitude: -1943830 + max_longitude: 2170690 + min_latitude: -1119030 + max_latitude: -4856630 + coordinate_reference_system: "Australian Albers / GDA94 (EPSG: 3577)" + coordinate_reference_system_units: metre + cell_size_x: 25 + cell_size_y: 25 + pixel_origin: Top Left + spatial_extent: + geo_type: Polygon + lat: "-34.714349000000" + long: "133.725681300000" + left: "93.771493500000" + top: "-8.483833800000" + right: "173.679869100000" + bottom: "-60.944864200000" + geohash: null + +# Media tab + +media: null +case_studies: null +header_image_alt: Land Cover 2015 +files: null + +# Credits tab + +owners: + - Commonwealth of Australia (Geoscience Australia) +custodians: + - Commonwealth of Australia (Geoscience Australia) +principal_contributors: + - B. T. + - N. M. + - R. L. +subject_matter_experts: + - N. M. + - B. T. +publishing_entities: + - Commonwealth of Australia (Geoscience Australia) +metadata_contacts: + - Geoscience Australia - Team Leader, Product Management, Operations Section NEMO +media_contacts: + - Geoscience Australia - GA Media Hotline +rights_statement: © Commonwealth of Australia (Geoscience Australia) 2019. [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/.). +data_source_contacts: + - "Geoscience Australia - Team Leader, Applications and Systems Support, NEMO " +approvers_checklist: null +approvers_checklist_hprm_reference: D2021-75666 +pmp_hprm_reference: D2021-75667 + diff --git a/docs/data/old-version/dea-land-cover-landsat-1.0.0/index.rst b/docs/data/old-version/dea-land-cover-landsat-1.0.0/index.rst new file mode 100644 index 000000000..ca23c85d5 --- /dev/null +++ b/docs/data/old-version/dea-land-cover-landsat-1.0.0/index.rst @@ -0,0 +1,2 @@ +.. datatemplate:yaml:: _data.yaml + :template: product-v1.rst diff --git a/docs/data/product/dea-land-cover-landsat/_access.md b/docs/data/product/dea-land-cover-landsat/_access.md index 69f68ba73..c3681dcd5 100644 --- a/docs/data/product/dea-land-cover-landsat/_access.md +++ b/docs/data/product/dea-land-cover-landsat/_access.md @@ -29,7 +29,7 @@ DEA Land Cover data can be downloaded from DEA’s public data holdings through ***via web browser:*** -From [here](https://data.dea.ga.gov.au/?prefix=derivative/ga_ls_landcover_class_cyear_2/1-0-0/), simply navigate to the year and tile* of interest and directly download the GeoTIFF file for the layer you’re after. +From [here](https://data.dea.ga.gov.au/?prefix=derivative/ga_ls_landcover_class_cyear_3/2-0-0/), simply navigate to the year and tile* of interest and directly download the GeoTIFF file for the layer you’re after. **To find x and y tile values for an area, see the Explorer [here](https://explorer.dea.ga.gov.au/products/ga_ls_landcover_class_cyear_2).** @@ -39,7 +39,7 @@ First you need to install AWS CLI, instructions [here](https://docs.aws.amazon.c Then you can download data from the command line with a command such as: ``` -aws s3 --no-sign-request sync s3://dea-public-data/derivative/ga_ls_landcover_class_cyear_2/1-0-0/2020 C:/landcover/ --exclude "*" --include "*_level4.tif" +aws s3 --no-sign-request sync s3://dea-public-data/derivative/ga_ls_landcover_class_cyear_3/2-0-0/2020 C:/landcover/ --exclude "*" --include "*_level4.tif" ``` (This downloads all level4 tiles for 2020 into a folder called ‘landcover’) @@ -52,7 +52,7 @@ Where: [1] The s3 bucket and folder to download data from: e.g., ``` -s3://dea-public-data/derivative/ga_ls_landcover_class_cyear_2/1-0-0/2020 +s3://dea-public-data/derivative/ga_ls_landcover_class_cyear_3/2-0-0/2020 ``` [2] The directory to download to: e.g., ``` @@ -70,6 +70,13 @@ C:/landcover/ :::{dropdown} Adding DEA Landcover to QGIS +There are two options for adding DEA Landcover to QGIS. + +1. Adding the OWS web service +2. Uploading the downloaded individual tif files + +**Adding the web service:** + *(for the time dimension to work you need version 3.22+)* From the drop down menus at the top select `Layer` > `Add Layer` > `Add WMS/WMTS Layer` @@ -93,6 +100,22 @@ Once you have selected a layer, click `Add` at the bottom of the window to add i Temporal information can be accessed by clicking the clock icon next to the name of the layer in the layers list. +**Adding the individual tif files:** + +Individual tiles can be downloaded from s3 via the above instruction, and can be then uploaded to QGIS. + +Once the files are uploaded the styling for the tif files can be downloaded here: [Level 3 QGIS Style](https://dea-public-data-dev.s3.ap-southeast-2.amazonaws.com/derivative/ga_ls_landcover_class_cyear_3/ga_ls_landcover_class_cyear_3_style.qml) and [Level 4 QGIS Style](https://dea-public-data-dev.s3.ap-southeast-2.amazonaws.com/derivative/ga_ls_landcover_class_cyear_3/ga_ls_landcover_class_cyear_4_style.qml) + +To add the style, + +1. Select the tif files you would like the styling applied to + +2. Right click and select `Properties` then `Symbology` + +3. Select `Style` and the `Load Style` in the bottom left hand menu + +The styling will now be applied to the tif classification file, to enable a colour representation of the land cover classifications + ::: :::{dropdown} Adding DEA Landcover to ArcMap @@ -118,4 +141,3 @@ Now add the layer to your map: 5. Click `Add` ::: - diff --git a/docs/data/product/dea-land-cover-landsat/_data.yaml b/docs/data/product/dea-land-cover-landsat/_data.yaml index 26aac3e33..0ffcc904d 100644 --- a/docs/data/product/dea-land-cover-landsat/_data.yaml +++ b/docs/data/product/dea-land-cover-landsat/_data.yaml @@ -3,10 +3,9 @@ # Specifications short_name: DEA Land Cover (Landsat) -full_technical_name: "Geoscience Australia Landsat Land Cover 25m " +full_technical_name: "Geoscience Australia Landsat Land Cover 30m" header_image: /_files/cmi/DEA_Land_Cover_1_0_0_Lvl4_2015.jpg - -version_number: 1.0.0 +version_number: 2.0.0 is_latest_version: true latest_version_link: null is_provisional: false @@ -16,25 +15,43 @@ spatial_data_type: RASTER spatial_coverage: null temporal_coverage_start: 1988 -temporal_coverage_end: 2020 +temporal_coverage_end: Present temporal_coverage_custom: null data_update_frequency: YEARLY -data_update_activity: NO_UPDATES +data_update_activity: ONGOING is_currency_reported: true -resolution: 25 m +resolution: 30 m coordinate_reference_system: null product_ids: - - ga_ls_landcover_class_cyear_2 + - ga_ls_landcover_class_cyear_3 parent_products: - - name: null - link: null + - name: Geoscience Australia Landsat Water Observations Collection 3 + link: /data/category/dea-water-observations-landsat/ + - name: Geoscience Australia Landsat Water Observation Statistics Collection 3 + link: /data/category/dea-water-observations-statistics-landsat/ + - name: Geoscience Australia Landsat Fractional Cover Collection 3 + link: /data/category/dea-fractional-cover-landsat/ + - name: Geoscience Australia Landsat Fractional Cover Percentiles Collection 3 + link: /data/category/dea-fractional-cover-percentiles-landsat/ + - name: Geoscience Australia Tasseled Cap Percentiles Collection 3 + link: /data/category/dea-tasseled-cap-percentiles-landsat/ + - name: Geoscience Australia Mangrove Canopy Cover Collection 3 + link: /data/category/dea-mangroves/ + - name: National Intertidal Digital Elevation Model 25m 1.0.0 + link: /data/category/dea-intertidal-elevation-landsat-1.0.0/ + - name: Geoscience Australia Shuttle Radar Topography Mission 1 second DEM version 1.0 + link: /data/category/ga-srtm-1-second-dem/ + - name: Landsat 5, 7, 8, and 9 NBART and Observational Attributes + link: /data/category/dea-surface-reflectance/ + # - name: Geoscience Australia Landsat Water Observations Collection 3, Geoscience Australia Landsat Water Observation Statistics Collection 3, Geoscience Australia Landsat Fractional Cover Collection 3, Geoscience Australia Landsat Fractional Cover Percentiles Collection 3, Geoscience Australia Tasseled Cap Percentiles Collection 3, Geoscience Australia Mangrove Canopy Cover Collection 3, National Intertidal Digital Elevation Model 25m 1.0.0, Geoscience Australia Shuttle Radar Topography Mission 1 second DEM version 1.0 + # link: null collections: - - name: Geoscience Australia Landsat Collection 2 + - name: Geoscience Australia Landsat Collection 3 link: /search/?q=Geoscience+Australia+Landsat+Collection+3 doi: 10.26186/146090 @@ -58,12 +75,14 @@ access_links_maps: name: null access_links_explorers: - - link: https://explorer.dea.ga.gov.au/products/ga_ls_landcover_class_cyear_2 + - link: https://explorer.dea.ga.gov.au/products/ga_ls_landcover_class_cyear_3 name: null access_links_data: - - link: http://dea-public-data.s3-website-ap-southeast-2.amazonaws.com/?prefix=derivative/ga_ls_landcover_class_cyear_2/ + - link: http://dea-public-data.s3-website-ap-southeast-2.amazonaws.com/?prefix=derivative/ga_ls_landcover_class_cyear_3/ name: Access the data on AWS + - link: https://thredds.nci.org.au/thredds/catalog/jw04/ga_ls_landcover_class_cyear_3/catalog.html + name: Access the data on NCI Thredds access_links_code_examples: - link: /notebooks/DEA_products/DEA_Land_Cover/ @@ -77,7 +96,10 @@ access_links_custom: null # History -previous_versions: null +previous_versions: + - version: 1.0.0 + title: Geoscience Australia Landsat Land Cover 25m + slug: dea-land-cover-landsat-1.0.0 # SEO diff --git a/docs/data/product/dea-land-cover-landsat/_description.md b/docs/data/product/dea-land-cover-landsat/_description.md index f50d77f02..3bd4a9f6e 100644 --- a/docs/data/product/dea-land-cover-landsat/_description.md +++ b/docs/data/product/dea-land-cover-landsat/_description.md @@ -41,9 +41,17 @@ Annual Land Cover information can be used in a number of ways to support the mon * Mapping impacts of natural disasters * Bushfire recovery +||| +|---|---| +| *a)* ![Timeseries Perth urban expansion](/_files/land_cover/Perth_urban_timeseries_lc_lvl3_gmad.gif) | *b)* ![Timeseries Mt Beggary bushfire](/_files/land_cover/mt_beggary_bushfire_timeseries_lc_lvl4_gmad.gif) | +| *c)* ![Timeseries inlet changes](/_files/land_cover/shallow_inlet_timeseries_lc_lvl3_gmad.gif) | *d)* ![Timeseries lake Amadeus](/_files/land_cover/lake_amadeus_timeseries_lc_lvl4_gmad.gif) | + +*Figure 1 - Examples of phenomena that can be tracked with the land cover product. a) Urban expansion of Quinns Rocks (Perth). b) Vegetation change and recovery following the Mt Beggary bushfire; c) Morphological changes of Shallow Inlet in Victoria. d) Annual variability of Lake Amadeus, a salt lake in the Northern Territory; the water persistence classification can be employed to track changes in its extent.* + + ## Technical information -DEA Land Cover is based on the globally applicable Food and Agriculture Organisation's (FAO) Land Cover Classification System (LCCS) taxonomy Version 2 (Di Gregorio and Jansen, 1998; 2005). DEA Land Cover classifications have been generated by combining quantitative (continuous) or qualitative (thematic) environmental information (referred to as Essential Descriptors; EDs) derived from Landsat satellite sensor data. Several EDs have been generated previously by Geoscience Australia, including [annual water summaries](/data/product/dea-water-observations-statistics-landsat/) (Mueller et al., 2016), [vegetation fractional cover](/data/category/dea-fractional-cover/) (Scarth et al., 2010), [mangrove extent](/data/product/dea-mangrove-canopy-cover-landsat/) (Lymburner et al., 2020) and the [Inter Tidal Extent Model](/data/product/dea-intertidal-extents-landsat/) (ITEM; Sagar et al., 2017), whilst others have been developed more recently. These EDs have been combined to generate detailed, consistent and expandable annual classifications of Australia’s land cover from 1986 through to 2020. +DEA Land Cover is based on the globally applicable Food and Agriculture Organisation's (FAO) Land Cover Classification System (LCCS) taxonomy Version 2 (Di Gregorio and Jansen, 1998; 2005). DEA Land Cover classifications have been generated by combining quantitative (continuous) or qualitative (thematic) environmental information (referred to as Essential Descriptors; EDs) derived from Landsat satellite sensor data. Several EDs have been generated previously by Geoscience Australia, including [annual water summaries](/data/product/dea-water-observations-statistics-landsat/) (Mueller et al., 2016), [vegetation fractional cover](/data/category/dea-fractional-cover/) (Scarth et al., 2010), [mangrove extent](/data/product/dea-mangrove-canopy-cover-landsat/) (Lymburner et al., 2020) and the [Inter Tidal Extent Model](/data/product/dea-intertidal-extents-landsat/) (ITEM; Sagar et al., 2017), whilst others have been developed more recently. These EDs have been combined to generate detailed, consistent and expandable annual classifications of Australia’s land cover from 1986 through to present. DEA Land Cover consists of eight datasets: The base (level 3) classification, seven additional descriptor layers, and the final (level 4) classification combining the base classes with their associated descriptors. @@ -67,84 +75,6 @@ The base Level 3 land cover classification 216: Natural Bare Surface (NS) 220: Water - -**Lifeform** - -Describes the detail of vegetated classes, separating woody from herbaceous - - 0: Not applicable (such as in water areas) - - 1: Woody (trees, shrubs) - - 2: Herbaceous (grasses, forbs) - -**Vegetation Cover** - -The measured cover of vegetated areas - - 0: Not applicable (such as in bare areas) - - 10: Closed (>65 %) - - 12: Open (40 to 65 %) - - 13: Open (15 to 40 %) - - 15: Sparse (4 to 15 %) - - 16: Scattered (1 to 4 %) - -**Water Seasonality** - -The length of time an aquatic vegetated area was measured as being inundated - - 0: Not applicable (not an aquatic environment) - - 1: Semi-permanent or permanent (> 3 months) - - 2: Temporary or seasonal (< 3 months) - -**Water State** - -Describes whether the detected water is snow, ice or liquid water. Only liquid water is described in this release - - 0: Not applicable (not water) - - 1: Water - -**Intertidal** - -Delineates the intertidal zone - - 0: Not applicable (not intertidal) - - 3: Intertidal zone - -**Water Persistence** - -Describes the number of months a water body contains water - - 0: Not applicable (not an aquatic environment) - - 1: > 9 months - - 7: 7-9 months - - 8: 4-6 months - - 9: 1-3 months - -**Bare Gradation** - -Describes the percentage of bare in naturally bare areas - - 0: Not applicable (not a naturally bare area) - - 10: Sparsely vegetated (< 20 % bare) - - 12: Very sparsely vegetated (20 to 60 % bare) - - 15: Bare areas, unvegetated (> 60 % bare) ::: :::{dropdown} Level 4 @@ -316,7 +246,7 @@ All level 3 and level 4 classes for a given pixel are combined to give a single :::{dropdown} Level 3 Class descriptions **Cultivated Terrestrial Vegetation (CTV)** -Cultivated Terrestrial Vegetation (CTV) is associated with agricultural areas where active cultivation has been observed. In version 1.0 only herbaceous cultivation is shown and describes vegetation of strongly varying cover, ranging from bare (e.g. ploughed) areas to fully developed crops. Whilst the continental product describes land cover, interpretation is complicated as the same terminology is used to report on land use. +Cultivated Terrestrial Vegetation (CTV) is associated with agricultural areas where active cultivation has been observed. In version 2.0 only herbaceous cultivation is shown and describes vegetation of strongly varying cover, ranging from bare (e.g. ploughed) areas to fully developed crops. Whilst the continental product describes land cover, interpretation is complicated as the same terminology is used to report on land use. The definition of cultivated, and the difference to natural or semi-natural land covers, can be contentious particularly as much of the Australian landscape is used for agricultural food production. This includes areas of natural terrestrial vegetation (NTV) and natural aquatic vegetation (NAV) that are grazed by stock and which can be regarded as either semi-natural or cultivated. @@ -332,7 +262,7 @@ Natural Aquatic Vegetation (NAV) is associated primarily with wetlands that are **Artificial Surfaces (AS)** -Artificial Surfaces (AS) are areas of non-vegetated land cover created by human activities and are primarily represented by impervious surfaces (e.g. urban and industrial buildings, roads and railways). These can be more readily identified when the area is larger than the spatial resolution (25 m) provided by the sensor. Open cut extraction sites are often included in AS. However, there is considerable misclassification of NS as AS in areas where vegetated cover is very low and very consistent through the year. +Artificial Surfaces (AS) are areas of non-vegetated land cover created by human activities and are primarily represented by impervious surfaces (e.g. urban and industrial buildings, roads and railways). These can be more readily identified when the area is larger than the spatial resolution (30 m) provided by the sensor. Open cut extraction sites are often included in AS. However, there is considerable misclassification of NS as AS in areas where vegetated cover is very low and very consistent through the year. **Natural Surfaces (NS)** @@ -346,7 +276,7 @@ The Water class captures terrestrial and coastal open water such as dams, lakes, :::{dropdown} Level 4 Class Descriptions **Lifeform (NTV, NAV and CTV; 2 classes)** -Lifeform represents the dominant vegetation type of a primarily vegetated area, discriminating woody from non-woody (herbaceous) vegetation. The Woody Cover Fraction models woody as vegetation of at least 2m in height and at least 20 % canopy cover. Hence the dominant vegetation in areas designated as woody in this product is considered to be composed of shrubs and trees. However where woody vegetation is not dominant in an area, the cover will be essentially herbaceous or bare. Hence some areas containing sparse trees or shrubs will likely be represented as herbaceous. +Lifeform represents the dominant vegetation type of a primarily vegetated area, discriminating woody from non-woody (herbaceous) vegetation. The Woody Cover Fraction models woody as vegetation of at least 20 % canopy cover. Hence the dominant vegetation in areas designated as woody in this product is considered to be composed of shrubs and trees. However where woody vegetation is not dominant in an area, the cover will be essentially herbaceous or bare. Hence some areas containing sparse trees or shrubs will likely be represented as herbaceous. **Vegetation Cover (NTV, NAV and CTV; 5 classes)** @@ -354,7 +284,7 @@ Vegetation cover is defined using the statistics of annual fractional cover of P **Water Seasonality (NAV; 2 classes)** -Water seasonality refers to the typical hydrological conditions in NAV within a year and is relevant to both coastal and inland wetlands. The current implementation utilises the Water Observations from Space (WOfS) dataset, identifying hydro-periods for NAV areas where water is (semi-) permanent (over 3 months) or temporary or seasonal (under 3 months). +Water seasonality refers to the typical hydrological conditions in NAV within a year and is relevant to both coastal and inland wetlands. The current implementation utilises the DEA Water Observations (WO) dataset, identifying hydro-periods for NAV areas where water is (semi-) permanent (over 3 months) or temporary or seasonal (under 3 months). **Water State (Water; 1 class)** @@ -375,21 +305,21 @@ The bare gradation describes the percentage of bare surface in areas which conta ## Lineage -The FAO LCCS taxonomy (Figure 1) is hierarchical and consists of a dichotomous phase (Level 1 to 3) and a modular phase (referred to as Level 4). In Level 1, vegetated and non-vegetated areas are first separated. These are then divided into terrestrial or aquatic categories to form Level 2. In the vegetated terrestrial category, cultivated and natural (including semi-natural) areas are differentiated. The non-vegetated category is further divided into artificial surfaces, and natural surfaces incorporating low vegetation cover and bare areas. Including the non-vegetated aquatic class (from Level 2), this results in the creation of six base land cover categories. +The FAO LCCS taxonomy (Figure 2) is hierarchical and consists of a dichotomous phase (Level 1 to 3) and a modular phase (referred to as Level 4). In Level 1, vegetated and non-vegetated areas are first separated. These are then divided into terrestrial or aquatic categories to form Level 2. In the vegetated terrestrial category, cultivated and natural (including semi-natural) areas are differentiated. The non-vegetated category is further divided into artificial surfaces, and natural surfaces incorporating low vegetation cover and bare areas. Including the non-vegetated aquatic class (from Level 2), this results in the creation of six base land cover categories. -![Diagram showing the portion of the LCCS taxonomy which is implemented in DEA Land Cover v1.0.0](/_files/cmi/cut_back_0.PNG) +![Diagram showing the portion of the LCCS taxonomy which is implemented in DEA Land Cover v1.0.0](/_files/land_cover/cut_back_0.PNG) -*Figure 1 - Diagrammatic representation of the implementation of the FAO LCCS (Version 2) classification within the DEA Land Cover product version 1.0.* +*Figure 2 - Diagrammatic representation of the implementation of the FAO LCCS (Version 2) classification within the DEA Land Cover product version 2.0.* At Level 4, vegetated areas are further classified using information that differentiates lifeform (woody and herbaceous) and quantifies vegetation cover percent and water seasonality (for Natural Aquatic Vegetation). Natural Surface areas have information added (bare gradation) which describes the level of remaining vegetation present (sparse, very sparse or not detectable). Non-vegetated aquatic areas (Water) are further described on the basis of their persistence (hydroperiod) over a calendar year. The FAO LCCS differentiates water in different physical states (liquid or frozen; ice or snow), however only liquid water is included in the current release. -![Diagram showing the data products which go into producing the level 3 classification.](/_files/cmi/level3-dataflow.PNG) +![Diagram showing the data products which go into producing the level 3 classification.](/_files/land_cover/level3-dataflow.PNG) -*Figure 2 - Input data products used to produce Level 3 classification* +*Figure 3 - Input data products used to produce Level 3 classification* -![Diagram showing input data products used to produce the Level 4 classification](/_files/cmi/level4-dataflow.PNG) +![Diagram showing input data products used to produce the Level 4 classification](/_files/land_cover/level4-dataflow.PNG) -*Figure 3 - Input data products used to produce Level 4 classification* +*Figure 4 - Input data products used to produce Level 4 classification* % ## Processing steps @@ -398,6 +328,10 @@ At Level 4, vegetated areas are further classified using information that differ * [https://bitbucket.org/au-eoed/livingearth\_lccs/src/main/](https://bitbucket.org/au-eoed/livingearth_lccs/src/main/) * [https://bitbucket.org/geoscienceaustralia/livingearth\_australia/src/master/](https://bitbucket.org/geoscienceaustralia/livingearth_australia/src/master/) +## Data Structure + +Landcover version 1.0.0, contained several tif files including: waterstt-wat-cat-l4a.tif, watersea-veg-cat-l4a-au.tif, waterper-wat-cat-l4d-au.tif, lifeform-veg-cat-l4a.tif, inttidal-wat-cat-l4a.tif, canopyco-veg-cat-l4d.tif, baregrad-phy-cat-l4d-au.tif. These will not be provided in version 2.0.0 as the classifications will be contained within the level4.tif file, allowing users to filter the results as required. + ## References Lucas R, Mueller N, Siggins A, Owers C, Clewley D, Bunting P, Kooymans C, Tissott B, Lewis B, Lymburner L, Metternicht G. Land Cover Mapping using Digital Earth Australia. *Data*. 2019; 4(4):143. [https://doi.org/10.3390/data4040143](https://doi.org/10.3390/data4040143) diff --git a/docs/data/product/dea-land-cover-landsat/_history.md b/docs/data/product/dea-land-cover-landsat/_history.md index 06c307340..9a291d43d 100644 --- a/docs/data/product/dea-land-cover-landsat/_history.md +++ b/docs/data/product/dea-land-cover-landsat/_history.md @@ -1,2 +1,12 @@ -% ## Changelog +## Changelog +### Version 2.0.0 + +* **Breaking change: Shift in grid origin point** — The south-west origin point of the DEA Summary Product Grid has been shifted 18 tiles west and 15 tiles south. Therefore, all tile grid references have been changed. For instance, a tile reference of `x10y10` has changed to `x28y25`. The tile grid references of all derivative products generated from 2024 onwards will also be changed; however, Analysis Ready Data products will not be affected. +* **Enhanced cloud masking to reduce noise** — An enhancement to cloud masking for input derivative products have reduced cloud and shadow noise. This enhancement (known as 'cloud buffering') involved cleaning cloud masks using a 3-pixel morphological opening on clouds (GeoMAD only) and a 6-pixel dilation on cloud and shadows. Note that some areas of very high surface reflectance (e.g. sand dunes and ocean areas) may exhibit worsened noise or data gaps, but these are infrequent occurrences with low impact. +* **Landsat 9 included** — Landsat 9 is now included from 2022 onwards which achieves better performance than the standalone Landsat 8 product due to using a larger number of available observations +* **Data Structure Changes** — Landcover version 1.0.0, contained several tif files including: waterstt-wat-cat-l4a.tif, watersea-veg-cat-l4a-au.tif, waterper-wat-cat-l4d-au.tif, lifeform-veg-cat-l4a.tif, inttidal-wat-cat-l4a.tif, canopyco-veg-cat-l4d.tif, baregrad-phy-cat-l4d-au.tif. These will not be provided in version 2.0.0 as the classifications will be contained within the level4.tif file, allowing users to filter the results as required. A rgb tif colour representation of the land cover classifications will also no longer be available. Instead a styling sheet will be provided that can be uploaded to your GIS software which will apply the same colour representations of the classfications in the level 3 and 4 tif files. +* **Collection Upgrade** — Landcover version 2.0.0. is based on the latest Landsat Collection 3 Analysis Ready Data. The pixel resolution for Landcover has changed from 25m to 30m resolution. +* **Machine Learning Upgrade** — Machine Learning methods or algorithms settings for woody cover, cultivated vegetation and artificial surfaces classification have been changed to improve performances. The Urban model uses a different ML approach, shifting from a pixel-based to a raster-based method, a new model was trained using Collection 3 data. The Cultivated model maintains the same approach, but the input features were re-engineered using Collection 3 data, and the model was re-trained. The Woody cover model also follows the same approach, with the model re-trained using Collection 3 data. +* **Product ID Upgrade** — The landcover product ID has been updated to reflect the new ARD collection being used. It was changed from ga_ls_landcover_class_cyear_2 to ga_ls_landcover_class_cyear_3 +* **No Data Update** — No data has been updated from 0 to 255 to be consistent with other DEA derivative products diff --git a/docs/data/product/dea-land-cover-landsat/_overview_1.md b/docs/data/product/dea-land-cover-landsat/_overview_1.md index 9a2a5969d..9a883b5d4 100644 --- a/docs/data/product/dea-land-cover-landsat/_overview_1.md +++ b/docs/data/product/dea-land-cover-landsat/_overview_1.md @@ -2,9 +2,8 @@ Digital Earth Australia (DEA) Land Cover translates over 30 years of satellite imagery into evidence of how Australia's land, vegetation and waterbodies have changed over time. -:::{admonition} New version in development +:::{admonition} This version includes breaking changes :class: note -A new version of this product is being developed. Subscribe to the [DEA newsletter](https://communication.ga.gov.au/dea-news-subscribe) to be notified of product releases. +All tile grid references have been changed to refer to a new origin point. Learn more in the [Version 2.0.0 changelog](./?tab=history#v2.0.0). ::: - diff --git a/docs/data/product/dea-land-cover-landsat/_quality.md b/docs/data/product/dea-land-cover-landsat/_quality.md index 34c85048a..f0464c4e1 100644 --- a/docs/data/product/dea-land-cover-landsat/_quality.md +++ b/docs/data/product/dea-land-cover-landsat/_quality.md @@ -1,25 +1,11 @@ -## Accuracy - -The product was validated using 6000 points spatially distributed over Australia. These points were created using a stratified random sampling approach slightly adjusted for oversampling. This process was conducted for 2010 and 2015 creating 12000 samples in total. After removing points with No Data and spurious values the total number was 11750. The sample points were divided into clusters for visual assessment against the outputs from the classification and assessed individually from a pool of 10 people. To compare the individual biases of the individual assessors, an additional set of validation points were created that all assessors evaluated, the results are shown in Table 4. Where assessors could identify a predominant land cover (i.e. not ‘mixed’ pixels or ‘unsure’), all assessors agreed 75 % of the time. - -Table 2 contains the overall accuracy for all classes. The term ‘support’ refers to the number of validation points used in the calculation of that accuracy value. - -![Overall accuracy of DEA Land Cover is 80%. 2010 accuracy is 82%, 2015 accuracy is 78%.](/_files/cmi/overall-accuracy_0.PNG) - -Table 3 contains per-class accuracy information. “Precision” refers to the ability of a classification model to return only relevant instances. “Recall” refers to the ability to identify all relevant instances. The “F1 score” is a combination of precision and recall and an overall measure of accuracy. Classes such as artificial surfaces, natural aquatic vegetation and water had high accuracies. Classifying cultivated terrestrial vegetation and bare surfaces was challenging and accuracies were the lowest of the six classes presented here. - -![Table showing accuracy per class, including precision, recall, F1 score and support values per class. ](/_files/cmi/per-class-accuracy.PNG) - -![table showing the agreement between assessors.](/_files/cmi/inter-assessor-agreement.PNG) - -### Limitations of the Implementation Method +## Limitations of the Implementation Method DEA Land Cover is created by combining multiple layers that each describe features in the landscape. In doing so the extents of each layer do not necessarily completely align, and some no-data points can cross between outputs. As a result, there are some level 4 classes that only report detail to level 3 as the details of cover fraction and water persistence do not have corresponding data in the respective datasets. This specifically relates the classes of Water, NS and NAV in areas near water bodies and the intertidal zone, however the number of affected pixels is small. :::{dropdown} Level 3 Class Limitations **Cultivated Terrestrial Vegetation (CTV)** -Managed plantations and some orchards and tree crops are not currently distinguishable from semi-natural or natural terrestrial vegetation and are not yet incorporated in the area of CTV. Reference can be made to Australia’s National Plantation Inventory. In savanna regions (e.g. Queensland, Northern Territory and Western Australia), variable cycles associated with fires, inundation, drought and rainfall lead to greening or browning of natural vegetation that mirrors the seasonal or management-induced behavior of cultivated land. This leads to some areas of NTV, NS or NAV being misclassified as CTV. For example, the anomalous high levels of rainfall in 2010 led to vegetation growth patterns that were classified as cultivated vegetation, these false positives reduced the precision of the class in that year. Several natural vegetation types, particularly in the monsoonal north, are mapped as CTV due to burning, which can be associated with the indigenous management cycle. Saltmarsh and surface algae on mudflats can also be misclassified. Areas of bare soil exposed for long periods during the agricultural cycle or management activities, and sparse vegetation (when areas are not in use or fallow such as during drought periods) can be assigned as Natural Surfaces (NS). This is particularly the case where areas have experienced low cover for prolonged periods within a year. +Managed plantations and some orchards and tree crops are not currently distinguishable from semi-natural or natural terrestrial vegetation and are not yet incorporated in the area of CTV. Reference can be made to Australia’s National Plantation Inventory. In savanna regions (e.g. Queensland, Northern Territory and Western Australia), variable cycles associated with fires, inundation, drought and rainfall lead to greening or browning of natural vegetation that mirrors the seasonal or management-induced behavior of cultivated land. This leads to some areas of NTV, NS or NAV being misclassified as CTV. For example, the anomalous high levels of rainfall in 2010 led to vegetation growth patterns that were classified as cultivated vegetation, these false positives reduced the precision of the class in that year. Several natural vegetation types, particularly in the monsoonal north, are mapped as CTV due to burning, which can be associated with the indigenous management cycle. Saltmarsh and surface algae on mudflats can also be misclassified. Areas of bare soil exposed for long periods during the agricultural cycle or management activities, and sparse vegetation (when areas are not in use or fallow such as during drought periods) can be assigned as Natural Surfaces (NS). This is particularly the case where areas have experienced low cover for prolonged periods within a year. The CTV machine learning algorithm has not been trained on CTV-woody areas, due to a lack of available training data, therefore leading to possible high rates of misclassification. **Natural Terrestrial Vegetation (NTV)** @@ -27,11 +13,11 @@ The NTV category can transition into the NS category between years when a highly **Natural Aquatic Vegetation (NAV)** -Currently only mangroves are mapped in the NAV class. Other vegetated natural landscapes (e.g. saltmarsh, river red gum forests in the Murray Valley, surface algae and other inland wetlands) where water significantly influences edaphic conditions of substrate are not mapped. This is because, in the current implementation, the water mask is included to assist in the differentiation of vegetation and non-vegetation as the presence of water creates excess noise in the underlying Fractional Cover product. To reduce this noise, the WOfS product is used as a water mask in the Fractional Cover product, and hence it is unlikely to produce the combination of vegetation and water required for the NAV class. +Currently only mangroves are mapped in the NAV class. Other vegetated natural landscapes (e.g. saltmarsh, river red gum forests in the Murray Valley, surface algae and other inland wetlands) where water significantly influences edaphic conditions of substrate are not mapped. This is because, in the current implementation, the water mask is included to assist in the differentiation of vegetation and non-vegetation as the presence of water creates excess noise in the underlying Fractional Cover product. To reduce this noise, the WO product is used as a water mask in the Fractional Cover product, and hence it is unlikely to produce the combination of vegetation and water required for the NAV class. **Artificial Surfaces (AS)** -Misclassification occurs with natural surfaces, particularly in the arid and semi-arid regions, open cut mine sites, salt lakes and pans, sand dunes and beaches. This is attributed to similarities in the variance of spectral signatures over a year. Misclassification occurs in some cultivated areas attributable to the predominance of sparse vegetation or when land is left fallow for most of the year. The current temporal variance mask is 250 m in spatial resolution, compared to the 25 m land cover product, resulting in artefacts appearing in the land cover from the masking process. In addition, urban areas with an area less than 250 m are often excluded. Cloud and data quality issues can lead to incorrect assignment of other land cover classes to AS such as in south-west Tasmania. +The artifical surfaces machine learning algorithm works best in dense urban areas. Misclassification occurs with natural surfaces, particularly in the arid and semi-arid regions, open cut mine sites, salt lakes and pans, sand dunes and beaches. This is attributed to similarities in the variance of spectral signatures over a year. The Australian Bureau of Statistics - Urban Centre and Locality mask is applied to try and remove some of these misclassifications in rural areas. Urban areas with high concentrations of surrounding vegetation, may not be classified as artifical surfaces. Misclassification occurs in some cultivated areas attributable to the predominance of sparse vegetation or when land is left fallow for most of the year. Cloud and data quality issues can lead to incorrect assignment of other land cover classes to AS such as in south-west Tasmania. Within dense urban centers with high-rise buildings such as Sydney or Melbourne CBD, building are misclassified as water due to the shadows of the high rise buildings. In some industrial areas, buildings can be misclassified as no data due to the bright surface reflectance having a similar signature to cloud. **Natural Surfaces (NS)** @@ -39,7 +25,7 @@ Land used for agriculture may be associated with an NS class if ploughing or til **Water** -Areas of artificial and natural water are not differentiated, although the extent of the former is mapped within the existing Bureau of Meteorology Geofabric product. Due to the 25 m pixel size, rivers and water courses that cover less than a pixel, or with highly vegetated riverbanks are not captured, resulting in a patch-like representation of narrower rivers. Areas of dark, wet soil are often misclassified as water, including in cultivated areas and mud flats. +Areas of artificial and natural water are not differentiated, although the extent of the former is mapped within the existing Bureau of Meteorology Geofabric product. Due to the 30 m pixel size, rivers and water courses that cover less than a pixel, or with highly vegetated riverbanks are not captured, resulting in a patch-like representation of narrower rivers. Areas of dark, wet soil are often misclassified as water, including in cultivated areas and mud flats. Some pixels surrounding waterbodies have no classification, due to not valid data from Fractional Cover, and Water Observations being unable to determine if the pixels are wet or dry. Classification of pixels over ocean should not be used from Land Cover (the water persistence is often incorrect, and the land cover classification should be applied to land only pixels). Land Cover product should be used with an ocean mask for coastal tiles. ::: :::{dropdown} Level 4 Class Limitations @@ -53,7 +39,7 @@ The cover of vegetation is derived from the fractional cover product (Scarth et **Water Seasonality** -This product does not yet identify consecutive months but rather the frequency of wet observations in the year, based on the WOfS product. Therefore, monthly statements are unlikely to be consistent across the continent. Mangroves are currently the only consistently identified NAV and water cannot be easily observed beneath their canopies, which are often dense. Hence, the hydroperiod (and hence seasonality metrics) should be treated with some caution. +This product does not yet identify consecutive months but rather the frequency of wet observations in the year, based on the WO product. Therefore, monthly statements are unlikely to be consistent across the continent. Mangroves are currently the only consistently identified NAV and water cannot be easily observed beneath their canopies, which are often dense. Hence, the hydroperiod (and hence seasonality metrics) should be treated with some caution. **Water State** @@ -73,17 +59,107 @@ The intertidal areas carry the limitations of the ITEM product: Bare gradation is produced from the fractional cover product. Unlike the Vegetation Cover class, Bare Gradation is calculated from the median bare fraction, rather than consecutive, monthly green and non-photosynthetic fractions. Hence the bare fraction can be as low as 20 %, however this does not imply that the remaining fraction is healthy vegetation. Rather the remaining fraction is a mix of brown, dead and green vegetation, with intermittent green periods through the year, reflective of arid area vegetation types. ::: -### Earth Observation Limitations +## Earth Observation Limitations -To generate the land cover classification for each calendar year, annual (January – December) statistics derived from Landsat-5, -7 and -8 observations are currently used, with each satellite sensor potentially observing the Australian landscape every 16 days. This brings an intrinsic limitation to land cover mapping as persistent cloud in some regions reduces the number of useable observations. This is particularly evident in Tasmania, and northern Australia during the monsoon period, where areas may not be observed for extended periods and parts or all of the intra-annual land cover cycle may be missed. These limitations can lead to misclassifications of land cover, particularly in dynamic environments. In a future release, a confidence layer will be included to help identify areas with poor observation frequency or other factors impacting the classification. +To generate the land cover classification for each calendar year, annual (January – December) statistics derived from Landsat-5, -7, -8 and -9 observations are currently used, with each satellite sensor potentially observing the Australian landscape every 16 days. This brings an intrinsic limitation to land cover mapping as persistent cloud in some regions reduces the number of useable observations. This is particularly evident in Tasmania, and northern Australia during the monsoon period, where areas may not be observed for extended periods and parts or all of the intra-annual land cover cycle may be missed. These limitations can lead to misclassifications of land cover, particularly in dynamic environments. In a future release, a confidence layer will be included to help identify areas with poor observation frequency or other factors impacting the classification. -An additional limitation of the Landsat series is the availability of data due to the ageing of each satellite. Landsat 5 was operational for over 25 years, but for much of the later years, data were only acquired when sunlight directly illuminated its solar panels. This limited its operation across Australia, with coverage being seasonally dependent, and contracting north to a minimum in winter. In its last years the winter coverage usually only covered the northern coasts of Australia. Landsat 5 ceased regular operations over Australia in 2011, leaving just Landsat 7 until Landsat 8 was launched in 2013. Landsat 7 began service in 1999 as a replacement for Landsat 5. Initially Landsat 5 was switched off, but when Landsat 7 suffered a serious problem in 2003 due to the failure of its scan-line corrector (termed SLC-Off) Landsat 5 resumed service. The SLC-Off failure of Landsat 7 results in severe striping across every image from mid 2003 onwards, apparent in subsequent derived products. Landsat 8 has operated well since launch in 2013, with improved sensitivity, noise characteristics and data correction in comparison to the earlier sensors. +An additional limitation of the Landsat series is the availability of data due to the ageing of each satellite. Landsat 5 was operational for over 25 years, but for much of the later years, data were only acquired when sunlight directly illuminated its solar panels. This limited its operation across Australia, with coverage being seasonally dependent, and contracting north to a minimum in winter. In its last years the winter coverage usually only covered the northern coasts of Australia. Landsat 5 ceased regular operations over Australia in 2011, leaving just Landsat 7 until Landsat 8 was launched in 2013. Landsat 7 began service in 1999 as a replacement for Landsat 5. Initially Landsat 5 was switched off, but when Landsat 7 suffered a serious problem in 2003 due to the failure of its scan-line corrector (termed SLC-Off) Landsat 5 resumed service. The SLC-Off failure of Landsat 7 results in severe striping across every image from mid 2003 onwards, apparent in subsequent derived products. Landsat 8 has operated well since launch in 2013, and Landsat 9 since 2022 with improved sensitivity, noise characteristics and data correction in comparison to the earlier sensors. The result of the availability of the satellites is that the most consistent data availability occurs when two satellites are in operation (most of the 2003 to present period). The least data availability is in 2011 – 2012 when only Landsat 7 was available with data containing the SLC-Off striping issue. The overall data availability for the Landsat satellites is shown in Table 5. The datasets used in this analysis are shown in Table 6. -![table detailing availability of different Landsat satellites since 1986 and any known issues.](/_files/cmi/eo-limitations-table.PNG) +![table detailing availability of different Landsat satellites since 1986 and any known issues.](/_files/land_cover/eo-limitations-table.PNG) + +![datasets within DEA used to provide essential descriptor information](/_files/land_cover/DEA-datasets-used.PNG) + +## Accuracy + +A validation assessment has been undertaken for both the collection 2 (C2) and 3 (C3) versions of Land Cover. The below section outlines the accuracy of both versions to assist users in understanding the differences between the two versions. + +### Summary of differences between Land Cover V1 (collection 2) and V2 (collection 3) + +* Collection 3 shows improvement in both performance and consistency compared to Collection 2 +* Overall improvement in artificial surface classification. More urban areas are now correctly identified, although there is a slight increase in false positive identification of urban areas in the central australian desert, refer to Level 3 - Artificial Surfaces (AS) section above +* Slight improvement is seen in Woody Cover for the Terrestrial Veg and Bare Sfc classifications +* Significant increase in Landsat 7 stripe artefacts, due to Landsat 8 scenes being filtered out by bad geometric quality assessments +* Increase in no data surrounding water bodies, and incorrect classification of water persistence over the ocean + + +| | | | +|---|---|---| +| a) ![Improvement artificial class Degradation water persistence, level 4](/_files/land_cover/2.degr_ocean_water_persistance-degr_stripes-impr_urban.gif) | b) ![Improvement woody cover, level 4](/_files/land_cover/10.improvement-woody_cover_pine_plantation-zoomed-in-level4.gif) | c) ![Degradation cultivated, level 4](/_files/land_cover/11b.example_cultivated_degradation_level4._2015gif.gif) | + +![legend level 4](/_files/land_cover/legend_lc_level4_horizontal.png) + +*Figure 1.* Animations showing examples of differences in level 4 classification between Land Cover V2 and V1. *a)* illustrates the improved artificial surface classification in the greater Melbourne area; stripe artifacts and incorrect water persistence classification can also be observed. *b)* displays a pine plantation near Kinglake West (VIC), which V2 appears to classify correctly as being > 65% woody cover. *c)* shows an example of degradation in cultivated area classification in the Cassowary Coast (northern QLD), primarily due to the misclassification of cultivated land as herbaceous natural vegetation; as mentioned in the limitations, the CTV classification exhibits some inconsistencies, which can occur both spatially and temporally. + + +| | | | +|---|---|---| +| a) ![Degradation false positives artificial, level 3](/_files/land_cover/1.degradation-urban_false_positives-level3.gif) | b) ![Improvement, cultivated better classified, level 3](/_files/land_cover/12b.improvement_cultivated_level3_2015.gif) | c) ![Degradation missing pixels around waterbodies, level 3](/_files/land_cover/9.degradation-missing_pixels_waterbodies-level_3.gif) | + +![legend level 3](/_files/land_cover/legend_lc_level3_horizontal.png) + +*Figure 2.* Animations showing examples of differences in level 3 classification between V2 and V1. *a)* shows Portland (VIC) and the surrounding area, where an improvement in the artificial surface classification in V2 can be observed in the town to the east, although false positives can also be seen on the sandy terrain in the western part of the displayed area. *b)* displays an instance where V2 more accurately identifies cultivated areas in a region on the southern coast of Western Australia, particularly in the northern part of the image, while the eastern part appears slightly noisier. *c)* highlights the increase in pixels with missing values around water bodies in V2 at Lake Eildon in Victoria. + + +### Collection 2 Validation + +The product was validated using 6000 points spatially distributed over Australia. These points were created using a stratified random sampling approach slightly adjusted for oversampling. This process was conducted for 2010 and 2015 creating 12000 samples in total. After removing points with No Data and spurious values the total number was 11750. The sample points were divided into clusters for visual assessment against the outputs from the classification and assessed individually from a pool of 10 people. To compare the individual biases of the individual assessors, an additional set of validation points were created that all assessors evaluated, the results are shown in Table 4. Where assessors could identify a predominant land cover (i.e. not ‘mixed’ pixels or ‘unsure’), all assessors agreed 75 % of the time. + +*Table 2* contains the overall accuracy for all classes. The term ‘support’ refers to the number of validation points used in the calculation of that accuracy value. + +![Overall accuracy of DEA Land Cover is 80%. 2010 accuracy is 82%, 2015 accuracy is 78%.](/_files/land_cover/overall-accuracy_0.PNG) + +*Table 3* contains per-class accuracy information. “Precision” refers to the ability of a classification model to return only relevant instances. “Recall” refers to the ability to identify all relevant instances. The “F1 score” is a combination of precision and recall and an overall measure of accuracy. Classes such as artificial surfaces, natural aquatic vegetation and water had high accuracies. Classifying cultivated terrestrial vegetation and bare surfaces was challenging and accuracies were the lowest of the six classes presented here. + +![Table showing accuracy per class, including precision, recall, F1 score and support values per class. ](/_files/land_cover/per-class-accuracy.PNG) + +![table showing the agreement between assessors.](/_files/land_cover/inter-assessor-agreement.PNG) + +### Collection 3 Validation + +Validation against three data sources was undertaken: validation points reused from collection 2, with the addition of point attributes from Köppen Climate Zone and state/territory, added to facilitate segment analysis, the Blue Glance global dataset of indepenedent 'ground truth' data, and the Land Cover Collection 2 data to understand the extent of change between the versions. + +**Validation Points** +With the addition of validation points, the Collection 2 validation was run again with the following C2 vs C3 comparison results: + +Overall C3 demonstrates greater consistency and more reasonable classification across all time periods and classes than C2. Both C3 and C2 show average degradation in 2010 compared to 2015, a trend that is propagated from Level 1 and ML results. C3 shows slight degradation compared to C2 on the Validation points, with Cultivated Veg and Natural Veg contributing the most to this difference. The Artificial Sfc class has too few points to be considered statistically significant. + +**Validation Points 2010** + +![C2 2010 Accuracy](/_files/land_cover/c3_l3-13.png) + +![C3 2010 Accuracy](/_files/land_cover/c3_l3-14.png) + +![C2 2010 Matrix](/_files/land_cover/c3_l3-15.png) + +![C3 2010 Matrix](/_files/land_cover/c3_l3-16.png) + +**Validation Points 2015** + +![C2 2015 Accuracy](/_files/land_cover/c3_l3-9.png) + +![C3 2015 Accuracy](/_files/land_cover/c3_l3-10.png) + +![C2 2015 Matrix](/_files/land_cover/c3_l3-11.png) + +![C3 2015 Matrix](/_files/land_cover/c3_l3-12.png) + +**GLANCE** + +As expected from the ``Level 1`` and ML validation results, overall C3 performs more consistently across both the Validation points and GLANCE datasets over all time periods compared to C2. The ``Macro-Average`` should be interpreted as "unbiased" due to the highly skewed nature of the Validation points. Since the validity of the Validation points is questionable, the classification metrics should be understood in relative terms showing the difference between C2 and C3, rather than the absolute performance of each. The error propagation from the Level 1, Urban, and Cultivated results is within expected limits. + +**GLANCE 2010** + +![C2 2010 GLANCE C2](/_files/land_cover/c3_l3-19.png) + +![C3 2010 GLANCE C3](/_files/land_cover/c3_l3-20.png) + +**GLANCE 2015** + +![C2 2015 GLANCE C2](/_files/land_cover/c3_l3-17.png) -![datasets within DEA used to provide essential descriptor information](/_files/cmi/DEA-datasets-used.PNG) +![C3 2015 GLANCE C3](/_files/land_cover/c3_l3-18.png) % ## Quality assurance diff --git a/docs/data/product/dea-land-cover-landsat/_tables.yaml b/docs/data/product/dea-land-cover-landsat/_tables.yaml index c1eb640ba..b69e16d72 100644 --- a/docs/data/product/dea-land-cover-landsat/_tables.yaml +++ b/docs/data/product/dea-land-cover-landsat/_tables.yaml @@ -7,7 +7,7 @@ bands_footnote: "For more information on these bands, see the `Description tab < bands_table: - name: level3 aliases: [] - resolution: 25 m + resolution: 30 m nodata: 0 units: null type: uint8 @@ -15,65 +15,8 @@ bands_table: - name: level4 aliases: - full_classification - resolution: 25 m + resolution: 30 m nodata: 0 units: null type: uint8 description: All level 3 and level 4 classes are combined to give a single classification value. - - name: lifeform_veg_cat_l4a - aliases: - - lifeform - resolution: 25 m - nodata: 0 - units: null - type: uint8 - description: Lifeform represents the dominant vegetation type, discriminating woody from non-woody (herbaceous). - - name: canopyco_veg_cat_l4d - aliases: - - vegetation_cover - resolution: 25 m - nodata: 0 - units: null - type: uint8 - description: Vegetation cover describes the percentage of an area that is vegetated rather than bare. - - name: watersea_veg_cat_l4a_au - aliases: - - water_seasonality - resolution: 25 m - nodata: 0 - units: null - type: uint8 - description: Water seasonality identifies where water is permanent (present for over 3 months) or temporary/seasonal (present for under 3 months). - - name: waterstt_wat_cat_l4a - aliases: - - water_state - resolution: 25 m - nodata: 0 - units: null - type: uint8 - description: Water state establishes whether water is present in liquid form or as snow or ice. - - name: inttidal_wat_cat_l4a - aliases: - - intertidal - resolution: 25 m - nodata: 0 - units: null - type: uint8 - description: Intertidal water refers to primarily non-vegetated aquatic areas with systematic tidal water variations. - - name: waterper_wat_cat_l4d_au - aliases: - - water_persistence - resolution: 25 m - nodata: 0 - units: null - type: uint8 - description: Water persistence describes the maximum duration (in months) that water is seen to be covering the surface in the year. - - name: baregrad_phy_cat_l4d_au - aliases: - - bare_gradation - resolution: 25 m - nodata: 0 - units: null - type: uint8 - description: Bare gradation describes the percentage of bare surface in areas which contain sporadic or little persistent green vegetation throughout the year. -