Skip to main content

soundevent

License: MIT PyPI version tests docs Python 3.9 + Static Badge codecov

Warning This package is under active development, use with caution.

soundevent is an open-source Python package that aims to support the computational biocoustic community in developing well-tested, coherent, and standardized software tools for bioacoustic analysis. The main goal of the package is to provide a flexible yet consistent definition of what a sound event is in a computational sense, along with a set of tools to easily work with this definition. The package comprises three key components:

Main features

1. Data Schemas for Bioacoustic Analysis

The soundevent package introduces several data schemas designed to conceptualize and standardize recurring objects in bioacoustic analysis. These data schemas establish relationships between various concepts and define the attributes each object possesses. They provide flexibility to cover a broad spectrum of use cases in bioacoustic analysis while incorporating data validation mechanisms to ensure stored information is both valid and meaningful. Notably, the package defines schemas related to sound events, including user annotations and model predictions.

2. Serialization, Storage, and Reading Functions

To promote standardized data formats for storing annotated datasets and other information about sounds in recordings, the soundevent package provides several functions for serialization, storage, and reading of the different data classes offered. These functions enable easy sharing of information about common objects in bioacoustic research. By employing a consistent data format, researchers can exchange data more efficiently and collaborate seamlessly.

3. Handling Functions for Sound Events

The soundevent package also includes a variety of functions that facilitate the handling of sound event objects. These functions serve multiple purposes, such as matching sound events for model prediction evaluation, transforming sound events, and managing metadata and labels. By offering a comprehensive set of handling functions, the package aims to streamline the analysis workflow for bioacoustic researchers, providing them with powerful tools to manipulate and extract insights from their data.

Installation

You can install soundevent using pip:

pip install soundevent

Documentation

For detailed information on how to use the package, please refer to the documentation.

Example Usage

To see practical examples of how to use soundevent, you can explore the collection of examples provided in the documentation's gallery.

Contributing

We welcome contributions from the community to make soundevent even better. If you would like to contribute, please refer to the contribution guidelines.

License

soundevent is released under the MIT License.

Metadata

Release files for soundevent 2.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for soundevent 2.10.0
File Size Uploaded Provenance
soundevent-2.10.0.tar.gz 8.8 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for soundevent 2.10.0
File Interpreter ABI Platform
soundevent-2.10.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.0 MB

Release files / soundevent-2.10.0.tar.gz

Download URL soundevent-2.10.0.tar.gz
Size 8.8 MB
Tags Source
SHA-256 checksum
How to use checksums
bd337003b425b820adb21c88c0b033f4d88b4290dab71b363d3d1846bda66fb6
BLAKE2b-256 checksum
How to use checksums
a43e2b56c957b89d4cdddcc769d71a948e1d6815f9a8ea3b489d5c04215d8448
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / soundevent-2.10.0-py3-none-any.whl

Download URL soundevent-2.10.0-py3-none-any.whl
Size 182.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3d7af33206faa66056a445f1c69ddca3fd7ed696175e759acb1ad0565009854d
BLAKE2b-256 checksum
How to use checksums
7687e85449d116d0bc2ee86b659cb0c8b668ccaae24d340f42a22fb475441be2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.9.16 {"installer":{"name":"uv","version":"0.9.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for soundevent 2.10.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.10.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page