Metadata-Version: 2.4
Name: pmtvs-spectral
Version: 0.5.0
Requires-Dist: numpy>=1.20
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Provides-Extra: dev
License-File: LICENSE
Summary: Spectral analysis primitives
Author: pmtvs contributors
License: PolyForm-Strict-1.0.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# pmtvs-spectral

Spectral analysis primitives.

## Installation

```bash
pip install pmtvs-spectral
```

## Functions

- `power_spectral_density(signal, fs)` - Welch's method PSD
- `dominant_frequency(signal, fs)` - Peak frequency
- `spectral_entropy(signal, fs)` - Flatness measure
- `spectral_centroid(signal, fs)` - Center of mass
- `spectral_bandwidth(signal, fs)` - Spread around centroid
- `spectral_rolloff(signal, fs)` - Energy threshold frequency
- `spectral_flatness(signal, fs)` - Wiener entropy
- `harmonic_ratio(signal, fs)` - Harmonic-to-noise ratio
- `total_harmonic_distortion(signal, fs)` - THD
- `fft_magnitude(signal, fs)` - FFT magnitude spectrum
- `hilbert_transform(signal)` - Hilbert transform
- `envelope(signal)` - Signal envelope
- `instantaneous_frequency(signal, fs)` - Instantaneous frequency
- `instantaneous_amplitude(signal)` - Instantaneous amplitude
- `instantaneous_phase(signal)` - Instantaneous phase
- `spectral_slope(signal, fs)` - Spectral slope
- `signal_to_noise(signal)` - Signal-to-noise ratio

## Backend

Pure Python implementation.

## License

PolyForm Strict 1.0.0 with Additional Terms.

- **Students & individual researchers:** Free. Cite us.
- **Funded research labs (grants > $100K):** Academic Research License required. [Contact us](mailto:licensing@pmtvs.dev).
- **Commercial use:** Commercial License required. [Contact us](mailto:licensing@pmtvs.dev).

See [LICENSE](LICENSE) for full terms.

