NFGDA (Neuro-Fuzzy Gust Front Detection Algorithm)

This repository provides tools and scripts for the Neuro-Fuzzy Gust Front Detection Algorithm (NFGDA). Follow the instructions below to set up and run the system.

graph TD
    subgraph Host [HostDaemon]
        M[Main 120s loop]
    end

    M -->|check_update|AWS[AWS Server] -->|download_q| DW
    M <-->|live status| NW
    M <-->|live status| DFW
    M <-->|live status| SFW

    subgraph DW [download_worker]
        direction TB
        dl[NF_Lib.get_nexrad]
    end

    subgraph NW [nfgda_worker]
        direction TB
        nf[NF_Lib.nfgda_unit_step]
    end

    subgraph DFW [d_forecast_worker]
        direction TB
        df[NF_Lib.nfgda_forecast]
    end
  
    subgraph SFW [s_forecast_worker]
        direction TB
        ss[NF_Lib.nfgda_stochastic_summary]
    end

    dl[NF_Lib.get_nexrad] --> v06[V06_dir]
    dl[NF_Lib.get_nexrad] --->|nfgda_q| NW
    nf[NF_Lib.nfgda_unit_step] --> ep[export_preds_dir]
    nf[NF_Lib.nfgda_unit_step] --->|d_forecast_q| DFW
    df[NF_Lib.nfgda_forecast] --> efd[export_forecast_dir]
    df[NF_Lib.nfgda_forecast] --->|s_forecast_q| SFW
    ss[NF_Lib.nfgda_stochastic_summary] --> esd[export_forecast_summary]

Loading

Setup Instructions

1. Clone the repository

git clone https://github.com/firelab/NFGDA.git
cd NFGDA

2. Set up venv

Create and activate a virtual environment, then install dependencies:

# (Optional) deactivate any existing virtual environment
deactivate

# Create a new virtual environment
python3.12 -m venv ~/nfgda

# Activate the virtual environment
source ~/nfgda/bin/activate

# Install the package in editable mode
# This step may take a long time (more than 10mins) when using WSL due to dependency builds
python -m pip install -e .

3. (Optional) Configure for an event or a different radar site

Edit the scripts/NFGDA.ini to select the radar site and time range.

Real-time forecasting

radar_id = KABX
custom_start_time = None
custom_end_time =   None

Historic event analysis

radar_id = KABX
custom_start_time = 2020,07,07,01,22,24
custom_end_time =   2020,07,07,03,48,02

Configure output and runtime directories

export_preds_dir     = ./runtime/nfgda_detection/
export_forecast_dir  = ./runtime/forecast/
V06_dir              = ./runtime/V06/

4. Run NFGDA Server

cd scripts
# Must be run from the scripts directory.
# NFGDA_Host.py expects NFGDA.ini to be present in the current working directory.
python NFGDA_Host.py