Metadata-Version: 2.4
Name: avysignal
Version: 0.1.1
Summary: This project contains utilities for avalanche detection using seismic and infrasound data.
Author-email: Patrick Düggelin <patrick.dueggelin@slf.ch>
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Requires-Dist: obspy>=1.4.2
Requires-Dist: pydantic>=2.11.7
Provides-Extra: beamforming
Requires-Dist: torch>=2.7.1; extra == 'beamforming'
Description-Content-Type: text/markdown

# `avysignal`

> ## 🚧 Work in progress 🚧

[![PyPI - Version](https://img.shields.io/pypi/v/avysignal.svg)](https://pypi.org/project/avysignal)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/avysignal.svg)](https://pypi.org/project/avysignal)

This project contains utilities for avalanche detection using seismic and infrasound data.

## Installation

Create and activate a virtual environment and then install `avysignal`:

```shell
pip install avysignal
```

Beamforming requires some additional dependencies. You can install them like so:

```shell
pip install "avysignal[beamforming]"
```

## Usage

Download and extract the example data

```shell
./scripts/download_example_data.sh
```

See the [example scripts](examples/signal_processing)

## Contributing

### Project Structure

```
avysignal/
├── archive/                # Legacy workflows (In particular firenze matlab implementation)
├── examples/               # Example data and usage demonstrations
│   ├── data/               # Sample seismic data files (.mseed)
│   └── signal_processing/  # Example processing scripts. Start here!
├── scripts/                # Utility and one-off scripts
├── src/avysignal/          # Main package source code
│   ├── plotting/           # Visualization utilities
│   ├── resources/          # Static metadata
│   │   └── stations/       # XML metadata files for sensor networks
│   ├── signal_processing/  # Signal processing algorithms such as beamforming.
│   └── slf_utils/          # SLF-specific utilities
```
