Skip to main content

Churchill River Flood Forecasting System

Subset of the River Ice Classification Data.


File Provider (EO Team)#

Product Description#

Information required from the file provider for product development.

Service NameDescriptionData OwnersFile Type
River IceRiver Ice classification of SAR dataPradeep, Kelley, Mike.shp
(shapefile)

Ancilliary Information#

  • Product set-up prerequisites:
    • Masking template shapefile

Naming Convention#

The following naming convention applies to all River Ice Classification files sent to Coresight:

YYYY-MM-DD_RRR_ PPP_SS.jpg
YYYY - Year
MM - Month
DD - Day
RRR - River
PPP – Products (Ice Cover ICOV, Ice Classification CLS, Change Detection CHG)
SS - Sensor

Example:

2020-03-02_CHU_CLS_R2.shp

Symbology Map#

River ice classification is the categorization of backscatter into one of 4 classes during the breakup season vs. 3 classes during the regular season (class 32 removed). Classes are defined as:

LabelColorGridcode Value
Open water#004D9531
Wet ice or pooling water on ice#60C0F3 32
Smooth ice#FDFA00 33
Rough ice#EB3D00 34

File Uploading Instructions#

Example Input Image#

Example shapefile uploaded to Coresight cloud storage.

River Ice Classification Input


Coresight#

Developers#

  • Jeremy Hetzel
  • Chris Boyce.

Processing#

Description#

Data processing takes place using an ingester that imports, converts, creates and stores files.

Ingester Script#

The bulk of the ingestion work on each file is done in the cloud and the script can be found in the river-ice-ingester repository.

Ingester Functions#

  • File clipping - masking geometric data within shapefiles
  • File conversion - shapefile to geoJSON to MapBox Vector Tiles
  • File storage - Vector Tiles and geoJSON files on AWS cloud storage
  • STAC item creation - Automatic naming based on date, product type and AOI matching.
  • STAC catalog:
    • Automatic STAC item sorting based on item name.
    • Automatic storage in a Firestore collection based on product type and AOI matching.
  • Notification - emails developers upon product publication.

Real time API Access#

The FastAPI OpenAPI endpoint for the river-ice-ingester can be found here.

Service Interface#

  • River Ice Web interfaces:

    • Retrieves product information through the firestore collection.
    • Displays the most recent satellite ice classification analysis.
  • Churchill River Flood Forecasting System on the Churchill interface (figure below):

    • The upper left graphic displays all of the image analysis dates for a particular ice season.
    • The date fields can be used to select seasons, month, and day.
    • The upper left graphic also displays ice cover types and area percentages.
    • The bottom right area of the map shows the ice classification legend.
    • Not all ice types will be displayed with all classification dates.
    • Various map elements are included such as river segment numbers, place names, hydrometric and climate data stations, and scale bar.
    • The upper right toolbar allows the user to switch between the ice classification and the change detection layers.

CRFFS Product