FIREDpy - FIRe Event Delineation for Python

A Python Command-Line Interface for classifying fire events from the Collection 6 MODIS Burned Area Product.

This package uses a space-time window to classify individual burn detections from late 2001 to near-present into discrete events and return both a data table and shapefiles of these events. The user is able to specify the spatial and temporal parameters of the window, as well as the spatial and temporal extent, using either a shapefile or a list of MODIS Sinusoidal Projection tile IDs. Countries, continents and US states are included. Any area from the world may be selected. However, in the current version, memory constraints may limit the extent available for a single model run. Equatorial regions have much more fire activity, and may require much more RAM to process than a normal laptop will have.

The algorithm outputs shapefiles of delineated fire events in either .shp or .gpkg format. In addition to the full event polygons created by default, and the user has the option of having firedpy produce daily-level perimeters, providing a representation of both final and expanding event perimeters.

<img width="1900" height="544" alt="image" src="https://github.com/user-attachments/assets/0144541b-6fc7-4718-b620-4347ae77881f" />

Illustration of the event-level and daily-level output of FIREDpy for the 2013 Rim Fire in California. Figure is from Mahood et al. 2022.

The MODIS Sinusioidal Project

You may specify study areas for FIREDpy using individual MODIS tiles. This product uses a Sinusoidal, Lambert Azimuthal Equal-Area projection. There are several spatial resolutions available for this data, but FIREDpy uses the 500m resolution (actual distances depend on location). For more information about this projection, see https://modis-land.gsfc.nasa.gov/MODLAND_grid.html. If you would like to use the MODIS sinusoidal grid IDs to identify FIREDpy study areas, see the visualization of this grid below.

<img width="1900" alt="image" src="https://github.com/earthlab/firedpy/blob/tw/installation/firedpy/data/images/modis_land_id_map_robinson.png" />

FIREDpy citations

Methodological information for FIREDpy 1.0:

Balch, J. K., St. Denis, L. A., Mahood, A. L., Mietkiewicz, N. P., Williams, T. W., McGlinchy J, and Cook, M. C. 2020. FIRED (Fire Events Delineation): An open, flexible algorithm & database of U.S. fire events derived from the MODIS burned area product (2001-19). Remote Sensing, 12(21), 3498; https://doi.org/10.3390/rs12213498

Description of the 2000 - 2021 data sets:

Mahood, A.L. Lindrooth, E.J., Cook, M.C. and Balch, J.K. 2022. Country-level fire perimeter datasets (2001-2021). Nature Scientific Data, 9(458). https://doi.org/10.1038/s41597-022-01572-3

Methodological information for FIREDpy 2.0, description of 2000-2024 datasets:

Coming soon...

Data Sharing Agreement

FIREDpy is currently in active development, and newer versions of the algorithm and data products are shared on an individual basis. All data products generated from unpublished versions of FIREDpy require permission from PI Jennifer K. Balch prior to use in publications, presentations, or public dissemination. These conversations ensure appropriate acknowledgment of the development team's contributions and proper context for the algorithm's current capabilities and limitations. Please use the above citation for attributing credit. For data requests or collaboration inquiries, please contact Nate Hofford (nate.hofford@colorado.edu), University of Colorado Boulder.

Changes

• 10/14/2024 FIREDpy V2.0
  • No longer using setup.py. See new instructions below for running it with Docker or installing it locally.
  • Improved fire grouping
  • Improved CLI
  • Access to MODIS burn area product Version 6.1 with support up to at least December 2024

BUG ALERT:

Many of the data products created in Fall 2021 may be shifted by a half pixel, and may lack a coordinate reference system.

The problem is now fixed, so this will not affect new iterations of firedpy.

Sometimes the server that houses the MCD64A1 product used by firedpy is down. If this happens, you just need to wait until it comes back up.

See the issues tab for more bugs, or to report a new bug!

Have you used firedpy?

The algorithm and derived data products are under active development. Please raise an issue with any suggestions to help us improve firedpy. Or just email admahood@duck.com and Adam will be overjoyed to talk about firedpy.

Current status of created products

Already-created products are linked below. They are housed in the CU Scholar data repository in the Earth Lab Data collection, or here.

All of the created products have an event-level shapefile in .gpkg and .shp formats. Most countries also have the daily-level shapefile for the V2024 products, but for the V2022 products these were not created for most countries in Africa and Asia due to computational restrictions.

Click on a link below to download a fire perimeter dataset for your favorite country

|| Firedpy version| 1.0|2.0|2.0| |-------|---------|----------------------------------------|----------------------------------------|---------------------------| | Region | Country | V2022 (variable space-time parameters) | V2024S1T5 (1 pixel 5 days for everything) | V2024VST (variable ST-params) | | North America ||||| || Belize || Nov 2000 - July 2024 || || Canada| 2001-2021 | 2001-2024 || || Costa Rica || Nov 2000 - July 2024 || || El Salvador || Nov 2000 - July 2024|| || Guatemala || Nov 2000 - July 2024|| || Honduras || Nov 2000 - July 2024|| || Mexico || November 2000 - July 2024|| || Nicaragua || November 2000 - July 2024|| || Panama || November 2000 - July 2024|| || USA plus Canada | 2001-2021| November 2000 - July 2024|| || USA: Coterminous + Alaska | 2001-2021 | November 2001- July 2024|| || USA: Hawaii | 2001-2021|November 2000 - December 2024|| |Mexico and Central America |Belize, Guatemala, Honduras, El Salvador, Nicaragua, Costa Rica, Panama| 2001-2021|| |Carribean Sea ||||| |Whole region |Barbados, Bahamas, Cayman Islands, Cuba, Dominican Republic, Haiti, Jamaica, Montserrat, Puerto Rico, Saint Kitts And Nevis, Trinidad And Tobago, British Virgin Islands, Guadeloupe, Saint Barthelemy| 2001-2021 || || Aruba|| Nov 2000 - July 2024|| || Antigua and Barbuda|| Nov 2000 - July 2024|| || The Bahamas|| Nov 2000 - July 2024|| || Barbados|| Nov 2000 - July 2024|| || British Virgin Islands|| Nov 2000 - July 2024|| || Cayman Islands|| Nov 2000 - July 2024|| || Cuba|| Nov 2000 - July 2024|| || Curacao|| Nov 2000 - July 2024|| || Dominica|| Nov 2000 - July 2024|| || Dominican Republic|| Nov 2000 - July 2024|| || Grenada|| Nov 2000 - July 2024|| || Haiti|| Nov 2000 - July 2024|| || Jamaica|| Nov 2000 - July 2024|| || Montserrat|| Nov 2000 - July 2024|| || USA: Puerto Rico|| November 2000 - July 2024|| || Saint Bar