dynamic-sound

KO | EN

gitlite — search

#python #react #typescript #golang #deep-learning #nodejs #macos #windows #kubernetes #vue #pytorch #security #ios #openai

(★ 18)

DynamicSound Simulator is a modular Python library for generating virtual acoustic scenes with configurable microphones, sound sources, and environments, supporting research and development in beamforming, source localization, audio augmentation, and acoustic machine learning

dynamic-sound Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18105721.svg)](https://doi.org/10.5281/zenodo.18105721)
[![Static Badge](https://img.shields.io/badge/github-repository-blue?logo=github)](https://github.com/vlsi-nanocomputing/dynamic-sound)
[![GitHub Release](https://img.shields.io/github/v/release/vlsi-nanocomputing/dynamic-sound?color=blue)
](https://github.com/vlsi-nanocomputing/dynamic-sound)
[![GitHub License](https://img.shields.io/github/license/vlsi-nanocomputing/dynamic-sound)](https://github.com/vlsi-nanocomputing/dynamic-sound)
[![GitHub forks](https://img.shields.io/github/forks/vlsi-nanocomputing/dynamic-sound)](https://github.com/vlsi-nanocomputing/dynamic-sound)
[![PyPI - Version](https://img.shields.io/pypi/v/dynamic-sound)](https://pypi.org/project/dynamic-sound)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/dynamic-sound)](https://pypi.org/project/dynamic-sound/)

DynamicSound is a modular Python library designed for generating **virtual acoustic scenes** with customizable **microphone configurations**, **sound sources**, and **environmental conditions**. It is intended for research, algorithm development, and testing in areas such as **beamforming**, **source localization**, **audio augmentation**, and **acoustic machine learning**.

---

## 🚀 Features

- **Flexible microphone models**
  - Single-channel microphones
  - Microphone arrays with arbitrary geometry
  - User-defined sampling rates

- **Configurable sound sources**
  - White noise generator
  - Sinusoidal signal generator
  - Audio file source

- **Environmental modeling**
  - Source and microphone trajectories, 3D positions and rotations
  - Air absorption based on **ISO 9613-1**
  - Temperature, pressure, and humidity parameters

- **Signal path simulation**
  - Distance-based attenuation
  - Multiple sound sources simulation
  - Scenarios with dynamic movement

---

## 🔢 Versioning

This library follows **Semantic Versioning** using the format `M.m.p`

Where:
- **M** – Major version: incompatible API changes  
- **m** – Minor version: added functionality in a backward-compatible manner  
- **p** – Patch version: backward-compatible bug fixes

---

## 📦 Installation

### From PyPI
```bash
pip install dynamic-sound[==<version>]
```
example: `pip install dynamic-sound=1.0.0`

---

## 🎮 Usage Example

```python
import dynamic_sound as ds

source_path = ds.Path([
  # time / position(x,y,z) / quaternion(w,x,y,z)
    [0.0,  343, 3, 1,   1, 0, 0, 0],
    [10.0, -343, 3, 1,   1, 0, 0, 0]
])
microphone_path = ds.Path([
    [0.0,  0, 0, 1,   1, 0, 0, 0],
    [10.0,  0, 0, 1,   1, 0, 0, 0]
])

# simulation environment
sim = ds.Simulation(
    temperature=20,  # temperature [°C]
    pressure=1,  # pressure [atm]
    relative_humidity=50  # relative humidity [%]
)

# microphone
mic_sample_rate = 48_000  # Hertz [Hz]
microphone = ds.microphones.Microphone("_tmp/sine_dynamic.wav", sample_rate=mic_sample_rate)
sim.add_microphone(path=microphone_path, microphone=microphone)

# source
source = ds.sources.SineWave(frequency=2_000, amplitude=1.0)
sim.add_source(
    path=source_path,
    source=source
)

sim.run()
```

More examples available inside `examples` folder.

---

## 🤝 How to contribute

Contributions are welcome!
Please open an issue or submit a merge request following Git’s standard workflow.

## Clone project
```bash
git clone <repository_name>
```

---

## 📂 Project structure

---

## 🛠️ Development Installation

### Install `uv`

- windows
```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

- Linux and MacOS
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

more details in the official [uv documentation](https://docs.astral.sh/uv/getting-started/installation/#standalone-installer)

### Generate the Environment

```bash
uv sync
```

### Open the examples with Jupyter Lab

- windows
```bash
.venv\Scripts\activate.bat
jupyter lab
```

- Linux and MacOS
```bash
source .venv/bin/activate
jupyter lab
```

Open one of the *.ipynb inside the examples folder and run it.

---

## 🧪 Running Tests

```bash
uv run pytest --cov=src --cov-report=term-missing --cov-fail-under=80 --capture=no
```

---

## 📈 Increment the version

```bash
uv version --bump patch
```
the options are `major`, `minor`, `patch`

---

## 📢 Pubblish on PyPI

```bash
uv publish --token UV_PUBLISH_TOKEN
```

---

## 📜 License
This project is licensed under the Apache License 2.0.
See the full license text in [LICENSE.txt](LICENSE.txt).

dynamic-sound

dynamic-sound Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

dynamic-sound

dynamic-sound Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README