Metadata-Version: 2.4
Name: seismo-framework
Version: 2.0.2
Summary: Seismo Framework: Research-based seismic monitoring system with 45 equations, 4-level alerts, and FastAPI REST server
Author-email: Samir Baladi <gitdeeper@gmail.com>
License: MIT
Project-URL: Homepage, https://seismo.netlify.app
Project-URL: Documentation, https://seismo.netlify.app/documentation
Project-URL: Repository, https://gitlab.com/gitdeeper3/seismo
Project-URL: Bug Tracker, https://gitlab.com/gitdeeper3/seismo/-/issues
Keywords: seismology,earthquake,monitoring,geophysics,fastapi,research,science,bayesian,forecasting
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS.md
Requires-Dist: numpy>=1.21.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: fastapi>=0.104.0
Requires-Dist: uvicorn>=0.24.0
Dynamic: license-file

# Seismo Framework v2.0.2

## 🚀 Research-Based Seismic Monitoring System

**Seismo Framework** is a comprehensive, open-source seismic monitoring and earthquake forecasting system designed for scientific research. Version 2.0.0 introduces 45 research equations, enhanced physics models, and improved accuracy.

### ✨ Key Features

#### **Scientific Foundation**
- **45 Research Equations** from peer-reviewed seismic studies
- **Bayesian Probability** for uncertainty quantification
- **Stress Accumulation Models** (Coulomb failure criteria)
- **4-Level Alert System**: GREEN/YELLOW/ORANGE/RED

#### **Technical Capabilities**
- **FastAPI REST Server** with automatic documentation
- **8-Parameter Monitoring System**:
  1. Seismic Analysis - Earthquake frequency-magnitude
  2. Deformation Monitoring - GPS/InSAR displacement
  3. Hydrogeological Analysis - Groundwater anomalies
  4. Electrical Signals - Resistivity monitoring
  5. Magnetic Variations - Local field tracking
  6. Instability Analysis - Dynamical assessment
  7. Stress Calculations - Coulomb modeling
  8. Rock Properties - Vp/Vs ratios
- **AI Module** for anomaly detection
- **Real-time Processing** (<100ms latency)

### 📦 Installation

```bash
pip install seismo-framework==2.0.0
```

🚀 Quick Start

```python
from seismo_framework import SeismoFramework

# Initialize framework
seismo = SeismoFramework()

# Analyze seismic data
result = seismo.analyze_v2({
    'seismic': 18.5,
    'deformation': 14.2,
    'magnetic': 47.8,
    'stress': 0.72,
    'region': 'subduction_zone'
})

print(f"Alert Level: {result['alert_level']}")  # GREEN/YELLOW/ORANGE/RED
print(f"Confidence: {result['confidence']}%")
print(f"Probability: {result['probability']}%")
```

🌐 Web Dashboard

Access the live dashboard: https://seismo.netlify.app/dashboard

🔗 Project Links

· Website: https://seismo.netlify.app
· Documentation: https://seismo.netlify.app/documentation
· Source Code: https://gitlab.com/gitdeeper3/seismo
· Issue Tracker: https://gitlab.com/gitdeeper3/seismo/-/issues
· PyPI: https://pypi.org/project/seismo-framework

🏗️ Project Structure

```
seismo_framework/
├── core/
│   ├── physics/          # 45 research equations
│   ├── analyzers/        # 8-parameter system
│   └── models/           # Bayesian models
├── api/                  # FastAPI REST server
├── alerts/               # 4-level alert system
├── ai_module/            # AI integration
└── web/                  # Dashboard components
```

📊 Performance Metrics

Metric Value
Analysis Latency <100ms
Classification Accuracy 82-88%
Test Coverage 100%
Alert Levels 4
Research Equations 45

🔬 Scientific Validation

This release incorporates methodologies from:

· Journal of Geophysical Research
· Bulletin of the Seismological Society of America
· Earth and Planetary Science Letters
· Tectonophysics

🔧 Development

Build from Source

```bash
git clone https://gitlab.com/gitdeeper3/seismo.git
cd seismo
pip install -e .[dev]
```

Run Tests

```bash
./scripts/run_all_tests.sh
# or
python -m pytest tests/
```

🔒 License & Citation

License

MIT License - See LICENSE file for details.

Citation

```bibtex
@software{seismo_framework_v2,
  author = {Baladi, Samir},
  title = {Seismo Framework v2.0.2: Research-Enhanced Seismic Monitoring},
  year = {2026},
  publisher = {PyPI},
  version = {2.0.0},
  url = {https://pypi.org/project/seismo-framework/2.0.0/}
}
```

👥 Maintainer

· Samir Baladi (@gitdeeper)
· Email: gitdeeper@gmail.com
· ORCID: 0009-0003-8903-0029
· Contact: +16142642074

🚨 Disclaimer

Seismo Framework is a research tool for scientific investigation. It is not intended for public earthquake warnings without proper validation and calibration for specific regions.

---

Seismo Framework v2.0.2 - Advancing seismic monitoring through scientific research
