👋 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.
🎯 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:
- Identify high-risk areas for flooding and infrastructure failure.
- Understand rainfall trends in simple, actionable terms.
- Compare projected rainfall with infrastructure capacity (drainage, bridges, etc.).
- Export comprehensive reports for sharing with LGUs and local communities.
- Plan climate adaptation strategies grounded in scientific evidence.
🔬 How the Technology Works
Behind the simple interface, Project VORTEX uses four core methods:
Estimates rare extreme rainfall values that might only occur once in 5, 10, or 30 years using the Gumbel distribution for robust statistical modeling.
Runs thousands of "what-if" scenarios to understand possible future extremes and their uncertainties, producing probability distributions for risk assessment.
Uses Z-score analysis over rolling windows to flag unusual rainfall spikes earlier than traditional threshold methods.
Compares projected rainfall against known capacity of municipal infrastructure to identify weak points and prioritize upgrade planning.
📋 Step-by-Step: How to Use VORTEX
- Load Data Click Load demo dataset or upload your own CSV with columns
date,rainfall_mm(format: YYYY-MM-DD, numerical value). - Select Municipality Pick the area you want to focus on from the dropdown in the sidebar.
- Choose Return Period Select 1–30 years — this represents how rare the extreme event you're planning for should be.
- Compute Return Levels Click the button to generate charts, a risk map, and KPI cards based on your selections.
- Interpret Results Review Return Level, Anomaly Alerts, and Highest-Risk Areas. Color-coded map dots indicate relative risk levels.
- Run Simulations Head to the Simulator tab for Monte Carlo analysis and multi-scenario climate comparisons.
- Export Reports Use PNG export, Results CSV, or Print/PDF to save and share findings with stakeholders.
💡 Tips for First-Time Users
- Start with demo data — always explore features before uploading sensitive municipal records.
- Hover over charts and map dots for tooltips with detailed values and context.
- Check anomaly alerts to spot sudden extreme rainfall days that may require immediate attention.
- Change the return period to see how risk estimates shift — useful for comparing 5-year vs. 30-year planning horizons.
- Export Results CSV after computing for a machine-readable record of all municipal risk rankings.
- Multi-scenario testing — in the Simulator, compare multiple climate scenarios side-by-side.
⚠️ Scope and Limitations
Additional considerations to keep in mind:
- Forecast accuracy depends heavily on the quality and completeness of your rainfall data.
- Results represent statistical estimates, not exact predictions — treat them as planning guidance.
- Infrastructure capacity assumptions use typical design standards and may differ locally.
- Climate scenarios provide general guidance and should be combined with on-the-ground knowledge.
🔒 Data and Privacy
Your uploaded CSV files are processed entirely within your browser. No data is ever sent to external servers. This means:
- Complete data security for sensitive municipal or community information.
- Fast processing with no network round-trips or delays.
- Privacy compliance — your data never leaves your device.
- Works offline after the initial page load.
❓ Need Help?
If you encounter issues or want to go deeper, here's where to look:
- The Simulator tab has advanced prediction tools and scenario analysis.
- The Reports tab lets you export and visualize findings with statistical validation.
- The Summary page consolidates results and recommendations in one view.
- The chat assistant in the bottom-right corner is available for quick answers any time.
- Contact your LGU or local Project VORTEX team for personalized technical support.
📞 Contact the Project Team
For questions, feedback, or collaboration opportunities, reach out to the proponents:
We encourage all users to provide feedback — your input drives continuous improvement of this platform.
