An interface for quick analysis and reporting of wildfire emissions.
Create an application that simplifies and speeds up the creation of various wildfire emission plots based on a subset of the ECMWF dataset. The project consists of:
- Lower-level modules with the basic functions needed to extract data and produce a figure from a configuration file.
- Higher-level interface for easily running the wildfire explorer in a notebook-like webpage.
- Dataset: GFAS (Global Fire Assimilation System) from ECMWF.
- Resolution: daily data at 0.1 deg.
- Period: from January 2003 to present.
- Satellite dataset assimilated: MODIS Terra and Aqua Active Fire Products.
These data are stored in a PostGIS database (present locally in the ECMWF servers), which optimize the retrievel of these large amount of data. A preliminary study on the database performance is presented here and here, in the form of jupyter notebooks.
The file environment.yml contains all the dependencies for this project. To run this project: 1) create a new environment using conda or mamba, 2) Install this repository through pip. Specific commands:
conda env create -f environment.yml --name=<your-env-name> conda activate <your env name> pip install git+https://github.com/esowc/wildfire-explorer.git #installs the specific modules developed for this project
It is possible to create quick plots directly using the CLI comands (no interface) and recursively producing plots for different countries as listed in the configuration file. In addition, the data can also be saved in separate csv file to reproduce again the plots. To run the cli, after installation use the following command:
wildfire_explorer <path-to-file>/example_config.yml
the example_config.yml presented in this repository contains all the details about the parameters that can be changed by the user.
This command is equivalent to running this line in the main folder of the repository:
python data_handler.py <path-to-file>/example_config.yml
The best way to explore wildfire data and use this project is through its user interface, built as a jupyter notebook and visible with the following voilá command:
voila <additional-path-to-file>/Official_UI_v0.1.ipynb
This will open the notebook Official_UI_v0.1.ipynb present in this repository and guide the user into creating and saving different plots. This GIF shows the GUI capability.
This project has been developed as part of the ECMWF Summer of Weather Code and proposes a solution for challenge #32.