Ambiscape
Ambiscape is a Python toolbox for analysing soundscapes—the sonic ambiences of rooms and other places. It reads mono, stereo, binaural, or first-order ambisonic recordings of any length and describes a place's sound as a whole: level, spectrum, space, rhythm, sources, and more. Several recorders spread through a building can be read together as one acoustic network.
Install
pip install ambiscape
Optional extras add psychoacoustic indicators, machine listening, music analysis, live capture, and spatial visuals. See the install guide.
Quickstart
Point analyze at a session—a folder of WAV files from one recording occasion:
ambiscape analyze my-session/
This streams the audio in constant memory, however long it is. It extracts features, computes descriptors (Leq, LAeq, percentile levels, event statistics, diffuseness, and more), renders overview figures, and writes a README.md summarising the session. Start by reading that README and looking at analysis/overview.png:
Commands
analyze is one of nearly forty subcommands. The others cover taxonomy annotation, rhythm and tonality, room acoustics and impulse responses, ecological and source-domain indices, perceptual surveys, multi-recorder building networks (network), corpus aggregation, and privacy-aware publishing. The command overview lists them all; ambiscape --help prints the same list.
Documentation
- User guide & API reference—the session model, feature and descriptor definitions, and a page per analysis module.
- Wiki—field-recording protocol, recipes, worked case studies, design rationale, and research context.
Ambiscape analyses sound; its sister toolbox MGT-python analyses video. The two meet at file boundaries—see Working with other packages.
Licence
MIT—see LICENSE.
Credits
Ambiscape is developed as part of the AMBIENT project at fourMs / RITMO, University of Oslo, supported by the Research Council of Norway. It is the streaming companion to ambiviz, which renders rich spatial visuals from short ambisonic files.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ambiscape-0.31.0.tar.gz.
File metadata
- Download URL: ambiscape-0.31.0.tar.gz
- Upload date:
- Size: 302.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b1d47ad596f2e4874f00c587eb4c24363c0739de77d0843b75d7e4bd0a09e6b9
|
|
| MD5 |
a922a67ec143e5d5559ec4e892bb497d
|
|
| BLAKE2b-256 |
bb6d9e5803ceed996517d1a5639244c4e27f1634508e38d42cddac259635392a
|
Provenance
The following attestation bundles were made for ambiscape-0.31.0.tar.gz:
Publisher:
python-publish.yml on fourMs/ambiscape
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ambiscape-0.31.0.tar.gz -
Subject digest:
b1d47ad596f2e4874f00c587eb4c24363c0739de77d0843b75d7e4bd0a09e6b9 - Sigstore transparency entry: 2406852488
- Sigstore integration time:
-
Permalink:
fourMs/ambiscape@284c640cd07cba15e01bb55b52a4d73259e49cc1 -
Branch / Tag:
refs/tags/v0.31.0 - Owner: https://github.com/fourMs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@284c640cd07cba15e01bb55b52a4d73259e49cc1 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ambiscape-0.31.0-py3-none-any.whl.
File metadata
- Download URL: ambiscape-0.31.0-py3-none-any.whl
- Upload date:
- Size: 254.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
70e11c6bce440c4a1ec92d44fa4b198ba00167c3192d2787815caae6e50a420c
|
|
| MD5 |
f11d4b2c6cab385739997b97c7bf0e42
|
|
| BLAKE2b-256 |
f4c766b00b54adcb26d3303f0e2534345b2fb63caec85ac1ffe7b783dda4eeca
|
Provenance
The following attestation bundles were made for ambiscape-0.31.0-py3-none-any.whl:
Publisher:
python-publish.yml on fourMs/ambiscape
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ambiscape-0.31.0-py3-none-any.whl -
Subject digest:
70e11c6bce440c4a1ec92d44fa4b198ba00167c3192d2787815caae6e50a420c - Sigstore transparency entry: 2406852582
- Sigstore integration time:
-
Permalink:
fourMs/ambiscape@284c640cd07cba15e01bb55b52a4d73259e49cc1 -
Branch / Tag:
refs/tags/v0.31.0 - Owner: https://github.com/fourMs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@284c640cd07cba15e01bb55b52a4d73259e49cc1 -
Trigger Event:
release
-
Statement type:
