License: The code in this repository is licensed under the Apache License, Version 2.0. Digital Earth Africa data is licensed under the Creative Commons by Attribution 4.0 license.
Contact: For assistance with any of the Python code or Jupyter Notebooks in this repository, please post a Github issue. For questions or more information about this workflow, email [email protected].
To cite:
Bishop-Taylor, R., Nanson, R., Sagar, S., Lymburner, L. (2021). Mapping Australia's dynamic coastline at mean sea level using three decades of Landsat imagery. Remote Sensing of Environment, 267, 112734. Available: https://doi.org/10.1016/j.rse.2021.112734
Bishop-Taylor, R., Sagar, S., Lymburner, L., Alam, I., Sixsmith, J. (2019). Sub-pixel waterline extraction: characterising accuracy and sensitivity to indices and spectra. Remote Sensing, 11 (24):2984. Available: https://doi.org/10.3390/rs11242984
Digital Earth Africa Coastlines is a modified implementation of Digital Earth Australia (DEA) Coastlines, a continental remote sensing method designed to generate annual shorelines and rates of coastal change along the entire Australian coastline from 1988 to the present.
The DEA Coastlines method combines satellite data with tidal modelling to map the typical location of the coastline at mean sea level for each year. The product enables trends of coastal erosion and growth to be examined annually at both a local and continental scale, and for patterns of coastal change to be mapped historically and updated regularly as data continues to be acquired. This allows current rates of coastal change to be compared with that observed in previous years or decades.
The ability to map shoreline positions for each year provides valuable insights into whether changes to our coastline are the result of particular events or actions, or a process of more gradual change over time. This information can enable scientists, managers and policy makers to assess impacts from the range of drivers impacting our coastlines and potentially assist planning and forecasting for future scenarios.
The code in this repository is built on the Digital Earth Africa implementation of the Open Data Cube software for accessing, managing, and analyzing large quantities of Earth observation (EO) data. The code currently runs on the Digital Earth Africa Sandbox infrastructure.
Clone the deafrica-coastlines repository:
git clone https://github.com/digitalearthafrica/deafrica-coastlines.git
DE Africa Coastlines uses the FES2014 tidal model to account for the influence of tide on shoreline positions. To install this tidal model, follow the Setting up tidal models for DE Africa Coastlines guide on the Wiki.
Code in this repository is included in the coastlines Python package which contains three main modules. These are intended to be run in the following order:
-
coastlines.raster: This module conducts raster generation for DEA Coastlines. This analysis is processed on individual study area tiles to minimise peak memory usage.- Load stack of all available Landsat 5, 7 and 8 satellite imagery for a location using ODC Virtual Products
- Convert each satellite image into a remote sensing water index (e.g. MNDWI)
- For each satellite image, model ocean tides into a tidal modelling grid based on exact time of image acquisition
- Interpolate tide heights into spatial extent of image stack
- Mask out high and low tide pixels by removing all observations acquired outside of 50 percent of the observed tidal range centered over mean sea level
- Combine tidally-masked data into annual median composites representing the most representative position of the shoreline at approximately mean sea level each year
-
coastlines.vector: This module conducts vector subpixel coastline extraction and rates of change statistics calculation. This analysis is processed on individual study area tiles to minimise peak memory usage.- Apply morphological extraction algorithms to mask annual median composite rasters to a valid coastal region
- Extract shoreline vectors using subpixel waterline extraction (Bishop-Taylor et al. 2019b)
- Compute rates of coastal change at every 30 m along the coastline using linear regression
-
coastlines.continental: This module combines tiled layers into seamless continental-scale vector files:- Combines multiple output shoreline and rates of change statistics point vectors into single continental datasets
- Aggregates this data to produce moving window coastal change hotspot datasets that summarise coastal change at regional and continental scale.
An interactive walk-through of each step of the tiled raster and vector DEA Coastlines workflow and the continental layer generation is provided in the following Jupyter Notebooks. These notebooks can be run on the DE Africa Sandbox to assist in prototyping or troubleshooting:
- DE Africa Coastlines raster generation
- DE Africa Coastlines vector generation
- DE Africa Coastlines continental hotspots
These three modules have a command-line interface that can be used to automate each stage of the analysis. An example of using these tools is provided in the following Jupyter Notebook:
For help using these command line tools, run:
python -m coastlines.raster --help
python -m coastlines.vector --help
python -m coastlines.continental --help
Files generated by DE Africa Coastlines are exported to the data directory.
Temporary raster and vector outputs produced by coastlines.raster and coastlines.vector for each study area grid cell are exported to:
data/interim/raster/{unique_analysis_name}/{unique_analysis_name}_{study_area_name}
data/interim/vector/{unique_analysis_name}/{unique_analysis_name}_{study_area_name}
Once all study area grid cells have been processed, these are combined into a continental-scale output GeoPackage vector file using coastlines.continental. This final output is exported to:
data/processed/{unique_analysis_name}/coastlines_{continental_version}.gpkg
Tidal modelling is provided by the FES2014 global tidal model. FES2014 was produced by NOVELTIS, LEGOS, CLS Space Oceanography Division and CNES. It is distributed by AVISO, with support from CNES (http://www.aviso.altimetry.fr/).
Global coastal geomorphology data used in the method is available from:
Mao, Y., Harris, D., & Phinn, S. (2022). Global coastal geomorphology dataset based on machine learning methods. The University of Queensland. Data Collection. https://doi.org/10.48610/f60606a
Bishop-Taylor, R., Nanson, R., Sagar, S., Lymburner, L. (2021). Mapping Australia's dynamic coastline at mean sea level using three decades of Landsat imagery. Remote Sensing of Environment, 267, 112734. Available: https://doi.org/10.1016/j.rse.2021.112734
Bishop-Taylor, R., Sagar, S., Lymburner, L., & Beaman, R. J. (2019a). Between the tides: Modelling the elevation of Australia's exposed intertidal zone at continental scale. Estuarine, Coastal and Shelf Science, 223, 115-128. Available: https://doi.org/10.1016/j.ecss.2019.03.006
Bishop-Taylor, R., Sagar, S., Lymburner, L., Alam, I., & Sixsmith, J. (2019b). Sub-pixel waterline extraction: Characterising accuracy and sensitivity to indices and spectra. Remote Sensing, 11(24), 2984. Available: https://doi.org/10.3390/rs11242984
Nanson, R., Bishop-Taylor, R., Sagar, S., Lymburner, L., (2022). Geomorphic insights into Australia's coastal change using a national dataset derived from the multi-decadal Landsat archive. Estuarine, Coastal and Shelf Science, 265, p.107712. Available: https://doi.org/10.1016/j.ecss.2021.107712