Skip to main content

Seismo Framework v2.0.2: Research-based seismic monitoring system

Project description

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

pip install seismo-framework==2.0.0

🚀 Quick Start

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

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

Run Tests

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

🔒 License & Citation

License

MIT License - See LICENSE file for details.

Citation

@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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seismo_framework-2.0.2.tar.gz (60.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seismo_framework-2.0.2-py3-none-any.whl (49.5 kB view details)

Uploaded Python 3

File details

Details for the file seismo_framework-2.0.2.tar.gz.

File metadata

  • Download URL: seismo_framework-2.0.2.tar.gz
  • Upload date:
  • Size: 60.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.31.0

File hashes

Hashes for seismo_framework-2.0.2.tar.gz
Algorithm Hash digest
SHA256 8b137c6e35f73e9c614138da28a3c390fbf21b5b9951d70055e0ea4c7982650f
MD5 92ba74872ce8623f33a7728bfb4b9542
BLAKE2b-256 1cc60e0249b9684fa2d5b35cabc10c29adf6574134bdd16f32146c063939bf25

See more details on using hashes here.

File details

Details for the file seismo_framework-2.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for seismo_framework-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 67a6430dbae2d7bed9ff0e2ccce763e7a89aaef3b189ac1120c81efb6aae0326
MD5 0fcdfd9c2be0a55d1490568c455bb53f
BLAKE2b-256 081fc23c160226ec04e2586fc1f75ca1333c25834019a30e43ecad4f0511bf91

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page