FPM - Flood Proxy Maps

lar2fpm

This repository contains jobs to convert S1-LAR products to Flood Proxy Maps based on thresholds input by user:

Associated job:

Job 1: S1 FPM

  • Type: Iterative

  • Facet: S1-LAR

  • User inputs:

Fields

Description

Type

Example

Fields

Description

Type

Example

thr_opn

threshold for open-water (negative value)

float

-0.2

thr_veg

threshold for veg-flood (positive value)

float

0.2

bw_area_opn

bwarea pixels to remove open water artefacts, comma seperated for: small_flooded_areas, small_dry_areas_in_flood

int,int

50,50

bw_area_veg

bwarea pixels to remove veg-flood artefacts, comma seperated for: small_flooded_areas, small_dry_areas_in_flood

int,int

50,50

apply_wmask

if watermask is to be applied on final FPMs

boolean

true

  • Important outputs:

Product

Description

Example

Product

Description

Example

Flood Proxy Map

Geotiff of flood pixels (burstwise and merged)

N_s*_fn_o*_v*_fpm.tif

Log Ratio

Geotiff of logratio - log(Aco/Apre) merged across bursts

N_s*_fn_o*_v*_logra2a1.tif
N_s*_fn_o*_v*_logra2a1_msk.tif - masked footprint
N_s*_fn_o*_v*_logra2a1_wbdmsk.tif - masked waterbody

Masks

Geotiff of masked footprint and waterbody (if apply_wmask selected)

N_s*_fn_o*_v*_msk.tif
N_s*_fn_o*_v*_wbdmsk.tif

DEMs

DEM of subswath area

demLat_N*_N*_Lon_W*_W*.dem.vrt

KMLs

KML of radar footprint and FPMs (burst-wise, untiled)

*See merge_anything.py for tiled KMLs

*.kml

Job 2: S1 FPM Packaged

  • Type: Individual

  • Facet: S1-FPM
    (FPM sub-swaths user would like to merge and package)

  • User inputs:

Fields

Description

Type

Example

Fields

Description

Type

Example

product_name

Name of the packaged product, ideal to indicate area and event date

str

EOS_ARIA-SG_FPM_20190812_MyanmarFloods

fpm_include_glob

comma seperated list of glob pattern for fpm files to include

str

./S1-FPM*/*_fpm.tif OR
./S1-FPM*_s3-*/N_s*_0[1-3]_o*_fpm.tif
(include subswath 3, bursts 1 - 3)

fpm_exclude_glob

comma seperated list of glob pattern for fpm files to exclude

str

  • fn*

 OR

  • fn*,./S1-FPM*/N_s*_0[8-9]*_fpm.tif

(exclude all bursts 8 - 9, and fn)

footprint_include_glob

comma seperated list of glob pattern for footprint mask files to include to make radar footprint kml

str

./S1-FPM*/*_msk.tif OR
./S1-FPM*_s3-*/N_s*_0[1-3]_o*_msk.tif
(include subswath 3, bursts 1 - 3)

footprint_exclude_glob

comma seperated list of glob pattern for footprint mask files to exclude to make radar footprint kml

str

  • fn*

 OR

  • fn*,./S1-FPM*/N_s*_0[8-9]*_msk.tif

(exclude all bursts 8 - 9, and fn)

kml_tile_url

http url where kml tiles of FPM are hosted (currently only supports s3 static website urls), if not specified, uses current s3 product bucket to host tiles

str

http://aria-sg-products.s3-website-ap-southeast-1.amazonaws.com/tiles/

kml_zoom

zoom levels of the kml tiles of FPM in the format: min-max. Check for details of resolution vs zoom level.

str

6-13
(20m resolution)

 

  • Important outputs:

Product

Description

Example

Product

Description

Example

Merged Flood Proxy Map GTiff

Geotiff of flood pixels

final_fpm.tif

Merged Flood Proxy Map Shp

Shapeifle of flood pixels (zipped)

final_fpm_shp.zip

Radar foorprint KML

KML of radar footprint (merged, dissolved) of selected mask files

final_kml/radar_footprint_fn.kml

Merged Flood Proxy KML

KML of radar footprint (merged, dissolved) of selected mask files

final_kml/<product_name>_<date>_<time>.kml

KMLs

KML of radar footprint and FPMs (burst-wise, untiled)

*See merge_anything.py for tiled KMLs

*.kml