Merge pull request #47 from digitalearthafrica/session-6

Session 6 content

docs/index.rst

@@ -32,8 +32,7 @@ Should you require help, see the :doc:`Frequently_asked_questions` and :doc:`Con
    session_3/index
    session_4/index
    session_5/index
-
-Session 6 will be added shortly.
+   session_6/index
 
 Latest Updates
 -------------------

docs/session_6/01_intro_water_analyses.ipynb

@@ -0,0 +1,239 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Introduction to water analyses"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Overview"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In the [last session](../session_5/02_vegetation_exercise.ipynb), we learned how to construct a complete case study, focusing on vegetation. In this session, we will  look at another vital resource — water. Using the same case study techniques, we will construct a new case study focusing on water. This includes learning to use the Water Observations from Space (WOfS) dataset."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## The significance of water"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img align=\"middle\" src=\"../_static/session_6/01_intro_water_water.PNG\" alt=\"Drought in Cape Town in 2018.\" width=\"500\">"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "*Water is a key concern across the African continent. Many countries are experiencing extreme conditions, such as drought or floods. Water case study analyses can pave the way towards data-driven policy and mitigation strategies.* [[Image source](https://www.aljazeera.com/news/2018/01/16/cape-town-confronts-looming-day-zero-water-crisis/)]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "There are many useful analyses that involve water, such as:\n",
+    "\n",
+    "* Detection of drought\n",
+    "* Flood modelling and prediction\n",
+    "* Mangrove analysis: mangroves can lessen damage from water surges such as those from storms and tsunamis\n",
+    "* Detection of coastal erosion\n",
+    "* Reporting for indicators in the United Nations (UN) Sustainable Development Goals (SDGs) that involve water. For example, [Goal 6](https://sdgs.un.org/goals/goal6) is about water and sanitation. Some example indicators that the Open Data Cube can facilitate reporting for include: \n",
+    "    1. Indicator 6.3.2: Proportion of bodies of water with good ambient water quality\n",
+    "    1. Indicator 6.6.1: Change in the extent of water-related ecosystems over time"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Real world example notebooks"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "There are several notebooks in the Digital Earth Africa Sandbox that analyse water bodies. These case study notebooks can be found in the Sandbox folder called **Real_world_examples**. \n",
+    "\n",
+    "The **Real_world_examples** folder contains many case studies; the notebooks related to water are summarised below."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "* `Chlorophyll_monitoring.ipynb`\n",
+    "\n",
+    "This notebook monitors chlorophyll-a in water bodies using Sentinel-2 data. Chlorophyll-a can indicate the presence of algal blooms, and monitoring this with satellite imagery can provide insights into water quality. The notebook plots the value of the Normalised Difference Chlorophyll Index (NDCI) along with water body area to understand how the presence of clorophyll-a changes with time."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "* `Coastal_erosion.ipynb`\n",
+    "\n",
+    "This notebook monitors coastal erosion with Landsat 8 data. Using satellites to monitor coastal change over large areas can be a cost-effective method of tracking change and preempting infrastructure needs. This notebook extracts shorelines from composite measures of the Modified Normalised Difference Water Index (MNDWI) and plots how they change from year to year."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "* `Intertidal_elevation.ipynb`  \n",
+    "\n",
+    "This notebook models tides with Landsat 5, 7, and 8 data. By examining the presence of water between low and high tide, the notebook builds up a 3D elevation map of inter-tidal zones such as sandy beaches and rocky shores."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "* `Radar_water_detection.ipynb`\n",
+    "\n",
+    "This notebook detects water using Sentinel-1 data. Sentinel-1 is a radar satellite, which is unaffected by cloud cover. This allows the detection of water in cloudy conditions, such as during heavy rain events."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "* `Water_extent.ipynb` \n",
+    "\n",
+    "This notebook determines the extent of water bodies using the WOfS dataset, which is derived from Landsat data. This notebook relates to Sustainable Development Goals around the spatial extent of water systems, such as UN SDG Indicator 6.6.1. This is an important first step in monitoring the change of water systems over time.\n",
+    "\n",
+    "The exercise in this session, Session 6, will contain instructions to create a similar notebook."
+   ]
+  },
+  {
+   "cell_type": "raw",
+   "metadata": {
+    "raw_mimetype": "text/restructuredtext"
+   },
+   "source": [
+    ".. note::\n",
+    "    It is recommended you open these notebooks in the Sandbox, from the folder called **Real_world_examples**. This will allow you to run the pre-prepared code for yourself. However, they can also be viewed at the `Digital Earth Africa notebook repository <https://github.com/digitalearthafrica/deafrica-sandbox-notebooks/tree/master/Real_world_examples>`_, which will display a read-only HTML version from GitHub."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Water detection with WOfS"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img align=\"middle\" src=\"../_static/session_6/01_intro_water_wofs.png\" alt=\"Example of WOfS over Senegal.\" width=\"500\">"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "*An example of the Water Observations from Space (WOfS) dataset over Senegal.*"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "While we can detect water using band indices, Digital Earth Africa provides the Water Observations from Space (WOfS) dataset. The algorithm that generates this dataset has been trained to detect water in Landsat 8 imagery. You can learn more about WOfS and its algorithm by accessing the **Datasets** folder on the Sandbox, and double-clicking the `Water_Observations_from_Space.ipynb` notebook to open it.\n",
+    "\n",
+    "There are several WOfS products available through the Digital Earth Africa Sandbox. They can be used for analysis in the same way we have been loading and using Landsat and Sentinel satellite products. We summarise two WOfS products below &mdash; **feature layers** and **annual summary**."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Feature layers\n",
+    "\n",
+    "The base product for WOfS is the feature layers product, [ga_ls8c_wofs_2](https://explorer.digitalearth.africa/ga_ls8c_wofs_2). It has a single measurement called `water`, which indicates how the algorithm classifies each pixel in the image. `water=0` means a dry pixel, and `water=128` is a water pixel.\n",
+    "\n",
+    "There are a few different classifications for other types of pixels, such as cloud. These are also mapped to unique values.\n",
+    "\n",
+    "* `water=128` - Water\n",
+    "* `water=64` - Cloud\n",
+    "* `water=0` - Dry"
+   ]
+  },
+  {
+   "cell_type": "raw",
+   "metadata": {
+    "raw_mimetype": "text/restructuredtext"
+   },
+   "source": [
+    ".. note::\n",
+    "    Don't worry if this seems confusing, or you're not sure how to use this to find water in an image. We'll cover this during the exercise on the next page. If you want to read more about feature layers, open the **Frequently_used_code** folder on the Sandbox, then double-click the **Applying_WOfS_bitmasking.ipynb** notebook to open it."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Annual summary\n",
+    "\n",
+    "Digital Earth Africa also has an annual summary WOfS product called [ga_ls8c_wofs_2_annual_summary](https://explorer.digitalearth.africa/ga_ls8c_wofs_2_annual_summary). This product records how often a pixel was classified as water in a given year. This is useful for comparing the presence of water over different years. The WOfS annual summary dataset contains three measurements:\n",
+    "\n",
+    "* `count_wet`: The number of times a given pixel was wet during the year.\n",
+    "* `count_clear`: The number times a given pixel was clear (not cloudy) during the year. A clear pixel could be either wet or dry.\n",
+    "* `frequency`: The ratio of `count_wet` to `count_clear`, which describes the percentage of time a pixel was wet out of all the times it could be seen during the year."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Conclusion"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "With a rapidly changing climate, it is incredibly important to be able to understand and analyse water resources. This can easily be done in the Digital Earth Africa Sandbox, which allows access to satellite datasets and products such as WOfS.\n",
+    "\n",
+    "In the next section, we will see how to construct a case study investigating water extent using WOfS."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}