lasp/README.md

94 lines
2.8 KiB
Markdown
Raw Normal View History

2018-03-06 20:15:21 +00:00
# Library for Acoustic Signal Processing
2023-01-13 07:59:22 +00:00
- Master branch: [![Build Status](https://drone.ascee.nl/api/badges/ASCEE/lasp/status.svg?ref=refs/heads/master)](https://drone.ascee.nl/ASCEE/lasp)
- Develop branch: [![Build Status](https://drone.ascee.nl/api/badges/ASCEE/lasp/status.svg?ref=refs/heads/develop)](https://drone.ascee.nl/ASCEE/lasp)
2023-01-12 21:27:42 +00:00
Welcome to LASP: Library for Acoustic Signal Processing. LASP is a C++ library
2023-01-12 10:50:34 +00:00
with a Python interface which is supposed to acquire and process (multi) sensor data in real time on a PC and output results.
2018-03-06 20:15:21 +00:00
Current features that are implemented:
- Compile-time determination of the floating-point accuracy (32/64 bit)
- Fast convolution FIR filter implementation
- Sample rate decimation by an integer factor of 4.
2018-03-06 20:26:08 +00:00
- Octave filterbank FIR filters designed to comply with IEC 61260
2018-03-06 20:15:21 +00:00
(1995).
2018-03-06 20:26:08 +00:00
- Averaged power spectra and power spectral density determination
using Welch' method. Taper functions of Hann, Hamming, Bartlett and
Blackman are provided.
- A thread-safe job queue including routines to create worker threads.
- Several linear algebra routines (wrappers around BLAS and LAPACK).
- A nice debug tracer implementation
- Third octave filter bank FIR filters designed to comply with IEC 61260
(1995).
2018-03-06 20:15:21 +00:00
- Slow and fast time updates of (A/C/Z) weighted sound pressure levels
Future features (wish-list)
- Conventional and delay-and-sum beam-forming algorithms
2018-03-06 20:15:21 +00:00
For now, the source code is well-documented but it requires some
additional documentation (the math behind it). This will be published
2022-07-20 12:58:48 +00:00
in a sister repository (https://code.ascee.nl/ascee/lasp-doc).
2018-03-06 20:15:21 +00:00
If you have any question(s), please feel free to contact us: info@ascee.nl.
2023-01-12 10:50:34 +00:00
# Installation
2023-01-12 10:50:34 +00:00
## Dependencies
- `$ sudo apt install python3-pybind11 libopenblas-dev python3-pip python3-scipy libusb-1.0-0-dev libpulse-dev cmake-curses-gui python3-h5py`
2023-01-12 10:50:34 +00:00
- `$ pip3 install --user -r requirements.txt`
2022-07-20 12:58:48 +00:00
2023-01-12 10:50:34 +00:00
If building RtAudio with the ALSA backend, you will also require the following packages:
2022-01-13 12:59:35 +00:00
2023-01-12 10:50:34 +00:00
- libclalsadrv-dev
2022-07-20 12:58:48 +00:00
2023-01-12 10:50:34 +00:00
If building RtAudio with the Jack Audio Connection Kit (JACK) backend, you will also require the following packages:
2023-01-12 10:50:34 +00:00
- libjack-jackd2-dev
2023-01-12 10:50:34 +00:00
## Download & build
2023-01-12 10:50:34 +00:00
- `$ git clone --recursive https://code.ascee.nl/ASCEE/lasp.git`
- `$ cd lasp`
2022-07-20 12:58:48 +00:00
2023-01-12 10:50:34 +00:00
For a release build:
2022-07-20 12:58:48 +00:00
2023-01-12 10:50:34 +00:00
- `$ cmake .`
2022-07-20 12:58:48 +00:00
2023-01-12 10:50:34 +00:00
or optionally for a custom build:
2022-07-20 12:58:48 +00:00
2023-01-12 10:50:34 +00:00
- `$ ccmake .`
2022-07-20 12:58:48 +00:00
2023-01-12 10:50:34 +00:00
Configure and run:
2022-01-13 12:59:35 +00:00
2023-01-12 10:50:34 +00:00
- `$ make -j`
2022-01-13 12:59:35 +00:00
2023-01-12 10:50:34 +00:00
### Build documentation
2022-01-13 12:59:35 +00:00
2023-01-12 10:50:34 +00:00
`$ sudo apt install doxygen`
2022-01-13 12:59:35 +00:00
2023-01-12 10:50:34 +00:00
While still in lasp dir:
2023-01-12 10:50:34 +00:00
`$ doxygen`
2023-01-12 10:50:34 +00:00
This will build the documentation. It can be read by:
2023-01-12 10:50:34 +00:00
`$ <YOUR-BROWSER> doc/html/index.html`
2023-01-12 10:50:34 +00:00
## Install
2023-01-12 10:50:34 +00:00
For an editable install (while developing):
2023-01-12 10:50:34 +00:00
- `$ pip3 install --prefix=$HOME/.local -e .`
2023-01-12 10:50:34 +00:00
To install locally, for a fixed version:
- `$ pip3 install --prefix=$HOME/.local`
## Usage
- See examples directories for IPython notebooks.
- Please refer to the [documentation](https://lasp.ascee.nl/) for features.