Water body detection based on NDWI and the otsu threshold v2.0.0¶

Water bodies detection based on NDWI and otsu threshold applied to Sentinel-2 or Landsat-9 staged acquisitions

This software is licensed under the terms of the Creative Commons Attribution-ShareAlike 4.0 International license - SPDX short identifier: CC-BY-SA-4.0

2022-09-01 - 2026-10-10T21:46:43.796 Copyright EO Application Packaging - > https://github.com/eoap

Project Team¶

Authors¶

Name	Email	Organization	Role	Identifier
Doe, Jane	jane.doe@acme.earth	ACME	N/A	None
Doe, John	john.doe@acme.earth	ACME	N/A	None

Contributors¶

The are no contributors for this project.

Mastering Earth Observation Application Packaging with CWL¶

Mastering Earth Observation Application Packaging with CWL can be found on https://eoap.github.io/mastering-app-package.

Runtime environment¶

Supported Operating Systems¶

The are no Supported Operating Systems specified for this project.

Requirements¶

water-bodies¶

CWL Class¶

Workflow

Requirements¶

Inputs¶

Id	Type	Label	Doc
`aoi`	Polygon: `type`: enum: `Polygon` `coordinates`: `array` of `array` of `array` of double `bbox`: `array` of double	area of interest	GeoJSON Polygon defining the area to crop; raster pixels outside the polygon are masked.
`epsg`	enum: `4326`	EPSG code	EPSG code
`bands`	`array` of enum: `green` `nir` `nir08`	bands used for the NDWI	bands used for the NDWI
`item`	Directory	STAC item reference	Reference to a STAC item

Steps¶

Id	Runs	Label	Doc
node_crop	`#crop`	Crop bands	Crop the selected bands to the area of interest.
node_normalized_difference	`#norm_diff`	Compute NDWI	Compute the normalized difference water index from the cropped bands.
node_otsu	`#otsu`	Detect water bodies	Apply the Otsu threshold to produce a binary water body mask.
node_stac	`#stac`	Catalog results	Create a STAC catalog describing the detected water bodies.

Outputs¶

Id	Type	Label	Doc
`stac_catalog`	Directory	Results STAC catalog	Directory containing the results STAC catalog and its referenced raster assets.

OGC API - Processes¶

When water-bodies Workflow is exposed through OGC API - Processes - Part 1: Core, inputs and outputs fields below represent the interface of the getProcessDescription API.

Inputs¶

Outputs¶

UML Diagrams¶

Activity diagram¶

Learn more about the Activity diagram below.

Component diagram¶

Learn more about the Component diagram below.

Class diagram¶

Learn more about the Class diagram below.

Sequence diagram¶

Learn more about the Sequence diagram below.

State diagram¶

Learn more about the State diagram below.

Run in step¶

node_crop

crop¶

CWL Class¶

CommandLineTool

Inputs¶

Id	Option	Type
`item`	`--input-item`	Directory
`aoi`	`--aoi`	Polygon: `type`: enum: `Polygon` `coordinates`: `array` of `array` of `array` of double `bbox`: `array` of double
`epsg`	`--epsg`	enum: `4326`
`band`	`--band`	enum: `green` `nir` `nir08`

Execution usage example:¶

crop \
--input-item <ITEM> \
--aoi <AOI> \
--epsg <EPSG> \
--band <BAND>

Run in step¶

node_normalized_difference

norm_diff¶

CWL Class¶

CommandLineTool

Inputs¶

Id	Option	Type
`rasters`	`--rasters`	`array` of File

Execution usage example:¶

norm_diff \
--rasters <RASTERS>

Run in step¶

node_otsu

otsu¶

CWL Class¶

CommandLineTool

Inputs¶

Id	Option	Type
`raster`	`--raster`	File

Execution usage example:¶

otsu \
--raster <RASTER>

Run in step¶

node_stac

stac¶

CWL Class¶

CommandLineTool

Inputs¶

Id	Option	Type
`item`	`--item`	Directory
`rasters`	`--rasters`	File

Execution usage example:¶

stac \
--item <ITEM> \
--rasters <RASTERS>