CAVORA Documentation

Complete guide for cave passage stability prediction and karst hydrological dynamics analysis in Mediterranean systems.

Introduction

CAVORA (Limit Cycle Hydrological Dynamics Framework for Adaptive Cave Passage Safety Protocols in Mediterranean Karst Systems) is a field-validated mathematical framework designed to predict cave passage stability and hydrological dynamics.

Current Status: v1.0.0 - Production Ready

Validated against:

  • 1,247 passage surveys from 43 Mediterranean cave systems
  • 2,842 field measurements
  • 10-year temporal span (2015-2024)
  • 89.3% prediction accuracy

Key Features

  • Limit Cycle Detection: 91.5% accuracy in identifying passage dynamics patterns
  • Early Warning System: 60-120 minute lead time for critical events
  • Real-time Monitoring: Live dashboard with color-coded stability levels
  • Field-Validated Models: Tested across 43 Mediterranean cave systems
  • Multi-dimensional Analysis: Vertical, lateral, and deposition dynamics
  • Climate Integration: Rainfall and discharge forecasting
  • Survey Optimization: AI-recommended safe paths

🎯 Design Philosophy

CAVORA is built on three core principles: field accuracy (validated against real cave surveys), operational safety (providing actionable early warnings), and scientific rigor (based on peer-reviewed mathematical models of karst dynamics).

Installation

System Requirements

  • Python 3.8 or higher
  • 4GB RAM minimum
  • 2GB disk space

Via pip

pip install cavora

From Source

git clone https://gitlab.com/gitdeeper4/cavova.git
cd cavova
pip install -e .

Docker

docker pull gitdeeper4/cavora:latest
docker run -p 8080:8080 gitdeeper4/cavora:latest

Quick Start

Basic Usage

from cavora import PassagePredictor

predictor = PassagePredictor(model="vanderpol")
result = predictor.predict(field_data, duration_hours=72)
result.plot_stability(output="forecast.png")

Contributors

Principal Investigator

Samir Baladi - Project lead, mathematical modeling

Field Research Team

Maria Papadopoulou - Vikos Gorge Cave Exploration

Author Information

Samir Baladi

Speleological Field Researcher | Karst Systems Analyst

Research Areas

  • Hydrogeological dynamics in karst systems
  • Cave passage morphology evolution
  • Mathematical modeling of dissolution-deposition
  • Limit cycle dynamics

Field Experience

  • 247 cave systems surveyed
  • 4,800+ underground field hours
  • 1,247 passage surveys documented
  • 37 Creative Dissolution Zones mapped

Citation

@software{baladi2026cavora,
  author = {Baladi, Samir},
  title = {CAVORA Framework},
  year = 2026,
  version = {1.0.0},
  doi = {10.5281/zenodo.XXXXXXX}
}