Deposit export—publishing without publishing audio
Raw recordings from private spaces often cannot be shared; their acoustic
envelope can. ambiscape deposit writes per-take TSVs of 1 Hz features:
Time level_dbfs centroid_hz low_frac high_frac
0 -39.8 881 0.786 0.189
1 -44.9 135 0.966 0.007
These files are considered safe for open deposits (Zenodo and similar) where the WAVs are withheld, since a 1 Hz loudness/spectral envelope is far below speech timescales and carries no intelligible content.
The export follows the schema of the StillStanding365 deposit (365 daily
standstill sessions, fourMs/RITMO), which makes corpora that use it directly
poolable. Method deltas against that deposit's original extractor are
documented in the deposit module (W-channel at native rate vs an 8 kHz
four-channel downmix; power vs magnitude band fractions): trends and
dynamics are directly comparable, absolute fraction values differ slightly
by construction.
Directional data and channel conventions
When depositing directional products, record which B-format convention the source files used (see Sessions & conventions). A convention mismatch produces azimuth distributions collapsed onto one axis, which is an artefact that survives into downstream correlations and is invisible unless you know to look for it.
What still requires raw audio: fast-level descriptors (Leq/LAeq), events at the 0.25 s criterion, diffuseness, elevation, spectra beyond the centroid, psychoacoustic indicators. Plan deposits accordingly: features for everyone, raw audio under controlled access where the ethics allow.
Publishing an excerpt: the Freesound category
A feature deposit is one way material leaves a session; a curated audio excerpt bound for a public repository is the other. Freesound has required a category from its Broad Sound Taxonomy on every upload since April 2025, and the category is also a search facet, so it decides whether anyone finds the file. Recording it beside the WAV keeps the choice reproducible across a pack of excerpts instead of retyping it into an upload form:
ambiscape background my-session/ --excerpt 600 --bst ss-i \
--tags "ambisonic,room-tone,ventilation" --licence "CC BY 4.0"
This writes <excerpt>.wav.freesound.json next to the excerpt, carrying the
category, its full name, the licence, the tags, and the excerpt's own
provenance (session, wall clock, duration, selection method).
A whole-room recording is a soundscape, so --bst accepts only the ss-*
categories unless you pass --any-bst:
| code | use it for |
|---|---|
ss-i |
interiors: rooms, offices, halls, anywhere closed |
ss-u |
outdoors with human intervention: streets, stations, transit halls |
ss-n |
natural habitats, and interiors an open window has handed over to one |
ss-s |
synthesised or computer-made ambiences |
Run the privacy gate before uploading and record its result in the same file:
ambiscape speechgate my-session/analysis/<excerpt>.wav
deposit.freesound_sidecar(..., speech_fraction=...) stores the fraction and
sets a privacy_review flag above 0.01. It is stored rather than enforced,
because what counts as an acceptable fraction is a judgement about the
recording and not a property of the format.
This taxonomy classifies the file, not the sound
The Broad Sound Taxonomy cuts first by artefact type — music, instrument
samples, speech, sound effects, soundscapes — which is a retrieval
question, not an acoustic one. It is deliberately kept out of
ambiscape.taxonomy, where Schaeffer's, Schafer's and
soundscape ecology's schemes each ask a question of the same sound. For
a session recorded in a room the answer here is almost always ss-i, and
a field with one value is no use as a descriptor.