/viirs_ba

Python code for burned area estimation using VIIRS scenes.

Primary LanguagePythonCreative Commons Zero v1.0 UniversalCC0-1.0

viirs_ba

Python

The Python script is “VIIRS_threshold_reflCor_Bulk.py” which drives all processes. Thresholds and other parameters are loaded using an initialization file (*.ini) that is provided as an argument at script execution (e.g., c:\VIIRS_threshold_reflCor_Bulk.py VIIRS_threshold_bulk.ini).

Postgresql/PostGIS

A PostGIS database stores the point data generated from the VIIRS imagery thresholding and active fire detections. This database also groups point data into fire_events representative of a single fire.

Terminology and Syntax

Table syntax: throughout this document, SQL style syntax is used to refer to tables and fields. For example “fire_events.collection_id” refers to the collection_id field in the fire_events table.

Fire_event: an entry in the fire_events table that consists of active fire detections and thresholded burned area that meets the spatial and temporal criteria.

Fire_collection: an entry in the fire_collections table that groups fire_events (individual pixels) into individual fires through the use of the foreign key found in fire_collections (join on fire_events.collection_id = fire_collections.fid).

Database Setup

The database consists of four tables:

  • active_fire: fire detections import from the AVAFO dataset (EPSG: 4326)
  • thresholded_burn: pixels that met the thresholding criteria to be preliminarily designated as “burned area” (EPSG: 4326)
  • fire_events: all active_fire records and those thresholded_burn records that pass the spatial and temporal proximity thresholds (EPSG: 102008)
  • fire_collections: table of foreign keys used to group fire_events into individual fires (EPSG: 102008)

Process

All processing is initiated and controlled by the python script VIIRS_threshold_reflCor_Bulk.py. On execution, the script:

  • reads the initialization file
  • loops through available imagery
  • thresholds each image
  • pushes thresholded and active fire pixel coordinates to database
  • initiates database functions, groups detected pixels into collections of contiguous fires
  • exports shape file of thresholded and active fire detections