![](\"../Supplementary_data/dea_logo.jpg\"){kind=logo}
\n",
+ "\n",
+ "![\"DEA](\"https://raw.githubusercontent.com/GeoscienceAustralia/dea-notebooks/stable/Supplementary_data/dea_logo_wide.jpg\"){kind=logo}
\n",
+ "\n",
+ "Introduction to DEA Water Observations
\n", + "\n", + "\n", + "๐ Visit DEA's Knowledge Hub for detailed technical information about the datasets and concepts used in this notebook.\n", + "
\n", + "\n", + "\n", + "๐ก Intermediate\n", + "โก Time to complete: ~10 mins\n", + "๐๏ธ Updated: 2025-12\n", + "
\n", + "\n", + "\n", + "\n",
+ "๐ฆ Products used
\n", + "ga_ls_wo_3 \n", + "
\n",
+ "\n",
+ "\n",
+ "\n", + "ga_ls_wo_3 \n", + "
\n",
+ "๐งพ Prerequisites
\n", + "Optional list of prerequisite notebooks or background knowledge, e.g. Run the XYZ notebook before running this. #FIXME check if these are necessary\n", + "
\n",
+ "\n",
+ "\n",
+ "\n", + "Optional list of prerequisite notebooks or background knowledge, e.g. Run the XYZ notebook before running this. #FIXME check if these are necessary\n", + "
\n",
+ "๐ Citation
\n", + "Please cite:\n", + "Mueller, N., Lewis, A., Roberts, D., Ring, S., Melrose, R., Sixsmith, J., Lymburner, L., McIntyre, A., Tan, P., Curnow, S., & Ip, A. (2016)\n", + "https://doi.org/10.1016/j.rse.2015.11.003 \n", + "Remote Sensing of Environment, 174, 341โ352. when using the results of this notebook. \n", + "
\n",
+ "\n",
+ "\n", + "Please cite:\n", + "Mueller, N., Lewis, A., Roberts, D., Ring, S., Melrose, R., Sixsmith, J., Lymburner, L., McIntyre, A., Tan, P., Curnow, S., & Ip, A. (2016)\n", + "https://doi.org/10.1016/j.rse.2015.11.003 \n", + "Remote Sensing of Environment, 174, 341โ352. when using the results of this notebook. \n", + "
\n",
+ "โ ๏ธ Important
\n", + "This notebook is not to be used for safety of life decisions.\n", + "
\n",
+ "\n",
+ "\n",
+ "\n", + "This notebook is not to be used for safety of life decisions.\n", + "
\n",
+ "๐ How you can run this notebook
\n", + "\n", + "- DEA Sandbox: Eligible users can sign up for the DEA Sandbox that provides free compute and a managed Python environment.\n", + "\n", + "- Personal computer: This notebook loads DEA data using![\"Open](\"https://img.shields.io/badge/Codespaces-Open-blue?logo=github\")
\n",
+ " \n",
+ "
\n",
+ "\n",
+ "\n", + "\n", + "- DEA Sandbox: Eligible users can sign up for the DEA Sandbox that provides free compute and a managed Python environment.\n", + "\n", + "- Personal computer: This notebook loads DEA data using
odc-stac. Data streams via the internet, so can be run locally after installing the required DEA Tools Python package, e.g. pip install dea-tools[notebooks].\n",
+ "\n",
+ "- Run this notebook online: Click on the badge below to launch a GitHub Codespaces instance to run the notebook from your browser. See this wiki page for more information.\n",
+ "\n",
+ " \n",
+ " \n",
+ " \n",
+ "![\"A](\"../Supplementary_data/DEA_Water_Observations/WO_screenshot_06112025_lakeGeorge.PNG\")
"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "*A single Water Observation observed by the Landsat satellite constellation and classified using the Water Observations from Space algorithm (Mueller et al 2016), taken on November the 6th 2025. The image shows different classifications for where water was observed, where there were clouds, and where there was terrain, as in the description of the data further down this notebook.The area of the image is a strip selected across the Landsat scene, capturing an area of Australia on the eastern coast and including Lake George/Weereewa in the state of New South Wales, in which water was observed at this time*"
]
},
{
@@ -17,36 +85,45 @@
"metadata": {},
"source": [
"## Background\n",
- "It is important to know where water is normally present in a landscape, where water is rarely observed, and where inundation has occasionally occurred.\n",
- "\n",
- "These observations tell us where flooding has occurred in the past, and allows us to understand wetlands, water connectivity and surface-groundwater relationships. This can lead to more effective emergency management and risk assessment.\n",
+ "This notebook demonstrates **individual Water Observations (WOs)** \n",
+ "This product shows where surface water was observed by the Landsat satellites on any **particular day where there was a satellite image** since mid 1986. These **single-observation** data layers are termed Water Observations (WOs).\n",
"\n",
- "This is the principal [Digital Earth Australia (DEA) Water Observations product](https://knowledge.dea.ga.gov.au/data/product/dea-water-observations-landsat) (previously known as Water Observations from Space), providing the individual water observations per satellite image that are subsequently used in the following DEA Water Observations suite and related water bodies products. \n",
"\n",
- "This product shows where surface water was observed by the Landsat satellites on any particular day since mid 1986. These daily data layers are termed Water Observations (WOs).\n",
+ "It is important to know where water is normally present in a landscape, where water is rarely observed, and where inundation has occasionally occurred.\n",
+ "These observations tell us where flooding has occurred in the past, and allows us to understand wetlands, water connectivity and surface-groundwater relationships. This can lead to more effective emergency management and risk assessment.\n",
"\n",
+ "This is the **principal** [Digital Earth Australia (DEA) Water Observations product](https://knowledge.dea.ga.gov.au/data/product/dea-water-observations-landsat) **providing the individual water observations per satellite image** that are subsequently **used in the following DEA water products**: \n",
+ "* Water Observations Summary statistics products: [DEA Water Observations Statistics (Landsat)](https://knowledge.dea.ga.gov.au/data/product/dea-water-observations-statistics-landsat/)\n",
+ "* [DEA Waterbodies (Landsat)](https://knowledge.dea.ga.gov.au/data/product/dea-waterbodies-landsat/)\n",
+ "* [DEA Wetlands Insight Tool](https://knowledge.dea.ga.gov.au/data/category/dea-wetlands-insight-tool/)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
"### What this product offers\n",
"DEA Water Observations provides surface water observations derived from Landsat satellite imagery for all of Australia from 1986 to present.\n",
- "\n",
"The WOs show the extent of water in a corresponding Landsat scene, along with the degree to which the scene was obscured by clouds, shadows or where sensor problems cause parts of a scene to not be observable. \n",
"\n",
"### Applications\n",
- "The DEA Water Observations (WOs) are used to determine the area of surface water present in the corresponding satellite scene, and can be used for several water monitoring applications. Uses of the individual WOs include:\n",
+ "The DEA Water Observations (WOs) are used to indicate whether surface water was observed in the corresponding satellite scene, and can be used for several water monitoring applications. Uses of the individual WOs include:\n",
"\n",
- "* flood extent\n",
- "* amount of water in water bodies, major rivers and the coastal zone.\n",
+ "* seeing if water was detected in a particular location at that time\n",
+ "* comparing two different times to see if water had similar detected extents\n",
"\n",
- "As the WOs are separated from the derived statistics of the associated DEA Water Observations statistical products, the WOs are most useful for performing analyses requiring the investigation of surface water extent for particular times rather than over long term time series.\n",
+ "These single WOs are most useful for performing analyses requiring the investigation of surface water extent for particular times rather than over long term time series. Other statistical products can be used to summarise the behaviour of surface water over the long term e.g. [DEA Water Observations Statistics (Landsat)](https://knowledge.dea.ga.gov.au/data/product/dea-water-observations-statistics-landsat/) which is made out of the single WOs.\n",
"\n",
"### Publications\n",
- "* Mueller, N., Lewis, A., Roberts, D., Ring, S., Melrose, R., Sixsmith, J., Lymburner, L., McIntyre, A., Tan, P., Curnow, S., & Ip, A. (2016). [Water observations from space: Mapping surface water from 25 years of Landsat imagery across Australia](https://doi.org/10.1016/j.rse.2015.11.003). Remote Sensing of Environment, 174, 341โ352. \n"
+ "* For more information check out the DEA Knowledge Hub information on this product: [DEA Water Observations Statistics (Landsat)](https://knowledge.dea.ga.gov.au/data/product/dea-water-observations-landsat/)\n",
+ "* Mueller, N., Lewis, A., Roberts, D., Ring, S., Melrose, R., Sixsmith, J., Lymburner, L., McIntyre, A., Tan, P., Curnow, S., & Ip, A. (2016). [Water observations from space: Mapping surface water from 25 years of Landsat imagery across Australia](https://doi.org/10.1016/j.rse.2015.11.003). Remote Sensing of Environment, 174, 341โ352. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
- "## Description\n",
+ "## Description ##FIXME update to stac\n",
"This notebook will demonstrate how to load and analyse DEA Water Observations using Digital Earth Australia, including:\n",
"\n",
"1. Inspecting the products and measurements available in the datacube\n",
@@ -67,15 +144,8 @@
"cell_type": "markdown",
"metadata": {},
"source": [
- "## Getting started\n",
+ "## Setup\n",
"\n",
- "To run this analysis, run all the cells in the notebook, starting with the \"Load packages\" cell. "
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
"### Load packages\n",
"Import Python packages that are used for the analysis."
]
@@ -86,23 +156,28 @@
"metadata": {},
"outputs": [],
"source": [
- "import datacube\n",
- "from datacube.utils import masking\n",
+ "import odc.stac\n",
+ "import pystac_client\n",
+ "import xarray as xr\n",
+ "\n",
"import matplotlib.pyplot as plt\n",
+ "from odc.geo import BoundingBox\n",
+ "from dea_tools import masking ##FIXME\n",
"\n",
- "import sys\n",
- "sys.path.insert(1, '../Tools/')\n",
- "from dea_tools.datahandling import wofs_fuser\n",
- "from dea_tools.plotting import plot_wo"
+ "from dea_tools.datahandling import dea_stac_cfg, stac_assets, stac_collections, wofs_fuser #not sure if wofs_fuser is working yet ##FIXME\n",
+ "from dea_tools.plotting import plot_wo\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
- "### Connect to the datacube\n",
+ "### Connect to DEA's STAC API\n",
"\n",
- "Connect to the datacube so we can access DEA data."
+ "This allows us to search for data using DEA's STAC API (refer to the [SpatioTemporal Asset Catalogue guide](https://knowledge.dea.ga.gov.au/guides/setup/gis/stac/) or [Loading data with STAC notebook](../Beginners_guide/04a_Loading_data_STAC.ipynb) for details).\n",
+ "\n",
+ "To load data, we must also configure access to DEA's Amazon S3 buckets using `odc.stac.configure_s3_access`.\n",
+ "If launching a Dask client (e.g. `dea_tools.dask.create_local_dask_cluster()`), this is done automatically."
]
},
{
@@ -111,18 +186,33 @@
"metadata": {},
"outputs": [],
"source": [
- "dc = datacube.Datacube(app='DEA_Water_Observations')"
+ "# Configure data access\n",
+ "odc.stac.configure_s3_access(cloud_defaults=True, aws_unsigned=True)\n",
+ "\n",
+ "# Connect to STAC API\n",
+ "catalog = pystac_client.Client.open(\"https://explorer.dea.ga.gov.au/stac\")"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
- "## Available products and measurements\n",
+ "## Analysis\n",
+ "\n",
+ "### Analysis Parameters\n",
"\n",
- "### List products available in Digital Earth Australia\n",
- "We can use datacube's `list_products` functionality to inspect DEA Water Observations products that are available in Digital Earth Australia.\n",
- "The table below shows the product name that we will use to load data, and a brief description of the product."
+ "First we need to define the location, time period and DEA product we want to load.\n",
+ "\n",
+ "In this example, we will load a ##FIXME"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "### Available products\n",
+ "\n",
+ "We can use the `stac_collections` function to inspect the DEA Landsat Surface Reflectance products that are available in DEA's STAC catalog:"
]
},
{
@@ -151,14 +241,14 @@
" \n",
"