Skip to content

🌊 Simulate advanced two-phase mass flows, including debris flows and avalanches, with open-source software inspired by r.avaflow and RAMMS.

License

Notifications You must be signed in to change notification settings

Mard1001/PyDebFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌍 PyDebFlow - Simulate Mass Flows with Ease

πŸ“₯ Download Now

Download PyDebFlow

πŸš€ Getting Started

Welcome to PyDebFlow! This guide will help you download and run our geospatial tool for simulating gravitational mass flows. PyDebFlow is designed to make predicting hazards from debris flows and landslides simple and intuitive.

πŸ“‹ System Requirements

To run PyDebFlow smoothly, ensure your system meets the following requirements:

  • Operating System: Windows 10 or later, macOS, or a current version of Linux.
  • RAM: Minimum 4GB, but 8GB or more is recommended for better performance.
  • Processor: Dual-core processor or better.
  • Python: Python 3.6 or later installed on your machine.
  • Disk Space: At least 200MB of free space for installation and data processing.

πŸ“¦ Download & Install

To get started, visit the Releases page to download PyDebFlow. You can find the download link below:

Download PyDebFlow

  1. Click the link above to go to the Release page.
  2. Locate the most recent version of PyDebFlow.
  3. Download the file that matches your operating system.
    • Look for files named something like PyDebFlow-v1.0.exe for Windows, PyDebFlow-v1.0.dmg for macOS, or PyDebFlow-v1.0.tar.gz for Linux.
  4. After the download finishes, open the file and follow the prompts to install the software on your computer.

πŸ› οΈ Running PyDebFlow

Once the installation is complete:

  1. Locate the PyDebFlow application in your Applications folder (macOS), Start Menu (Windows), or in your terminal for Linux users.
  2. Double-click the application to launch it.
  3. Follow the on-screen instructions to set up your first simulation.

πŸ“˜ How to Use PyDebFlow

After launching PyDebFlow, you will see the main interface. Here’s a brief overview of key features:

  • Input Parameters: Enter the topographic data and physical properties related to the mass flow, such as friction models and slope angles.
  • Simulation Controls: Start, pause, or stop simulations easily using the provided buttons.
  • Output Visualization: View runout maps and velocity profiles generated by the simulation.

Check the help section within the app for more detailed instructions on using each feature.

πŸ”§ Features

PyDebFlow provides several features to support hazard assessment:

  • Physics-Based Friction Models: Incorporate realistic physics into your simulations for accurate predictions.
  • Advanced Topography Processing: Import digital elevation models (DEMs) in TIFF format for precise terrain representation.
  • Customizable Simulation Parameters: Adjust parameters to fit specific needs and scenarios.
  • User-Friendly Interface: Designed for ease of use, even for non-technical users.

🌐 Support and Contributions

If you encounter issues or have questions, you can reach out to our support team. We are dedicated to improving PyDebFlow:

  • Issues: Report issues or request features directly on our GitHub Issues page.
  • Community Contributions: We welcome contributions. Feel free to fork the repository and submit your changes.

🌍 Explore More

To learn more about geospatial modeling and gravitational mass flows, you can find additional resources in the documentation:

  • Visit the official documentation on our GitHub page for comprehensive guides.
  • Join community forums or social media discussions about landslides and debris flows.

Thank you for choosing PyDebFlow! We hope it helps you in your research and simulations. Enjoy exploring the dynamics of gravitational mass flows.