[![Build](https://github.com/sensein/senselab/actions/workflows/main-branch-status.yaml/badge.svg)](https://github.com/sensein/senselab/actions/workflows/main-branch-status.yaml)
[![codecov](https://codecov.io/gh/sensein/senselab/graph/badge.svg?token=9S8WY128PO)](https://codecov.io/gh/sensein/senselab)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![PyPI](https://img.shields.io/pypi/v/senselab.svg)](https://pypi.org/project/senselab/)
[![Python Version](https://img.shields.io/pypi/pyversions/senselab)](https://pypi.org/project/senselab)
[![License](https://img.shields.io/pypi/l/senselab)](https://opensource.org/licenses/Apache-2.0)
[![pages](https://img.shields.io/badge/api-docs-blue)](https://sensein.github.io/senselab)
Welcome to ```senselab```! This is a Python package for streamlining the processing and analysis of behavioral data, such as voice and speech patterns, with robust and reproducible methodologies.
**Caution:**: this package is still under development and may change rapidly over the next few weeks.
## Installation
Install this package via:
```sh
pip install senselab
```
Or get the newest development version via:
```sh
pip install git+https://github.com/sensein/senselab.git
```
## Quick start
```Python
from senselab.audio.data_structures import Audio
from senselab.audio.tasks.preprocessing import resample_audios
audio1 = Audio.from_filepath('path_to_audio_file.wav')
print("The original audio has a sampling rate of {} Hz.".format(audio1.sampling_rate))
[audio1] = resample_audios([audio1], resample_rate=16000)
print("The resampled audio has a sampling rate of {} Hz.".format(audio1.sampling_rate))
```
For more detailed information, check out our [**Getting Started Tutorial**](https://github.com/sensein/senselab/blob/main/tutorials/audio/getting_started.ipynb).
## Why should I use senselab?
- **Modular Design**: Easily integrate or use standalone transformations for flexible data manipulation.
- **Pre-built Pipelines**: Access pre-configured pipelines to reduce setup time and effort.
- **Reproducibility**: Ensure consistent and verifiable results with fixed seeds and version-controlled steps.
- **Easy Integration**: Seamlessly fit into existing workflows with minimal configuration.
- **Extensible**: Modify and contribute custom transformations and pipelines to meet specific research needs.
- **Comprehensive Documentation**: Detailed guides, examples, and documentation for all features and modules.
- **Performance Optimized**: Efficiently process large datasets with optimized code and algorithms.
- **Interactive Examples**: Jupyter notebooks provide practical examples for deriving insights from real-world datasets.
## Contributing
Please see [**CONTRIBUTING.md**](https://github.com/sensein/senselab/blob/main/CONTRIBUTING.md) before contributing.
To find out what's currently in progress, please check the [**Project Board**](https://github.com/orgs/sensein/projects/45).
Raw data
{
"_id": null,
"home_page": "https://github.com/sensein/senselab",
"name": "senselab",
"maintainer": "Fabio Catania",
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": "fabiocat@mit.edu",
"keywords": "voice, speech, audio",
"author": "Fabio Catania",
"author_email": "fabiocat@mit.edu",
"download_url": "https://files.pythonhosted.org/packages/72/c9/a50fcd6d49f496b5289b3c605991e6b0b4822339499aefd5b461d2469edd/senselab-0.26.0.tar.gz",
"platform": null,
"description": "[![Build](https://github.com/sensein/senselab/actions/workflows/main-branch-status.yaml/badge.svg)](https://github.com/sensein/senselab/actions/workflows/main-branch-status.yaml)\n[![codecov](https://codecov.io/gh/sensein/senselab/graph/badge.svg?token=9S8WY128PO)](https://codecov.io/gh/sensein/senselab)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\n[![PyPI](https://img.shields.io/pypi/v/senselab.svg)](https://pypi.org/project/senselab/)\n[![Python Version](https://img.shields.io/pypi/pyversions/senselab)](https://pypi.org/project/senselab)\n[![License](https://img.shields.io/pypi/l/senselab)](https://opensource.org/licenses/Apache-2.0)\n\n[![pages](https://img.shields.io/badge/api-docs-blue)](https://sensein.github.io/senselab)\n\nWelcome to ```senselab```! This is a Python package for streamlining the processing and analysis of behavioral data, such as voice and speech patterns, with robust and reproducible methodologies.\n\n**Caution:**: this package is still under development and may change rapidly over the next few weeks.\n\n## Installation\nInstall this package via:\n\n```sh\npip install senselab\n```\n\nOr get the newest development version via:\n\n```sh\npip install git+https://github.com/sensein/senselab.git\n```\n\n## Quick start\n```Python\nfrom senselab.audio.data_structures import Audio\nfrom senselab.audio.tasks.preprocessing import resample_audios\n\naudio1 = Audio.from_filepath('path_to_audio_file.wav')\n\nprint(\"The original audio has a sampling rate of {} Hz.\".format(audio1.sampling_rate))\n[audio1] = resample_audios([audio1], resample_rate=16000)\nprint(\"The resampled audio has a sampling rate of {} Hz.\".format(audio1.sampling_rate))\n```\n\nFor more detailed information, check out our [**Getting Started Tutorial**](https://github.com/sensein/senselab/blob/main/tutorials/audio/getting_started.ipynb).\n\n\n## Why should I use senselab?\n- **Modular Design**: Easily integrate or use standalone transformations for flexible data manipulation.\n- **Pre-built Pipelines**: Access pre-configured pipelines to reduce setup time and effort.\n- **Reproducibility**: Ensure consistent and verifiable results with fixed seeds and version-controlled steps.\n- **Easy Integration**: Seamlessly fit into existing workflows with minimal configuration.\n- **Extensible**: Modify and contribute custom transformations and pipelines to meet specific research needs.\n- **Comprehensive Documentation**: Detailed guides, examples, and documentation for all features and modules.\n- **Performance Optimized**: Efficiently process large datasets with optimized code and algorithms.\n- **Interactive Examples**: Jupyter notebooks provide practical examples for deriving insights from real-world datasets.\n\n## Contributing\nPlease see [**CONTRIBUTING.md**](https://github.com/sensein/senselab/blob/main/CONTRIBUTING.md) before contributing.\n\nTo find out what's currently in progress, please check the [**Project Board**](https://github.com/orgs/sensein/projects/45).\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Senselab is a Python package that simplifies building pipelines for speech and voice analysis.",
"version": "0.26.0",
"project_urls": {
"Documentation": "https://sensein.github.io/senselab",
"Homepage": "https://github.com/sensein/senselab",
"Repository": "https://github.com/sensein/senselab"
},
"split_keywords": [
"voice",
" speech",
" audio"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c3faf20bbece438ffe7284acd6fda3f1d48ca03a21c84edf41672003813fcc31",
"md5": "c25fd43fe7639babbe2e44b039243f80",
"sha256": "aa5317506e66e20f835516c152da57463a319e8131392431a879214e26e7abd5"
},
"downloads": -1,
"filename": "senselab-0.26.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c25fd43fe7639babbe2e44b039243f80",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 150153,
"upload_time": "2024-12-23T15:00:30",
"upload_time_iso_8601": "2024-12-23T15:00:30.142902Z",
"url": "https://files.pythonhosted.org/packages/c3/fa/f20bbece438ffe7284acd6fda3f1d48ca03a21c84edf41672003813fcc31/senselab-0.26.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "72c9a50fcd6d49f496b5289b3c605991e6b0b4822339499aefd5b461d2469edd",
"md5": "c81dcb2251c5bae5c3a2883f3cc6d198",
"sha256": "c8af99474e48a14bda2cd144bacc36d253e490bf8f8bf898481d588ac75634f7"
},
"downloads": -1,
"filename": "senselab-0.26.0.tar.gz",
"has_sig": false,
"md5_digest": "c81dcb2251c5bae5c3a2883f3cc6d198",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 107411,
"upload_time": "2024-12-23T15:00:32",
"upload_time_iso_8601": "2024-12-23T15:00:32.730429Z",
"url": "https://files.pythonhosted.org/packages/72/c9/a50fcd6d49f496b5289b3c605991e6b0b4822339499aefd5b461d2469edd/senselab-0.26.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-23 15:00:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sensein",
"github_project": "senselab",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "senselab"
}