clear-dsp 0.1.0__py3-none-any.whl

clear_dsp/__init__.py

@@ -0,0 +1,12 @@
+"""clear-dsp: Lightweight JAX-optimized pure functions for digital signal processing."""
+
+from clear_dsp import filters, spectral, windows
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "filters",
+    "spectral",
+    "windows",
+    "__version__",
+]

clear_dsp/filters.py

@@ -0,0 +1,12 @@
+"""Filter design and application utilities.
+
+All functions are pure and JAX-compatible.
+"""
+
+from __future__ import annotations
+
+import jax.numpy as jnp
+from jax import Array
+
+__all__ = [
+]

clear_dsp/spectral.py

@@ -0,0 +1,10 @@
+"""Spectral analysis utilities built on JAX FFT primitives."""
+
+from __future__ import annotations
+
+import jax.numpy as jnp
+from jax import Array
+
+
+__all__ = [
+]

clear_dsp/windows.py

@@ -0,0 +1,19 @@
+"""Window functions for digital signal processing.
+
+All functions return JAX arrays and are pure / JIT-compatible.
+"""
+
+from __future__ import annotations
+
+import jax
+import jax.numpy as jnp
+from jax import Array
+
+
+def rectangular(n: int) -> Array:
+    """Rectangular (boxcar) window of length ``n``."""
+    return jnp.ones(n, dtype=jnp.float32)
+
+__all__ = [
+    "rectangular",
+]

clear_dsp-0.1.0.dist-info/METADATA

@@ -0,0 +1,131 @@
+Metadata-Version: 2.5
+Name: clear-dsp
+Version: 0.1.0
+Summary: A lightweight JAX-optimized package of pure functions for digital signal processing
+Project-URL: Homepage, https://github.com/APWilwerding/clear-dsp
+Project-URL: Repository, https://github.com/APWilwerding/clear-dsp
+Project-URL: Issues, https://github.com/APWilwerding/clear-dsp/issues
+Project-URL: Documentation, https://github.com/APWilwerding/clear-dsp#readme
+Author: Andrew Wilwerding
+License-Expression: MIT
+License-File: LICENSE
+Keywords: audio,digital-signal-processing,dsp,fft,filters,jax,scientific-computing,signal-processing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: jax>=0.4.20
+Requires-Dist: jaxlib>=0.4.20
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pre-commit>=3.8; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=3.0; extra == 'docs'
+Requires-Dist: sphinx-book-theme>=1.1; extra == 'docs'
+Requires-Dist: sphinx>=7.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# clear-dsp
+
+**A lightweight JAX-optimized package of pure functions for digital signal processing.**
+
+`clear-dsp` provides a clean, functional, and high-performance set of DSP primitives built on [JAX](https://github.com/jax-ml/jax). Every function is pure, JIT-compatible, and designed for composition, autodiff, and acceleration on CPU, GPU, or TPU.
+
+## Design Principles
+
+- **Pure functions only** — no classes, no mutable state, no side effects
+- **JAX-native** — fully compatible with `jax.jit`, `jax.vmap`, `jax.grad`, and `jax.pmap`
+- **Lightweight** — minimal dependencies (just JAX)
+- **Composable** — small, focused building blocks that combine cleanly
+- **Type-safe** — full type annotations and mypy-friendly
+
+## Installation
+
+```bash
+pip install clear-dsp
+```
+
+Or for development:
+
+```bash
+git clone https://github.com/yourusername/clear-dsp.git
+cd clear-dsp
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+import jax.numpy as jnp
+from clear_dsp import filters, spectral
+
+# Example: simple low-pass FIR filter (placeholder API)
+# signal = jnp.sin(jnp.linspace(0, 10 * jnp.pi, 1000))
+# filtered = filters.fir_lowpass(signal, cutoff=0.1, num_taps=51)
+```
+
+> **Note:** The API is under active development. Check the source and tests for currently implemented functions.
+
+## Project Structure
+
+```
+clear-dsp/
+├── src/
+│   └── clear_dsp/
+│       ├── __init__.py
+│       ├── filters.py      # FIR/IIR filters, windowing
+│       ├── spectral.py     # FFT-related, spectrograms, STFT
+│       ├── windows.py      # Window functions
+│       └── ...
+├── tests/
+├── pyproject.toml
+└── README.md
+```
+
+## Development
+
+```bash
+# Install with development dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check src tests
+
+# Type check
+mypy src
+```
+
+## Roadmap (initial ideas)
+
+- Window functions (Hann, Hamming, Blackman, Kaiser, etc.)
+- FIR filter design and application
+- Basic IIR filters (biquads)
+- STFT / ISTFT
+- Spectral analysis helpers
+- Convolution and correlation
+- Resampling
+- Envelope detection / Hilbert transform
+- Signal analysis
+
+Contributions and suggestions are welcome!
+
+## License
+
+MIT License — see [LICENSE](LICENSE).

clear_dsp-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+clear_dsp/__init__.py,sha256=qIgWndPJ_IJ0Xei6Pwlg_k2-nbfMnWuI1HwoD7og_yE,242
+clear_dsp/filters.py,sha256=jFHmelb8uk53XdMgYdTj6-LLtW97v4Bj-hK2PO5yaAs,190
+clear_dsp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+clear_dsp/spectral.py,sha256=_cGC2qraDmw3NcZNwZJNJrhDTURxjHIRp2Ic-3sPso4,162
+clear_dsp/windows.py,sha256=z_LEqf1ogXG7WEix8pTAwpKz-Q2akPyhf8ksK0v9W7o,380
+clear_dsp-0.1.0.dist-info/METADATA,sha256=3-_U4N7EdHd_B336HlWcyeFR4UKkS9wFV5KOqhNL-oo,4067
+clear_dsp-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+clear_dsp-0.1.0.dist-info/licenses/LICENSE,sha256=0krBZxoHKGOpbznOeyRyij2jSetRfOOiHsA2Aiklx8A,1074
+clear_dsp-0.1.0.dist-info/RECORD,,

clear_dsp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

clear_dsp-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Wilwerding
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.