clear-dsp 0.1.0__tar.gz

clear_dsp-0.1.0/.gitignore

@@ -0,0 +1,159 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# UV
+uv.lock
+
+# poetry
+poetry.lock
+
+# pdm
+pdm.lock
+pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# ruff
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.h5
+*.npz
+*.npzz

clear_dsp-0.1.0/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.

clear_dsp-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,90 @@
+# 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/pyproject.toml

@@ -0,0 +1,115 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "clear-dsp"
+version = "0.1.0"
+description = "A lightweight JAX-optimized package of pure functions for digital signal processing"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Andrew Wilwerding" }
+]
+keywords = [
+    "dsp",
+    "digital-signal-processing",
+    "jax",
+    "signal-processing",
+    "filters",
+    "fft",
+    "audio",
+    "scientific-computing",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Multimedia :: Sound/Audio :: Analysis",
+    "Typing :: Typed",
+]
+dependencies = [
+    "jax>=0.4.20",
+    "jaxlib>=0.4.20",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.6",
+    "mypy>=1.11",
+    "pre-commit>=3.8",
+]
+docs = [
+    "sphinx>=7.0",
+    "sphinx-book-theme>=1.1",
+    "myst-parser>=3.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/APWilwerding/clear-dsp"
+Repository = "https://github.com/APWilwerding/clear-dsp"
+Issues = "https://github.com/APWilwerding/clear-dsp/issues"
+Documentation = "https://github.com/APWilwerding/clear-dsp#readme"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/clear_dsp"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = "-v --strict-markers"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 88
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["clear_dsp"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+mypy_path = "src"
+packages = ["clear_dsp"]
+
+[[tool.mypy.overrides]]
+module = ["jax.*", "jaxlib.*"]
+ignore_missing_imports = true

clear_dsp-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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",
+]