Metadata-Version: 2.4
Name: wandas
Version: 0.0.8
Summary: Wandas is an open source library for efficient signal analysis in Python
Project-URL: Repository, https://github.com/kasahart/wandas.git
Project-URL: Issues, https://github.com/kasahart/wandas/issues
Author-email: kasahart <kasahart66@gmail.com>
Maintainer-email: kasahart <kasahart66@gmail.com>
License: MIT
License-File: LICENSE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: cattrs
Requires-Dist: dask>=2024.8.0
Requires-Dist: h5py>=3.13.0
Requires-Dist: ipykernel
Requires-Dist: ipympl>=0.9.3
Requires-Dist: ipywidgets
Requires-Dist: librosa
Requires-Dist: matplotlib
Requires-Dist: mosqito
Requires-Dist: numpy
Requires-Dist: scipy
Description-Content-Type: text/markdown

# Wandas: **W**aveform **An**alysis **Da**ta **S**tructures

[![PyPi](https://img.shields.io/pypi/v/wandas)](https://pypi.org/project/wandas/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/wandas)
[![CI](https://github.com/kasahart/wandas/actions/workflows/ci.yml/badge.svg)](https://github.com/kasahart/wandas/actions/workflows/ci.yml)
[![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/kasahart/wandas/blob/main/LICENSE)
[![Typing](https://img.shields.io/pypi/types/wandas)](https://pypi.org/project/wandas/)

**Wandas** は、Pythonによる効率的な信号解析のためのオープンソースライブラリです。Wandas は、信号処理のための包括的な機能を提供し、Matplotlibとのシームレスな統合を実現しています。

## 機能

- **包括的な信号処理機能**: フィルタリング、フーリエ変換、STFTなど、基本的な信号処理操作を簡単に実行可能
- **可視化ライブラリとの統合**: Matplotlibとシームレスに統合してデータを簡単に可視化可能。

## インストール

```bash
pip install wandas
```

## クイックスタート

```python
import wandas as wd

cf = wd.read_wav("data/summer_streets1.wav")
cf.describe()
```

![cf.describe](https://github.com/kasahart/wandas/blob/main/images/read_wav_describe.png?raw=true)

```python
cf.describe(
    axis_config={
        "time_plot": {"xlim": (0, 15), "ylim": (-30000, 30000)},
        "freq_plot": {"xlim": (60, 120), "ylim": (0, 16000)},
    },
    cbar_config={"vmin": 10, "vmax": 70},
)
```

![cf.describe](https://github.com/kasahart/wandas/blob/main/images/read_wav_describe_set_config.png?raw=true)

```python
cf = wd.read_csv("data/test_signals.csv", time_column="Time")
cf.plot(title="Plot of test_signals.csv using wandas", overlay=False)
```

![cf.plot](https://github.com/kasahart/wandas/blob/main/images/plot_csv_using_wandas.png?raw=true)

### 信号処理

```python
signal = wd.generate_sin(freqs=[5000, 1000], duration=1)
# ローパスフィルタを適用
signal.low_pass_filter(cutoff=1000).fft().plot()
```

![signal.low_pass_filter](https://github.com/kasahart/wandas/blob/main/images/low_pass_filter.png?raw=true)

```python
# フィルタ済み信号を WAV ファイルに保存
signal.low_pass_filter(cutoff=1000).to_wav('filtered_audio.wav')
# Audioコントロール表示
signal.to_audio()
```

## ドキュメント

詳細な使用方法は`/exsampls`を参照してください

## 対応データ形式

- **音声ファイル**: WAV
- **データファイル**: CSV

## バグ報告と機能リクエスト

- **バグ報告**: [Issue Tracker](https://github.com/kasahart/wandas/issues) に詳細を記載してください。
- **機能リクエスト**: 新機能や改善案があれば、気軽に Issue をオープンしてください。

## ライセンス

このプロジェクトは [MIT ライセンス](LICENSE) の下で公開されています。

---

Wandas を使って効率的な信号解析体験を！
