SEPAFE

The Sepal Planet Active Fires Explorer (SEPAFE) is a module developed on the SEPAL platform based on the Fire Information for Resource Management System (FIRMS) and using Planet Scope imagery from Planet Labs.

SEPAFE aims to provide users with a quick way to get and validate fire alerts from the FIRMS program by using daily planet imagery.

https://raw.githubusercontent.com/dfguerrerom/planet_active_fires_explorer/main/doc/img/sepal_active_fires_home.png

Settings panel

The settings panel is composed of three tabs: Planet Imagery, Area of Interest and Alerts, each of them is a necessary step to get the fire alerts.

Tip

The settings panel can be open/closed by clicking on the settings settings button.

Connect your Planet API Key

Note

This step is optional but highly recommended. Although you can go through the next tabs and get the fire alerts from the different satellite sources, to get the most advantage of the module, you will need a Planet API Key with access to daily imagery.

  • Validate your Planet API Key: provide a valid API Key in the input box and click over the validation button, the module will check whether the key is valid or not and the messages of its connection will be displayed directly into the alerts widget. Once your validation is done, you can open the advanced settings expansion panel and modify its inputs.

Tip

use the planet state bar located in the top-left corner to get useful messages related with planet imagery, such as problems with the key or number of images loaded.

  • Open the Advanced settings panel

    • Max number of images: maximum number of planet images to be displayed at once in each alert.

    • Search up to 'x' days before: the number of days before the fire alert date to look up for the best image available.

    • Search up to 'x' days after: the number of days after the fire alert date to look up for the best image available.

    • Cloud cover threshold: maximum cloud cover threshold accepted in the images (based on the planet metadata).

https://raw.githubusercontent.com/dfguerrerom/planet_active_fires_explorer/main/doc/gif/planet.gif

Select area of interest (AOI)

The module has two options to select an area of interest to filter alerts.

  • Draw a shape: when this option is selected, three drawing tools will be displayed in the top-left map corner, you can select a square, circle, and a polygon and draw them on the map.

  • Select a country: type the name of the country directly into the search box or navigate through it by using the scroll bar, and select the desired country. Once the country is selected, it will be displayed in the map view.

https://raw.githubusercontent.com/dfguerrerom/planet_active_fires_explorer/main/doc/gif/aoi.gif

Get fire alerts

  • Recent: the products to be downloaded are coming from the Moderate Resolution Imaging Spectroradiometer (MODIS) and the Visible Infrared Imaging Radiometer Suite (VIIRS) for the last 24, 28 hours, and the last 7 days.

  • Historical: for the historical products, you will be able to download alerts from 2000 until the last finished year from the MODIS satellite. Click over the historical button and filter by the dates.

After clicking over the get alerts button, the module will start the download process and will clip the alerts to the given AOI. The alerts will be displayed on the map according to a color map for the alert confidence, ranging from green, orange, to red for the confidence values high, nominal and low (for VIIRS) and >80, >70 < 80, <50 for MODIS.

Warning

depending on the sensor source and whether your alert request is recent or historical, the download/clip process could take more time. This module is intended to get a quick and fast validation of fire alerts, if you are requesting an area with more than 10,000 fire alerts, you will be asked if you want to display all the alerts on the map —which could highly affect the performance of the tool— or if you want to download them to your desktop/SEPAL environment.

Manually load planet imagery

Click over any point in the map and use the refresh icon refresh to retrieve planet imagery using the parameters set in the step 1, the module will use the current acquisition alert date to search the images. This option is useful when you want to explore surrounding areas close to the alert point but without alerts to display.

Warning

For use this option you will require a valid planet level 2 key, otherwise you will get an error message displayed in the state bar.