Skip to content

bcgov/nrtbs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nrtbs (Near-Real-Time Burned Severity)

Application: NRT "same-day" burned severity (automatic)

  • uses MRAP (Most Recent Available Pixel) "cloud-free" image compositing
  • Access to ESA Sentinel-2 data via NRCAN NRT Sentinel products mirror on AWS-S3 (thanks ESA and NRCAN)

To run

git clone git@github.com:bcgov/nrtbs.git
cd nrtbs
python3 py/get_composite [FIRE_NUMBER] 

where [FIRE_NUMBER] is a 6-character BC wildfire "fire number" (a letter followed by 5 digits), for example:

python3 py/get_composite.py G90267

for the 2024 Parker Lake wildfire, affecting Fort Nelson (BC).

To manually add an end date, prefix the fire number accordingly:

python3 py/get_composite.py 20240630 G90267
  • Start and end dates will be automatically generated based on fire ignition dates unless manual end date is given
  • Automatic trimming to fire AOI
  • Results will be output into a FIRE_NUMBER_barcs folder

Notes:

Can add flag --no_update_listing to skip refreshing the index of all available Sentinel-2 data. Also a --skip_download is available for re-running without downloading the initial .zip format data again (e.g. if there are storage limitations, can use this to re-run after deleting all zip files but keeping intermediary products) e.g.:

python3 py/get_composite.py G90267 --no_update_listing

Dependencies

python3 -m pip install numpy matplotlib pandas rasterio geopandas
sudo apt install gdal-bin libgdal-dev python3-gdal
  • Also compatible with MacOS (use brew install instead of sudo apt install)

Test procedure:

Rolling up the setup and invocation, to get started (assuming you have WSL installed) here is the available test procedure:

python3 -m pip install numpy matplotlib pandas rasterio geopandas
sudo apt install gdal-bin libgdal-dev
git clone git@github.com:bcgov/nrtbs.git
cd nrtbs
python3 py/get_composite.py 20240601 G90267

Background / references