Metadata-Version: 2.4
Name: scodakit
Version: 1.0.0
Summary: ScodaKit: A scientific Python-based command line toolkit for S-coda seismic wave analysis and scattering parameters estimation
Author-email: Marios Karagiorgas <karagiorgasmarios@gmail.com>
Maintainer-email: Marios Karagiorgas <karagiorgasmarios@gmail.com>
License: Apache License
        Version 2.0, January 2004
        http://www.apache.org/licenses/
        
        Copyright 2025 Marios Karagiorgas
        
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
        
            http://www.apache.org/licenses/LICENSE-2.0
        
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
Project-URL: Homepage, https://github.com/marioskaragiorgas/ScodaKit
Project-URL: Documentation, https://github.com/marioskaragiorgas/ScodaKit#readme
Project-URL: Issues, https://github.com/marioskaragiorgas/ScodaKit/issues
Keywords: geophysics,seismology, S-coda waves,mean free path,coda attenuation factor,earthquake, seismic wave scattering
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: License.md
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: obspy
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: scikit-learn
Requires-Dist: cartopy
Requires-Dist: geopandas
Requires-Dist: openpyxl
Dynamic: license-file

# ScodaKit: A scientific Python-based command line toolkit for S-coda seismic wave analysis and scattering parameters estimation

**ScodaKit** is an open-source command-line pipeline for estimating the **scattering parameters of S-coda waves** from seismic waveform data. It combines waveform downloading, manual seismic phase picking, catalog metadata merging, coda window extraction, energy decay analysis and visualization — all within a modular and extensible architecture.

> Designed for researchers, seismologists, and geophysicists working on seismic attenuation, crustal scattering, or seismic coda-based energy models.

---

## 🛠️ Features

This command-line pipeline allows you to:

- 📡 Download waveform data from FDSN-compliant data centers (e.g., NOA, IRIS)
- ⌛ Manual picking of **P and S seismic wave arrivals** using interactive seismic waveform viewers
- 🗃️ Merge waveform arrival data with seismic event metadata
- 🌍 Generate interactive or GIS-compatible **maps of events and stations**
- 🧠 Extract **S-coda waveforms** from the seismic traces using signal to noise ratio (SNR) method
- 📉 Analyze S-coda energy decay to estimate **mean free path (ℓ)** and **Coda attenuation factor (B)** using the Single Isotropic Scattering Model
- 📊 Visualize full waveforms, spectrograms and coda windows 
- 📉Analyze and visualize results statistically
- 🧪 Modular stages via CLI for reproducible research

---

For more information please visit https://github.com/marioskaragiorgas/ScodaKit

**Copyright:** Marios Karagiorgas <karagiorgasmarios@gmail.com>

**license:** https://www.apache.org/licenses/LICENSE-2.0
