sonore 0.3.0__tar.gz

sonore-0.3.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+.ipynb_checkpoints/

sonore-0.3.0/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+Notable changes to sonore. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Until 1.0, a minor version (0.x.0) may change import paths or behaviour; a patch
+version (0.x.y) only fixes bugs.
+
+## [Unreleased]
+
+## [0.3.0] - 2026-10-01
+
+First release on PyPI.
+
+### Added
+- `so.Cepstrum`: the real cepstrum of an `STFT` or `TVSTFT`, with liftering
+  (fixed or per-frame cutoff), the cepstral envelope, resynthesis with the
+  original or minimum phase, classic cepstral F0, and `plot`. Design and
+  numerical checks in `docs/design/cepstrum.md` and
+  `tools/check_cepstrum_claims.py`.
+- `so.load_hrirs()` downloads the PKU-IOA HRIR database on first use (1 m by
+  default, any of its 8 distances on request), checks each file's SHA-256 and
+  caches it in `$SONORE_DATA_DIR` or the user cache directory. The SOFA copy it
+  downloads is mirrored left to right relative to the original `.dat` files;
+  the loader corrects it.
+- `HRIRSet.concat` merges HRIR sets, e.g. one per distance.
+- Continuous integration: tests and lint on Python 3.10 and 3.14 for every push
+  and pull request, plus a check that the PyPI files build and pass their tests.
+- Release workflow publishing to TestPyPI and PyPI with trusted publishing
+  (see `docs/releasing.md`).
+- Gallery pages of their own for seeing speech, a short course in time-frequency
+  analysis, and for sound textures. Each is a runnable script
+  (`docs/gallery/speech.py`, `docs/gallery/textures.py`) shown with every example's code.
+
+### Changed
+- `HRIRSet.from_pku_ioa` also finds `.dat` files in subfolders, so the
+  database's own `dist*/elev*/` layout loads directly.
+- The source distribution now holds the code, tests and tools only; the docs,
+  gallery and audio samples stay in the repository.
+
+## [0.2.0] - 2026-09-29
+
+Renamed to sonore, with the version kept in one place (`src/sonore/__init__.py`).
+Not published to PyPI.
+
+[Unreleased]: https://github.com/choyun1/sonore/compare/v0.3.0...main
+[0.3.0]: https://github.com/choyun1/sonore/releases/tag/v0.3.0
+[0.2.0]: https://github.com/choyun1/sonore/commit/213e21a

sonore-0.3.0/CITATION.cff

@@ -0,0 +1,14 @@
+cff-version: 1.2.0
+message: "If you use sonore in your research, please cite it as below."
+title: "sonore: signals and stimuli for auditory research"
+type: software
+authors:
+  - family-names: Cho
+    given-names: Adrian Y.
+license: MIT
+repository-code: "https://github.com/choyun1/sonore"
+keywords:
+  - psychoacoustics
+  - binaural hearing
+  - spatial hearing
+  - auditory stimuli

sonore-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020-2026 Adrian Y. Cho
+
+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.