Metadata-Version: 2.4
Name: aspcol
Version: 0.0.2
Author-email: Jesper Brunnström <jesper_brunnstrom@hotmail.com>
Project-URL: Documentation, https://sounds-research.github.io/aspcol/
Project-URL: Repository, https://github.com/SOUNDS-RESEARCH/aspcol
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: aspcore
Requires-Dist: numba
Requires-Dist: wigners
Requires-Dist: jax
Requires-Dist: matplotlib
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: hypothesis; extra == "test"
Requires-Dist: cvxpy; extra == "test"
Requires-Dist: aspsim; extra == "test"
Provides-Extra: examples
Requires-Dist: aspsim; extra == "examples"
Dynamic: license-file

# ASPCOL : Audio Signal Processing COLlection
ASPCOL is a collection of functions and classes for audio signal processing, with routines for state-of-the-art sound field estimation and sound field reproduction methods. Some examples include
- Kernel interpolation for sound fields
- Bayesian estimation of sound fields using spherical harmonics, both for stationary and moving microphones
- Sound zone control with signal-to-interference-plus-noise ratio optimization
- Spatial covariance estimation for sound field reproduction using kernel ridge regression

**[More info and complete API documentation](https://sounds-research.github.io/aspcol/)**

## Installation
The package can be installed via pip by running
```
pip install aspcol
```
Alternatively, the package can be installed by cloning the repository and running
```
pip install path/to/aspcol
```

## Contents
### Sound field estimation
The content is contained in the modules 
- kernelinterpolation
- movingmicrophones
- planewaves
- soundfieldestimation
- sphericalharmonics

### Sound field reproduction
The content is contained in the modules
- soundfieldcontrol


## References
The package was developed in the course of the following research. Please consider citing any of the following papers if relevant to your work. 

**Bayesian sound field estimation using moving microphones**, J. Brunnström, M. B. Møller, and M. Moonen
```
@ARTICLE{brunnstromBayesian2025,
  author={Brunnström, Jesper and møLler, Martin Bo and Moonen, Marc},
  journal={IEEE Open Journal of Signal Processing}, 
  title={Bayesian Sound Field Estimation Using Moving Microphones}, 
  year={2025},
  volume={6},
  number={},
  pages={312-322},
  doi={10.1109/OJSP.2025.3526546}
}
```

  
**Bayesian sound field estimation using uncertain data**, J. Brunnström, M. B. Møller, J. Østergaard, and M. Moonen
```
@inproceedings{brunnstromBayesian2024,
    title = {Bayesian Sound Field Estimation Using Uncertain Data},
    author = {Brunnstr{\"o}m, Jesper and M{\o}ller, Martin Bo and {\O}stergaard, Jan and Moonen, Marc},
    year = {2024},
    month = sep,
    langid = {english},
    booktitle = {Proc. Int. Workshop Acoust. Signal Enhancement (IWAENC).},
}
```

**Sound zone control for arbitrary sound field reproduction methods**, J. Brunnström, T. van Waterschoot, and M. Moonen
```
@inproceedings{brunnstromSound2023,
    title = {Sound Zone Control for Arbitrary Sound Field Reproduction Methods},
    author = {Brunnstr{\"o}m, Jesper and van Waterschoot, Toon and Moonen, Marc},
    year = {2023},
    month = sep,
    doi = {10.23919/EUSIPCO58844.2023.10289995},
    booktitle = {Proc. European Signal Process. Conf. (EUSIPCO),},
}
```

**Signal-to-interference-plus-noise ratio based optimization for sound zone control**, J. Brunnström, T. van Waterschoot, and M. Moonen
```
@article{brunnstromSignaltointerferenceplusnoise2023,
    title = {Signal-to-Interference-plus-Noise Ratio Based Optimization for Sound Zone Control},
    author = {Brunnstr{\"o}m, Jesper and {van Waterschoot}, Toon and Moonen, Marc},
    year = {2023},
    journal = {IEEE Open J. Signal Process.},
    volume = {4},
    pages = {257--266},
    issn = {2644-1322},
    doi = {10.1109/OJSP.2023.3246398},
}
```

**Variable span trade-off filter for sound zone control with kernel interpolation weighting**, J. Brunnström, S. Koyama, and M. Moonen
```
@inproceedings{brunnstromVariable2022,
    title = {Variable Span Trade-off Filter for Sound Zone Control with Kernel Interpolation Weighting},
    author = {Brunnstr{\"o}m, Jesper and Koyama, Shoichi and Moonen, Marc},
    year = {2022},
    month = may,
    pages = {1071--1075},
    issn = {2379-190X},
    doi = {10.1109/ICASSP43922.2022.9746550},
    booktitle = {Proc. IEEE Int. Conf. Acoust., Speech, Signal Process. (ICASSP)},
}
```

## License
The software is distributed under the MIT license. See the LICENSE file for more information.

## Acknowledgements
The software has been developed during a PhD project as part of the [SOUNDS ETN](https://www.sounds-etn.eu) at KU Leuven. The SOUNDS project has recieved funding from the European Union's Horizon 2020 research and innovation programme under grant agreement No. 956369.
