gladia-torchaudio


Namegladia-torchaudio JSON
Version 2.1.0a0 PyPI version JSON
download
home_pagehttps://github.com/pytorch/audio
SummaryAn audio package for PyTorch
upload_time2023-06-14 06:24:57
maintainerMoto Hira, Caroline Chen, Jeff Hwang, Zhaoheng Ni, Xiaohui Zhang
docs_urlNone
authorSoumith Chintala, David Pollack, Sean Naren, Peter Goldsborough, Moto Hira, Caroline Chen, Jeff Hwang, Zhaoheng Ni, Xiaohui Zhang
requires_python
license
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            torchaudio: an audio library for PyTorch
========================================

[![Documentation](https://img.shields.io/badge/dynamic/json.svg?label=docs&url=https%3A%2F%2Fpypi.org%2Fpypi%2Ftorchaudio%2Fjson&query=%24.info.version&colorB=brightgreen&prefix=v)](https://pytorch.org/audio/main/)
[![Anaconda Badge](https://anaconda.org/pytorch/torchaudio/badges/downloads.svg)](https://anaconda.org/pytorch/torchaudio)
[![Anaconda-Server Badge](https://anaconda.org/pytorch/torchaudio/badges/platforms.svg)](https://anaconda.org/pytorch/torchaudio)

![TorchAudio Logo](docs/source/_static/img/logo.png)

The aim of torchaudio is to apply [PyTorch](https://github.com/pytorch/pytorch) to
the audio domain. By supporting PyTorch, torchaudio follows the same philosophy
of providing strong GPU acceleration, having a focus on trainable features through
the autograd system, and having consistent style (tensor names and dimension names).
Therefore, it is primarily a machine learning library and not a general signal
processing library. The benefits of PyTorch can be seen in torchaudio through
having all the computations be through PyTorch operations which makes it easy
to use and feel like a natural extension.

- [Support audio I/O (Load files, Save files)](http://pytorch.org/audio/main/)
  - Load a variety of audio formats, such as `wav`, `mp3`, `ogg`, `flac`, `opus`, `sphere`, into a torch Tensor using SoX
  - [Kaldi (ark/scp)](http://pytorch.org/audio/main/kaldi_io.html)
- [Dataloaders for common audio datasets](http://pytorch.org/audio/main/datasets.html)
- Common audio transforms
    - [Spectrogram, AmplitudeToDB, MelScale, MelSpectrogram, MFCC, MuLawEncoding, MuLawDecoding, Resample](http://pytorch.org/audio/main/transforms.html)
- Compliance interfaces: Run code using PyTorch that align with other libraries
    - [Kaldi: spectrogram, fbank, mfcc](https://pytorch.org/audio/main/compliance.kaldi.html)

Installation
------------

Please refer to https://pytorch.org/audio/main/installation.html for installation and build process of TorchAudio.

Quick Usage
-----------

```python
import torchaudio

waveform, sample_rate = torchaudio.load('foo.wav')  # load tensor from file
torchaudio.save('foo_save.wav', waveform, sample_rate)  # save tensor to file
```

Backend Dispatch
----------------

By default in OSX and Linux, torchaudio uses SoX as a backend to load and save files.
The backend can be changed to [SoundFile](https://pysoundfile.readthedocs.io/en/latest/)
using the following. See [SoundFile](https://pysoundfile.readthedocs.io/en/latest/)
for installation instructions.

```python
import torchaudio
torchaudio.set_audio_backend("soundfile")  # switch backend

waveform, sample_rate = torchaudio.load('foo.wav')  # load tensor from file, as usual
torchaudio.save('foo_save.wav', waveform, sample_rate)  # save tensor to file, as usual
```

**Note**
- SoundFile currently does not support mp3.
- "soundfile" backend is not supported by TorchScript.

API Reference
-------------

API Reference is located here: http://pytorch.org/audio/main/

Contributing Guidelines
-----------------------

Please refer to [CONTRIBUTING.md](./CONTRIBUTING.md)

Citation
--------

If you find this package useful, please cite as:

```bibtex
@article{yang2021torchaudio,
  title={TorchAudio: Building Blocks for Audio and Speech Processing},
  author={Yao-Yuan Yang and Moto Hira and Zhaoheng Ni and Anjali Chourdia and Artyom Astafurov and Caroline Chen and Ching-Feng Yeh and Christian Puhrsch and David Pollack and Dmitriy Genzel and Donny Greenberg and Edward Z. Yang and Jason Lian and Jay Mahadeokar and Jeff Hwang and Ji Chen and Peter Goldsborough and Prabhat Roy and Sean Narenthiran and Shinji Watanabe and Soumith Chintala and Vincent Quenneville-BĂ©lair and Yangyang Shi},
  journal={arXiv preprint arXiv:2110.15018},
  year={2021}
}
```

Disclaimer on Datasets
----------------------

This is a utility library that downloads and prepares public datasets. We do not host or distribute these datasets, vouch for their quality or fairness, or claim that you have license to use the dataset. It is your responsibility to determine whether you have permission to use the dataset under the dataset's license.

If you're a dataset owner and wish to update any part of it (description, citation, etc.), or do not want your dataset to be included in this library, please get in touch through a GitHub issue. Thanks for your contribution to the ML community!

Pre-trained Model License
-------------------------

The pre-trained models provided in this library may have their own licenses or terms and conditions derived from the dataset used for training. It is your responsibility to determine whether you have permission to use the models for your use case.

For instance, SquimSubjective model is released under the Creative Commons Attribution Non Commercial 4.0 International (CC-BY-NC 4.0) license. See [the link](https://zenodo.org/record/4660670#.ZBtWPOxuerN) for additional details.

Other pre-trained models that have different license are noted in documentation. Please checkout the [documentation page](https://pytorch.org/audio/main/).



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pytorch/audio",
    "name": "gladia-torchaudio",
    "maintainer": "Moto Hira, Caroline Chen, Jeff Hwang, Zhaoheng Ni, Xiaohui Zhang",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "moto@meta.com",
    "keywords": "",
    "author": "Soumith Chintala, David Pollack, Sean Naren, Peter Goldsborough, Moto Hira, Caroline Chen, Jeff Hwang, Zhaoheng Ni, Xiaohui Zhang",
    "author_email": "soumith@pytorch.org",
    "download_url": "https://files.pythonhosted.org/packages/ba/56/73c823ae055c5a265a9162744a3e4928cd43644724682ec0358a0586bc37/gladia-torchaudio-2.1.0a0.tar.gz",
    "platform": null,
    "description": "torchaudio: an audio library for PyTorch\n========================================\n\n[![Documentation](https://img.shields.io/badge/dynamic/json.svg?label=docs&url=https%3A%2F%2Fpypi.org%2Fpypi%2Ftorchaudio%2Fjson&query=%24.info.version&colorB=brightgreen&prefix=v)](https://pytorch.org/audio/main/)\n[![Anaconda Badge](https://anaconda.org/pytorch/torchaudio/badges/downloads.svg)](https://anaconda.org/pytorch/torchaudio)\n[![Anaconda-Server Badge](https://anaconda.org/pytorch/torchaudio/badges/platforms.svg)](https://anaconda.org/pytorch/torchaudio)\n\n![TorchAudio Logo](docs/source/_static/img/logo.png)\n\nThe aim of torchaudio is to apply [PyTorch](https://github.com/pytorch/pytorch) to\nthe audio domain. By supporting PyTorch, torchaudio follows the same philosophy\nof providing strong GPU acceleration, having a focus on trainable features through\nthe autograd system, and having consistent style (tensor names and dimension names).\nTherefore, it is primarily a machine learning library and not a general signal\nprocessing library. The benefits of PyTorch can be seen in torchaudio through\nhaving all the computations be through PyTorch operations which makes it easy\nto use and feel like a natural extension.\n\n- [Support audio I/O (Load files, Save files)](http://pytorch.org/audio/main/)\n  - Load a variety of audio formats, such as `wav`, `mp3`, `ogg`, `flac`, `opus`, `sphere`, into a torch Tensor using SoX\n  - [Kaldi (ark/scp)](http://pytorch.org/audio/main/kaldi_io.html)\n- [Dataloaders for common audio datasets](http://pytorch.org/audio/main/datasets.html)\n- Common audio transforms\n    - [Spectrogram, AmplitudeToDB, MelScale, MelSpectrogram, MFCC, MuLawEncoding, MuLawDecoding, Resample](http://pytorch.org/audio/main/transforms.html)\n- Compliance interfaces: Run code using PyTorch that align with other libraries\n    - [Kaldi: spectrogram, fbank, mfcc](https://pytorch.org/audio/main/compliance.kaldi.html)\n\nInstallation\n------------\n\nPlease refer to https://pytorch.org/audio/main/installation.html for installation and build process of TorchAudio.\n\nQuick Usage\n-----------\n\n```python\nimport torchaudio\n\nwaveform, sample_rate = torchaudio.load('foo.wav')  # load tensor from file\ntorchaudio.save('foo_save.wav', waveform, sample_rate)  # save tensor to file\n```\n\nBackend Dispatch\n----------------\n\nBy default in OSX and Linux, torchaudio uses SoX as a backend to load and save files.\nThe backend can be changed to [SoundFile](https://pysoundfile.readthedocs.io/en/latest/)\nusing the following. See [SoundFile](https://pysoundfile.readthedocs.io/en/latest/)\nfor installation instructions.\n\n```python\nimport torchaudio\ntorchaudio.set_audio_backend(\"soundfile\")  # switch backend\n\nwaveform, sample_rate = torchaudio.load('foo.wav')  # load tensor from file, as usual\ntorchaudio.save('foo_save.wav', waveform, sample_rate)  # save tensor to file, as usual\n```\n\n**Note**\n- SoundFile currently does not support mp3.\n- \"soundfile\" backend is not supported by TorchScript.\n\nAPI Reference\n-------------\n\nAPI Reference is located here: http://pytorch.org/audio/main/\n\nContributing Guidelines\n-----------------------\n\nPlease refer to [CONTRIBUTING.md](./CONTRIBUTING.md)\n\nCitation\n--------\n\nIf you find this package useful, please cite as:\n\n```bibtex\n@article{yang2021torchaudio,\n  title={TorchAudio: Building Blocks for Audio and Speech Processing},\n  author={Yao-Yuan Yang and Moto Hira and Zhaoheng Ni and Anjali Chourdia and Artyom Astafurov and Caroline Chen and Ching-Feng Yeh and Christian Puhrsch and David Pollack and Dmitriy Genzel and Donny Greenberg and Edward Z. Yang and Jason Lian and Jay Mahadeokar and Jeff Hwang and Ji Chen and Peter Goldsborough and Prabhat Roy and Sean Narenthiran and Shinji Watanabe and Soumith Chintala and Vincent Quenneville-B\u00e9lair and Yangyang Shi},\n  journal={arXiv preprint arXiv:2110.15018},\n  year={2021}\n}\n```\n\nDisclaimer on Datasets\n----------------------\n\nThis is a utility library that downloads and prepares public datasets. We do not host or distribute these datasets, vouch for their quality or fairness, or claim that you have license to use the dataset. It is your responsibility to determine whether you have permission to use the dataset under the dataset's license.\n\nIf you're a dataset owner and wish to update any part of it (description, citation, etc.), or do not want your dataset to be included in this library, please get in touch through a GitHub issue. Thanks for your contribution to the ML community!\n\nPre-trained Model License\n-------------------------\n\nThe pre-trained models provided in this library may have their own licenses or terms and conditions derived from the dataset used for training. It is your responsibility to determine whether you have permission to use the models for your use case.\n\nFor instance, SquimSubjective model is released under the Creative Commons Attribution Non Commercial 4.0 International (CC-BY-NC 4.0) license. See [the link](https://zenodo.org/record/4660670#.ZBtWPOxuerN) for additional details.\n\nOther pre-trained models that have different license are noted in documentation. Please checkout the [documentation page](https://pytorch.org/audio/main/).\n\n\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "An audio package for PyTorch",
    "version": "2.1.0a0",
    "project_urls": {
        "Homepage": "https://github.com/pytorch/audio"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "bec6f26332bead1b0767e5ceedf99344a73621e7a2fbeb1c63c25db19cb70763",
                "md5": "6bd3abe2964086385e843b889a4d0373",
                "sha256": "89c402f2c3eb2d6cc16627dd7d74219a5c3f1600d0fb59ccb183ec0ce359a6bc"
            },
            "downloads": -1,
            "filename": "gladia_torchaudio-2.1.0a0-py3.8-linux-x86_64.egg",
            "has_sig": false,
            "md5_digest": "6bd3abe2964086385e843b889a4d0373",
            "packagetype": "bdist_egg",
            "python_version": "2.1.0a0",
            "requires_python": null,
            "size": 3006090,
            "upload_time": "2023-06-14T06:24:55",
            "upload_time_iso_8601": "2023-06-14T06:24:55.904500Z",
            "url": "https://files.pythonhosted.org/packages/be/c6/f26332bead1b0767e5ceedf99344a73621e7a2fbeb1c63c25db19cb70763/gladia_torchaudio-2.1.0a0-py3.8-linux-x86_64.egg",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "dffadc9c0b4bdfafbee330f88524743e92b053cbe3f3e651b4e3840a89b5a1bb",
                "md5": "0e9ea71c472b658a4ab0c79202ed1443",
                "sha256": "816cde24433550c42722d05d324fe93e07e672ed67bcdd25bafdab660cd9f8bc"
            },
            "downloads": -1,
            "filename": "gladia_torchaudio-2.1.0a0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0e9ea71c472b658a4ab0c79202ed1443",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 2577189,
            "upload_time": "2023-06-14T06:24:52",
            "upload_time_iso_8601": "2023-06-14T06:24:52.818727Z",
            "url": "https://files.pythonhosted.org/packages/df/fa/dc9c0b4bdfafbee330f88524743e92b053cbe3f3e651b4e3840a89b5a1bb/gladia_torchaudio-2.1.0a0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ba5673c823ae055c5a265a9162744a3e4928cd43644724682ec0358a0586bc37",
                "md5": "dff3c490daa25b550ba016e124101796",
                "sha256": "6387650da4933e6b8f712e4428192333820f4bcf86676d8d84cb6f50286b4da8"
            },
            "downloads": -1,
            "filename": "gladia-torchaudio-2.1.0a0.tar.gz",
            "has_sig": false,
            "md5_digest": "dff3c490daa25b550ba016e124101796",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 267374,
            "upload_time": "2023-06-14T06:24:57",
            "upload_time_iso_8601": "2023-06-14T06:24:57.763687Z",
            "url": "https://files.pythonhosted.org/packages/ba/56/73c823ae055c5a265a9162744a3e4928cd43644724682ec0358a0586bc37/gladia-torchaudio-2.1.0a0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-06-14 06:24:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pytorch",
    "github_project": "audio",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "gladia-torchaudio"
}
        
Elapsed time: 0.26667s