Flow-Alert

πŸ“’ Welcome to Flow-Alert

Alt Text β€”

If you’re interested in leveraging machine learning and seismic signals for channelized flow early warning,
including, but not limited to, debris flows, glacial lake outburst floods (GLOFs), and lahars,
you’ve come to the right place!
Check out our repository to get started.

πŸ“ 1. Repository Structure

Flow-Alert
β”œβ”€β”€ calculate_features   # Convert raw seismic data into features
β”œβ”€β”€ config               # Configuration files
β”œβ”€β”€ data                 # Seismic data and extracted features
β”œβ”€β”€ demo                 # Examples of running the case
β”œβ”€β”€ docs                 # Documentation for users
β”œβ”€β”€ functions            # Core functions and scripts
β”œβ”€β”€ trained_model        # Pre-trained models
    └── feature_imp      # Seismic geature weight
    └── v1_model         # Model version 1

πŸš€ 2. How to Use Our Pre-trained Models on Your Data?

To get started:
2.1, Check the To-Do-List for setup and prerequisites
2.2, Follow our tutorial notebook: Inference Tutorial

πŸ› 3. Found a Bug?

Feel free to open a Pull request, or reach out to us via email.

❓️4. Have Questions?

4.1 Start by reading our related paper
Qi Zhou, Hui Tang, ClΓ©ment Hibert, MaΕ‚gorzata Chmiel, Fabian Walter, Michael Dietze, and Jens M Turowski.
β€œEnhancing debris flow warning via machine learning feature reduction and model selection.”
Journal of Geophysical Research: Earth Surface, 129, e2024JF008094.
Click here for the manuscript

If you still have questions, feel free to contact the project contributors.

4.2 Or reach out to our research groups
Hazards and Surface Processes Research Group and Digital Earth Lab
Led by Dr. Hui Tang
Physical Earth Surface Modelling Lab
Led by Dr. Jens Turowski.

πŸ’ͺ 5. Contributors

Qi Zhou
qi.zhou@gfz.de or qi.zhou.geo@gmail.com

Kshitij Kar
kshitij.kar@gfz-potsdam.de