{ "info": { "author": "Matthias Buechi, Andreas Ahlenstorf", "author_email": "buec@zhaw.ch", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3 :: Only", "Topic :: Scientific/Engineering :: Human Machine Interfaces" ], "description": "\n# AUDIOMATE\n\n[![PyPI](https://img.shields.io/pypi/v/audiomate.svg)](https://pypi.python.org/pypi/audiomate)\n[![Run Status](https://api.shippable.com/projects/5a1d31821e6eda0700091230/badge?branch=master)](https://app.shippable.com/github/ynop/audiomate)\n[![Coverage Badge](https://api.shippable.com/projects/5a1d31821e6eda0700091230/coverageBadge?branch=master)](https://app.shippable.com/github/ynop/audiomate)\n[![Documentation Status](https://readthedocs.org/projects/audiomate/badge/?version=latest)](https://audiomate.readthedocs.io/en/latest/?badge=latest)\n\nAudiomate is a library for easy access to audio datasets.\nIt provides the datastructures for accessing/loading different datasets in a generic way.\nThis should ease the use of audio datasets for example for machine learning tasks.\n\n```python\nimport audiomate\nfrom audiomate.corpus import io\n\n# Download a dataset\nesc_downloader = io.ESC50Downloader()\nesc_downloader.download('/local/path')\n\n# Load and work with the dataset\nesc50 = audiomate.Corpus.load('/local/path', reader='esc-50')\n\n# e.g. Read the audio signal and the label of specific sample/utterance\nutterance = esc50.utterances['1-100032-A-0']\nsamples = utterance.read_samples()\nlabel = utterance.label_lists[audiomate.corpus.LL_SOUND_CLASS][0].value\n```\n\nFurthermore it provides tools for interacting with datasets\n(validation, splitting, subsets, merge, filter), extracting features,\nfeeding samples for training ML models and more.\n\n* [Documentation](https://audiomate.readthedocs.io)\n* [Examples](https://github.com/ynop/audiomate/tree/master/examples)\n* [Changelog](https://audiomate.readthedocs.io/en/latest/notes/changelog.html)\n\nCurrently supported datasets:\n* [Acoustic Event Dataset](https://data.vision.ee.ethz.ch/cvl/ae_dataset/)\n* [AudioMNIST](https://github.com/soerenab/AudioMNIST)\n* [Mozilla Common Voice](https://voice.mozilla.org/)\n* [ESC-50](https://github.com/karoldvl/ESC-50)\n* [Free Spoken Digit Dataset](https://github.com/Jakobovski/free-spoken-digit-dataset)\n* [German Distant Speech Corpus](https://www.inf.uni-hamburg.de/en/inst/ab/lt/resources/data/acoustic-models.html)\n* [Google Speech Commands](https://research.googleblog.com/2017/08/launching-speech-commands-dataset.html)\n* [GTZAN](https://marsyasweb.appspot.com/download/data_sets/)\n* [M-AILABS Speech Dataset](http://www.m-ailabs.bayern/en/the-mailabs-speech-dataset/)\n* [MUSAN](http://www.openslr.org/17/)\n* [LITIS Rouen Audio scene dataset](https://sites.google.com/site/alainrakotomamonjy/home/audio-scene)\n* [Tatoeba](https://tatoeba.org/)\n* [TIMIT](https://github.com/philipperemy/timit)\n* [Urbansound8k](http://urbansounddataset.weebly.com/urbansound8k.html)\n* [Voxforge](http://www.voxforge.org/de)\n\nCurrently supported formats:\n* [Kaldi](http://kaldi-asr.org/)\n* [Mozilla DeepSpeech](https://github.com/mozilla/DeepSpeech)\n* [Custom Formats](https://ynop.github.io/audiomate/documentation/formats.html)\n\nIndirectly supported datasets ([Details](https://audiomate.readthedocs.io/en/latest/documentation/indirect_support.html)):\n* [Spoken Wikipedia Corpora](https://nats.gitlab.io/swc/)\n\n## Installation\n\n```sh\npip install audiomate\n```\n\nInstall the latest development version:\n\n```sh\npip install git+https://github.com/ynop/audiomate.git\n```\n\n## Development\n\n### Prerequisites\n\n* [A supported version of Python 3](https://docs.python.org/devguide/index.html#status-of-python-branches)\n\nIt's recommended to use a virtual environment when developing audiomate.\nTo create one, execute the following command in the project's root directory:\n\n```\npython -m venv .\n```\n\nTo install audiomate and all it's dependencies, execute:\n\n```\npip install -e .\n```\n\n### Running the test suite\n\n```\npip install -e .[dev]\npython setup.py test\n```\n\nWith PyCharm you might have to change the default test runner. Otherwise, it might only suggest to use nose. To do so, go to File > Settings > Tools > Python Integrated Tools (on the Mac it's PyCharm > Preferences > Settings > Tools > Python Integrated Tools) and change the test runner to py.test.\n\n### Benchmarks\n\nIn order to check the runtime of specific parts, ``pytest-benchmark`` is used. Benchmarks are normal test functions, but call the benchmark fixture for the code under test.\n\nTo run benchmarks:\n\n```\n# Run all\npytest bench\n\n# Specific benchmark\npytest bench/corpus/test_merge_corpus.py\n```\n\nTo compare between different runs:\n\n```\npytest-benchmark compare\n```\n\n### Editing the Documentation\n\nThe documentation is written in [reStructuredText](http://docutils.sourceforge.net/rst.html) and transformed into various output formats with the help of [Sphinx](http://www.sphinx-doc.org/).\n\n* [Syntax reference reStructuredText](http://docutils.sourceforge.net/docs/user/rst/quickref.html)\n* [Sphinx-specific additions to reStructuredText](http://www.sphinx-doc.org/en/stable/markup/index.html)\n\nTo generate the documentation, execute:\n\n```\npip install -e .[dev]\ncd docs\nmake html\n```\n\nThe generated files are written to `docs/_build/html`.\n\n### Versions\n\nVersions is handled using [bump2version](https://github.com/c4urself/bump2version). To bump the version:\n\n```\nbump2version [major,minor,patch,release,num]\n```\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "https://github.com/ynop/audiomate/releases", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ynop/audiomate", "keywords": "audio music sound corpus dataset", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "audiomate", "package_url": "https://pypi.org/project/audiomate/", "platform": "", "project_url": "https://pypi.org/project/audiomate/", "project_urls": { "Download": "https://github.com/ynop/audiomate/releases", "Homepage": "https://github.com/ynop/audiomate" }, "release_url": "https://pypi.org/project/audiomate/4.0.1/", "requires_dist": [ "llvmlite (==0.29.0)", "audioread (==2.1.6)", "numpy (==1.16.2)", "scipy (==1.2.1)", "librosa (==0.6.3)", "h5py (==2.9.0)", "networkx (==2.2)", "beautifulsoup4 (==4.7.1)", "lxml (==4.3.2)", "requests (==2.21.0)", "intervaltree (==3.0.2)", "flake8 (==3.6.0); extra == 'ci'", "flake8-quotes (==0.12.1); extra == 'ci'", "click (==6.7); extra == 'dev'", "pytest (==4.0.0); extra == 'dev'", "pytest-runner (==3.0); extra == 'dev'", "pytest-cov (==2.5.1); extra == 'dev'", "requests-mock (==1.4.0); extra == 'dev'", "Sphinx (==1.8.5); extra == 'dev'", "sphinx-rtd-theme (==0.4.3); extra == 'dev'", "pytest-benchmark (==3.1.1); extra == 'dev'" ], "requires_python": "", "summary": "Audiomate is a library for working with audio datasets.", "version": "4.0.1" }, "last_serial": 5372903, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "6c830166e77ebf29c978713882743f42", "sha256": "f6bcf9c6a27b7f0c3c902bc8dca8631dc81e8e8991238d4abee4588baa0eac78" }, "downloads": -1, "filename": "audiomate-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "6c830166e77ebf29c978713882743f42", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 116600, "upload_time": "2018-05-18T13:16:39", "url": "https://files.pythonhosted.org/packages/87/9d/d69a2c3bad3bf6d826a0905775c63e7ee451d5c0d079cfe1163adc66f15c/audiomate-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d25b180f418206d1b0fc5211d7648810", "sha256": "04692b9f3ae231db781789b01ecb4c9feb7762d7b53ae697fe39ef3530fffd37" }, "downloads": -1, "filename": "audiomate-0.1.0.tar.gz", "has_sig": false, "md5_digest": "d25b180f418206d1b0fc5211d7648810", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 80621, "upload_time": "2018-05-18T13:16:40", "url": "https://files.pythonhosted.org/packages/57/06/1748c7e3cbd28b5fdf03ef1981eea85711ad3bf9041cc7d1186af0c594d3/audiomate-0.1.0.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "7e6debbae50ec8f5bd509aec0c6263a7", "sha256": "771a7a7efa5ca615a58cedf717b9dd6fdc331357018e2ccaa9979aa716516b7c" }, "downloads": -1, "filename": "audiomate-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "7e6debbae50ec8f5bd509aec0c6263a7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 127405, "upload_time": "2018-06-01T14:07:32", "url": "https://files.pythonhosted.org/packages/25/9e/b1496119ee875986cae418ecb89a74b702dea9e970a0204ce89833fec609/audiomate-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "14533767119ced491d16adc542a6c7d3", "sha256": "c39703cd7099f270fa10aaeeb6f3f12884e9c9479a150ba0aaed83ab9c05feb8" }, "downloads": -1, "filename": "audiomate-1.0.0.tar.gz", "has_sig": false, "md5_digest": "14533767119ced491d16adc542a6c7d3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 89892, "upload_time": "2018-06-01T14:07:34", "url": "https://files.pythonhosted.org/packages/73/36/5eaa0374b93b3caf6a9d5cfcb5868af6b293f2a9db38a29963b0b78cf133/audiomate-1.0.0.tar.gz" } ], "2.0.0": [ { "comment_text": "", "digests": { "md5": "27120d3a305c9ba3ada783a3c86a2656", "sha256": "17e61f8449566d97e4621755f0a935b97098226677e51fb23ad77389ebddba5c" }, "downloads": -1, "filename": "audiomate-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "27120d3a305c9ba3ada783a3c86a2656", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 137494, "upload_time": "2018-08-27T15:24:23", "url": "https://files.pythonhosted.org/packages/0b/d4/8a35a17dd3f1031381f8918bff7b9255f29eb22e7a3abd7602092b95317e/audiomate-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "48573801e1c2d9e2c4b26663ebc8c578", "sha256": "c65720ee0ed47237ba1d1fdc0c815614c1fca6bb950dd749dac2205d04a1c746" }, "downloads": -1, "filename": "audiomate-2.0.0.tar.gz", "has_sig": false, "md5_digest": "48573801e1c2d9e2c4b26663ebc8c578", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 94984, "upload_time": "2018-08-27T15:24:25", "url": "https://files.pythonhosted.org/packages/97/3b/1f9a0e0fbf68472e1f63334b46e9a1fee4b27828778217be0105885e7cfc/audiomate-2.0.0.tar.gz" } ], "3.0.0": [ { "comment_text": "", "digests": { "md5": "a6cb0ed9eab561a536d0bf2341a42e6f", "sha256": "0b769e3cb2818b6e875e84081b93606d68bb5c9b8a938fdbce268e936fde84a7" }, "downloads": -1, "filename": "audiomate-3.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "a6cb0ed9eab561a536d0bf2341a42e6f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 199031, "upload_time": "2018-11-21T10:00:52", "url": "https://files.pythonhosted.org/packages/ea/d8/cbf6b1932952cbb7a96d56ff2522471787582fbc4e85040417172ca46c5f/audiomate-3.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "23a879d0efefbe7b48678ca3a0a4d76d", "sha256": "90b6a2c5aa595cb3edf0afec5be964c5314096ebc950549e7c7a2effe57b2069" }, "downloads": -1, "filename": "audiomate-3.0.0.tar.gz", "has_sig": false, "md5_digest": "23a879d0efefbe7b48678ca3a0a4d76d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 134272, "upload_time": "2018-11-21T10:00:53", "url": "https://files.pythonhosted.org/packages/db/bf/aea35825fb045ce37d4108d1efd7a1eb9886fd7233a7729e6fbe25ffa15f/audiomate-3.0.0.tar.gz" } ], "4.0.0": [ { "comment_text": "", "digests": { "md5": "59a2d1377a319d8901ed554a7728529e", "sha256": "20b5e1d8a94155b2773a8590e5ab55521fc36cf32f30bbf9bfdabf0b2ba836ea" }, "downloads": -1, "filename": "audiomate-4.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "59a2d1377a319d8901ed554a7728529e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 212115, "upload_time": "2019-06-07T17:34:08", "url": "https://files.pythonhosted.org/packages/d3/37/db90a02ed8e07dd6725c3e4ef0ee11966cb4b869f4e0c01aa07adb8d079c/audiomate-4.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b74b0d4ceb9b1d4440e9800936f10a36", "sha256": "38e3136ba3dbd3264a1029ba55f85c11283c2a4155dc983cb7b908bb585640b8" }, "downloads": -1, "filename": "audiomate-4.0.0.tar.gz", "has_sig": false, "md5_digest": "b74b0d4ceb9b1d4440e9800936f10a36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 143590, "upload_time": "2019-06-07T17:34:10", "url": "https://files.pythonhosted.org/packages/c5/47/dfa88de1e98605ec90d6575f1c21300b526e180a27ff78c27e556ca1f7b4/audiomate-4.0.0.tar.gz" } ], "4.0.1": [ { "comment_text": "", "digests": { "md5": "0eba5297014bd59599ba97c2c11d6fd6", "sha256": "a7b6cf0c8c9456bbff63a24c8a1e5edabf7af1f6a7ae68da552e8afbc81bd401" }, "downloads": -1, "filename": "audiomate-4.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "0eba5297014bd59599ba97c2c11d6fd6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 212116, "upload_time": "2019-06-07T19:39:44", "url": "https://files.pythonhosted.org/packages/f1/31/7f97523a500fa4c7b6af2f75ae1874c86242d72c853af1355e4127d486ee/audiomate-4.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1012a50c8419b8e4f1fd90f44bd99e90", "sha256": "71b42cd479ed5206023adba111360cad44c968af5fda9406f952486446c8e9dc" }, "downloads": -1, "filename": "audiomate-4.0.1.tar.gz", "has_sig": false, "md5_digest": "1012a50c8419b8e4f1fd90f44bd99e90", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 143585, "upload_time": "2019-06-07T19:39:47", "url": "https://files.pythonhosted.org/packages/1c/7d/addfe868bd7cb5cafc5c0ae9480176c3949ce67373fcab029a916fa7b99d/audiomate-4.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0eba5297014bd59599ba97c2c11d6fd6", "sha256": "a7b6cf0c8c9456bbff63a24c8a1e5edabf7af1f6a7ae68da552e8afbc81bd401" }, "downloads": -1, "filename": "audiomate-4.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "0eba5297014bd59599ba97c2c11d6fd6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 212116, "upload_time": "2019-06-07T19:39:44", "url": "https://files.pythonhosted.org/packages/f1/31/7f97523a500fa4c7b6af2f75ae1874c86242d72c853af1355e4127d486ee/audiomate-4.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1012a50c8419b8e4f1fd90f44bd99e90", "sha256": "71b42cd479ed5206023adba111360cad44c968af5fda9406f952486446c8e9dc" }, "downloads": -1, "filename": "audiomate-4.0.1.tar.gz", "has_sig": false, "md5_digest": "1012a50c8419b8e4f1fd90f44bd99e90", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 143585, "upload_time": "2019-06-07T19:39:47", "url": "https://files.pythonhosted.org/packages/1c/7d/addfe868bd7cb5cafc5c0ae9480176c3949ce67373fcab029a916fa7b99d/audiomate-4.0.1.tar.gz" } ] }