# AudioCarver
Seam Carving as a Data Augmentation Technique
For more detail please check out my [website](https://aloosha2.github.io/audio_carver/)
# Audio Processing Library
A Python library for performing seam carving on audio files, converting audio to matrix and back, and generating spectrograms.
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Features](#features)
- [Examples](#examples)
- [Documentation](#documentation)
- [License](#license)
- [Contact](#contact)
## Installation
You can install the library using pip:
```sh
pip install audio_carver
```
## Usage
Example in a python file:
```python
from audio_carver import carve_audio, sig_to_wav
# Carving in time domain and writing to output
magnitude, phase = carve_audio(number_of_seams, magnitude, phase, is_vertical=True) # default true
sig_to_wav('output.wav', magnitude, phase)
```
Example in terminal(Recommended):
```sh
$ python main.py <input_file.wav> <number_of_seams> <--carve_time> # remove to carve in frequency
```
## Features
Current Supported Audio Formats: .wav
Audio Processing Capabilities: Spectral analysis, Time-domain operations, Signal modification
Input Requirements: None
Output: Mono signal with sampling rate inherited from the original input file's sampling rate
VIsualization: Spectrogram comparisons of before/after carving
## Examples
How to load an audio file:
```python
from audio_carver import *
audio, sampling_rate = load_wavfile('filename.wav')
```
Find the minimum seam:
```python
from audio_carver import *
minimum_energy_seam = min_vertical_seam_energy(magnitude)
```
## Documentation
Documentaion will be uploaded soon.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Contact
Please contact alicjam@uw.edu for questions, suggestions, etc. Thank You!
Raw data
{
"_id": null,
"home_page": "https://github.com/Aloosha2/AudioCarver",
"name": "AudioCarver",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Alicja Misiuda",
"author_email": "alicjam@uw.edu",
"download_url": "https://files.pythonhosted.org/packages/84/f2/a35f84afcee8e0d6d33e2d44119f3ca4f8bc10fdcb18152908404a42a71b/audiocarver-0.1.0.tar.gz",
"platform": null,
"description": "# AudioCarver\nSeam Carving as a Data Augmentation Technique\n\nFor more detail please check out my [website](https://aloosha2.github.io/audio_carver/)\n\n# Audio Processing Library\n\nA Python library for performing seam carving on audio files, converting audio to matrix and back, and generating spectrograms.\n\n\n\n\n## Table of Contents\n- [Installation](#installation)\n- [Usage](#usage)\n- [Features](#features)\n- [Examples](#examples)\n- [Documentation](#documentation)\n- [License](#license)\n- [Contact](#contact)\n\n## Installation\n\nYou can install the library using pip:\n\n```sh\npip install audio_carver\n```\n\n## Usage\n\nExample in a python file:\n\n```python \nfrom audio_carver import carve_audio, sig_to_wav\n\n# Carving in time domain and writing to output\nmagnitude, phase = carve_audio(number_of_seams, magnitude, phase, is_vertical=True) # default true\nsig_to_wav('output.wav', magnitude, phase)\n```\n\n\nExample in terminal(Recommended):\n\n```sh\n$ python main.py <input_file.wav> <number_of_seams> <--carve_time> # remove to carve in frequency\n```\n\n\n## Features\n\nCurrent Supported Audio Formats: .wav\n\nAudio Processing Capabilities: Spectral analysis, Time-domain operations, Signal modification\n\nInput Requirements: None\n\nOutput: Mono signal with sampling rate inherited from the original input file's sampling rate\n\nVIsualization: Spectrogram comparisons of before/after carving \n\n## Examples\n\nHow to load an audio file:\n\n```python \nfrom audio_carver import *\n\naudio, sampling_rate = load_wavfile('filename.wav')\n```\n\nFind the minimum seam:\n\n```python \nfrom audio_carver import *\n\nminimum_energy_seam = min_vertical_seam_energy(magnitude)\n```\n\n## Documentation\n\nDocumentaion will be uploaded soon.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Contact\n\nPlease contact alicjam@uw.edu for questions, suggestions, etc. Thank You!\n",
"bugtrack_url": null,
"license": null,
"summary": "A library built to carve out minimum seams from an audio file",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/Aloosha2/AudioCarver",
"Record of Changes": "https://github.com/Aloosha2/AudioCarver/CHANGELOG.md",
"Source Code": "https://github.com/Aloosha2/AudioCarver/AudioCarver"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a6e135064f61c29827ea7c9c77442500d69fc8c3fb9c06a38d6fc7798245167e",
"md5": "6e772c1dda54364d67bfd62e5f798541",
"sha256": "1cdd258bb8c2a03b540c564e878513f28f545537ea3501e51d1b94c2e9ce34e6"
},
"downloads": -1,
"filename": "AudioCarver-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6e772c1dda54364d67bfd62e5f798541",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 6421,
"upload_time": "2024-08-16T13:43:54",
"upload_time_iso_8601": "2024-08-16T13:43:54.683132Z",
"url": "https://files.pythonhosted.org/packages/a6/e1/35064f61c29827ea7c9c77442500d69fc8c3fb9c06a38d6fc7798245167e/AudioCarver-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "84f2a35f84afcee8e0d6d33e2d44119f3ca4f8bc10fdcb18152908404a42a71b",
"md5": "bdc1091e2fdb5c7773dab40045b4d3e0",
"sha256": "e00c6e0741914e42be497d2566f0d9fd27b3a4c989000fb4931c7bcaa0a53a2f"
},
"downloads": -1,
"filename": "audiocarver-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "bdc1091e2fdb5c7773dab40045b4d3e0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5305,
"upload_time": "2024-08-16T13:43:56",
"upload_time_iso_8601": "2024-08-16T13:43:56.485694Z",
"url": "https://files.pythonhosted.org/packages/84/f2/a35f84afcee8e0d6d33e2d44119f3ca4f8bc10fdcb18152908404a42a71b/audiocarver-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-16 13:43:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Aloosha2",
"github_project": "AudioCarver",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "audiocarver"
}
JSON
