scl3/task_hii_water
Earth Engine task for calculating water driver
164
This task calculates the impact of navigable waterways on the terrestrial surface as one of the key drivers for a combined Human Impact Index. "Impact" is a pressure score based on proximity to a navigable waterway. Coasts, wide rivers and lakes are considered navigable if they meet key criteria related to the distance from a population center (for coastlines including that of the Caspian Sea) or based on width and connectivity (inland waters). These methods are adapted from the logic followed by Venter et al. 2016). The output HII driver calculated by this task is, like all other HII drivers, unitless; it refers to an absolute 0-10 scale but is not normalized to it, so the actual range of values may be smaller than 0-10.
Inland navigable waterways are based on cells in the Global Surface Water (GSW) dataset with occurrence values greater than or equal to 40. These waters are considered navigable if they have a minimum width of 30 m and are connected to at least 1024 pixels meeting the minimum width threshold. Navigable coastlines are defined as coastal areas within 80 km from coastal settlements. Coastal settlements are any areas with population densities greater than or equal to 10 people/sq km within 4 km of a coastline.
The impact on the terrestrial surface of these navigable waterways is calculated using an exponential decay function from 0 to 15 km from the waterway. This is calculated as:
influence = e^(distance * decay_constant) * indirect_weight
Ocean waters are a combination of all cells with a value of 0 from the static ESA landcover water bodies data
ingested into Earth Engine from
ftp://geo10.elie.ucl.ac.be/v207/ESACCI-LC-L4-WB-Ocean-Land-Map-150m-P13Y-2000-v4.0.tif
(Lamarche C, Santoro M, Bontemps S, D’Andrimont R, Radoux J, Giustarini L, Brockmann C, Wevers J, Defourny P, Arino O. Compilation and Validation of SAR and Optical Data Products for a Complete and Global Map of Inland/Ocean Water Tailored to the Climate Modeling Community. Remote Sensing. 2017; 9(1):36. https://doi.org/10.3390/rs9010036) combined with the (static) Caspian Sea image ingested from the vector data downloaded from
https://maps.princeton.edu/catalog/stanford-zb452vm0926
The Caspian Sea is thus analyzed in this task in terms of coastal access, rather than inland navigation.
The source data for inland water is the
Joint Research Centre Global Surface Water (GSW) product
available within Earth Engine at JRC/GSW1_1/GlobalSurfaceWater
. Documentation is available at
Jean-Francois Pekel, Andrew Cottam, Noel Gorelick, Alan S. Belward, High-resolution mapping of global surface water and its long-term changes. Nature 540, 418-422 (2016). [doi:10.1038/nature20584] and an accompanying Data Users Guide.
The source population density cells are derived from the WoldPop Population Data dataset developed by WorldPop. This dataset models the distribution of the global human population annually beginning in 2000 at a spatial resolution of 100 m. As a class property of HIITask the original dataset values are converted from the number of people per 100m x 100m grid cell to actual population density of people/sq km.
SERVICE_ACCOUNT_KEY=<GOOGLE SERVICE ACCOUNT KEY>
scale = 300
SETTLEMENT_DISTANCE_FROM_COAST = 4000 # meters
COASTAL_SETTLEMENT_POPULATION_DENSITY = 10
COASTAL_NAVIGATION_DISTANCE = 80000 # meters
OCEAN_BUFFER_DISTANCE = 300 # meters
GSW_OCCURRENCE_THRESHOLD = 40
WIDE_RIVER_MIN_WIDTH = 30 # meters
GSW_CONNECTED_PIXEL_MIN = 1024 # pixels
INDIRECT_DISTANCE = 15000 # meters
DECAY_CONSTANT = -0.0003
INDIRECT_INFLUENCE = 10
/app # python task.py --help
usage: task.py [-h] [-d TASKDATE] [--overwrite]
optional arguments:
-h, --help show this help message and exit
-d TASKDATE, --taskdate TASKDATE
--overwrite overwrite existing outputs instead of incrementing
Copyright (C) 2022 Wildlife Conservation Society The files in this repository are part of the task framework for calculating Human Impact Index and Species Conservation Landscapes (https://github.com/SpeciesConservationLandscapes) and are released under the GPL license: https://www.gnu.org/licenses/#GPL See LICENSE for details.
docker pull scl3/task_hii_water