User Guide

👋 Welcome to Project VORTEX

Project VORTEX helps communities, Local Government Units (LGUs), and first-time users understand extreme rainfall patterns and infrastructure risks in Camarines Norte. This guide will walk you through everything you need to know.

💡 Getting started: New here? Load the demo dataset on the Main dashboard to explore all features risk-free before using real data.
Purpose

🎯 Why This Platform Exists

The dashboard and simulator provide accurate rainfall predictions, risk alerts, and visual summaries so that decision-makers can act with confidence. VORTEX helps you:

Under the Hood

🔬 How the Technology Works

Behind the simple interface, Project VORTEX uses four core methods:

Extreme Value Theory (EVT)

Estimates rare extreme rainfall values that might only occur once in 5, 10, or 30 years using the Gumbel distribution for robust statistical modeling.

Monte Carlo Simulation

Runs thousands of "what-if" scenarios to understand possible future extremes and their uncertainties, producing probability distributions for risk assessment.

Anomaly Detection

Uses Z-score analysis over rolling windows to flag unusual rainfall spikes earlier than traditional threshold methods.

Infrastructure Assessment

Compares projected rainfall against known capacity of municipal infrastructure to identify weak points and prioritize upgrade planning.

🔍 Note: All calculations follow peer-reviewed methodologies and international standards for hydrological analysis.
Workflow

📋 Step-by-Step: How to Use VORTEX

  1. Load Data Click Load demo dataset or upload your own CSV with columns date,rainfall_mm (format: YYYY-MM-DD, numerical value).
  2. Select Municipality Pick the area you want to focus on from the dropdown in the sidebar.
  3. Choose Return Period Select 1–30 years — this represents how rare the extreme event you're planning for should be.
  4. Compute Return Levels Click the button to generate charts, a risk map, and KPI cards based on your selections.
  5. Interpret Results Review Return Level, Anomaly Alerts, and Highest-Risk Areas. Color-coded map dots indicate relative risk levels.
  6. Run Simulations Head to the Simulator tab for Monte Carlo analysis and multi-scenario climate comparisons.
  7. Export Reports Use PNG export, Results CSV, or Print/PDF to save and share findings with stakeholders.
Best Practices

💡 Tips for First-Time Users

Important Notice

⚠️ Scope and Limitations

Prototype version: Project VORTEX currently focuses on rainfall-induced flooding only. Hazards such as landslides, storm surges, or droughts are not yet included but are planned for future updates.

Additional considerations to keep in mind:

Data Handling

🔒 Data and Privacy

Your uploaded CSV files are processed entirely within your browser. No data is ever sent to external servers. This means:

Note: No data is persisted between sessions by design. Re-load or re-upload your CSV each session to continue your analysis.
Support

❓ Need Help?

If you encounter issues or want to go deeper, here's where to look:

Get in Touch

📞 Contact the Project Team

For questions, feedback, or collaboration opportunities, reach out to the proponents:

📱
Phone / WhatsApp
🏫
Office
Basud National High School, Esperanza St., Basud, Camarines Norte
📘
Social Media

We encourage all users to provide feedback — your input drives continuous improvement of this platform.