{"id":15688055,"url":"https://github.com/eonu/torch-fsdd","last_synced_at":"2025-05-07T20:11:23.678Z","repository":{"id":52504392,"uuid":"358839054","full_name":"eonu/torch-fsdd","owner":"eonu","description":"A utility for wrapping the Free Spoken Digit Dataset into PyTorch-ready data set splits.","archived":false,"fork":false,"pushed_at":"2022-12-27T20:42:26.000Z","size":15561,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T08:41:46.287Z","etag":null,"topics":["audio","audio-dataset","data-loader","free-spoken-digit-dataset","fsdd","pytorch-dataloader","pytorch-dataset","pytorch-dataset-split","torch","torchaudio"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eonu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-17T09:37:42.000Z","updated_at":"2024-03-05T18:45:46.000Z","dependencies_parsed_at":"2023-01-31T05:16:11.050Z","dependency_job_id":null,"html_url":"https://github.com/eonu/torch-fsdd","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eonu%2Ftorch-fsdd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eonu%2Ftorch-fsdd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eonu%2Ftorch-fsdd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eonu%2Ftorch-fsdd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eonu","download_url":"https://codeload.github.com/eonu/torch-fsdd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252949279,"owners_count":21830152,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-dataset","data-loader","free-spoken-digit-dataset","fsdd","pytorch-dataloader","pytorch-dataset","pytorch-dataset-split","torch","torchaudio"],"created_at":"2024-10-03T17:54:12.730Z","updated_at":"2025-05-07T20:11:23.649Z","avatar_url":"https://github.com/eonu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  TorchFSDD\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eA utility for wrapping the Free Spoken Digit Dataset into PyTorch-ready data set splits.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/torchfsdd\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/v/torchfsdd?style=flat-square\" alt=\"PyPI\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/torchfsdd\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/pyversions/torchfsdd?style=flat-square\" alt=\"PyPI - Python Version\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://raw.githubusercontent.com/eonu/torchfsdd/master/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/l/torchfsdd?style=flat-square\" alt=\"PyPI - License\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://torch-fsdd.readthedocs.io/en/latest/\"\u003e\n    \u003cimg src=\"https://readthedocs.org/projects/torch-fsdd/badge/?version=latest\u0026style=flat-square\" alt=\"Read The Docs - Documentation\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## About\n\nThe [Free Spoken Digit Dataset](https://github.com/Jakobovski/free-spoken-digit-dataset) is an open data set consisting of audio recordings of various individuals speaking the digits from 0-9, with 50 recordings of each digit per individual.\n\nThe data set can be thought of as an audio version of the popular [MNIST data set](https://en.wikipedia.org/wiki/MNIST_database) which consists of hand-written digits. However, the fact that the data consists of recordings of different durations makes it more challenging to deal with than the fixed-size images of MNIST.\n\nTorchFSDD aims to provide an interface to FSDD for PyTorch model development, by providing a [`torch.utils.data.Dataset`](https://pytorch.org/docs/stable/data.html#torch.utils.data.Dataset) wrapper that is ready to be used with a [`torch.utils.data.DataLoader`](https://pytorch.org/docs/stable/data.html#torch.utils.data.DataLoader).\n\n## Build status\n\n| `master` | `dev` |\n| -------- | ------|\n| [![CircleCI Build (Master)](https://img.shields.io/circleci/build/github/eonu/torch-fsdd/master?logo=circleci\u0026style=flat-square)](https://app.circleci.com/pipelines/github/eonu/torch-fsdd?branch=master) | [![CircleCI Build (Development)](https://img.shields.io/circleci/build/github/eonu/torch-fsdd/dev?logo=circleci\u0026style=flat-square)](https://app.circleci.com/pipelines/github/eonu/torch-fsdd?branch=master) |\n\n## Examples\n\n```python\nfrom torchfsdd import TorchFSDDGenerator, TrimSilence\nfrom torchaudio.transforms import MFCC\nfrom torchvision.transforms import Compose\n\n# Create a transformation pipeline to apply to the recordings\ntransforms = Compose([\n    TrimSilence(threshold=1e-6),\n    MFCC(sample_rate=8e3, n_mfcc=13)\n])\n\n# Fetch the latest version of FSDD and initialize a generator with those files\nfsdd = TorchFSDDGenerator(version='master', transforms=transforms)\n\n# Create a Torch dataset for the entire dataset from the generator\nfull_set = fsdd.full()\n# Create two Torch datasets for a train-test split from the generator\ntrain_set, test_set = fsdd.train_test_split(test_size=0.1)\n# Create three Torch datasets for a train-validation-test split from the generator\ntrain_set, val_set, test_set = fsdd.train_val_test_split(test_size=0.15, val_size=0.15)\n```\n\nA more complete example can be found [here](./notebooks), showing how TorchFSDD can be used to train a neural network.\n\n## Installation\n\nYou can install TorchFSDD using `pip`.\n\n```console\npip install torchfsdd\n```\n\n**Note**: TorchFSDD assumes you have the following packages already installed (along with Python v3.6+).\n\n- [`torch`](https://github.com/pytorch/pytorch) (\u003e= 1.8.0)\n- [`torchaudio`](https://github.com/pytorch/audio) (\u003e= 0.8.0)\n\nSince there are many different possible configurations when installing PyTorch (e.g. CPU or GPU, CUDA version), we leave this up to the user instead of specifying particular versions to install alongside TorchFSDD.\n\nMake sure you have `torch` and `torchaudio` versions that are [compatible](https://github.com/pytorch/audio#dependencies)!\n\n\u003e If you _really_ wish to install `torch` and `torchaudio` together with TorchFSDD automatically, the following will install CPU-only versions of both dependencies.\n\u003e\n\u003e ```console\n\u003e pip install torchfsdd[torch]\n\u003e ```\n\n### Development\n\nPlease see the [contribution guidelines](/CONTRIBUTING.md) to see installation instructions for contributing to this repository.\n\n## Documentation\n\nDocumentation for the package is available on [Read The Docs](https://torch-fsdd.readthedocs.io/en/latest).\n\n## Contributors\n\nAll contributions to this repository are greatly appreciated. Contribution guidelines can be found [here](/CONTRIBUTING.md).\n\n\u003ctable\u003e\n\t\u003cthead\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003cth align=\"center\"\u003e\n        \u003ca href=\"https://github.com/eonu\"\u003e\n          \u003cimg src=\"https://avatars0.githubusercontent.com/u/24795571?s=460\u0026v=4\" alt=\"eonu\" width=\"60px\"\u003e\n          \u003cbr/\u003e\u003csub\u003e\u003cb\u003eeonu\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n\t\t\t\u003c/th\u003e\n      \u003cth align=\"center\"\u003e\n        \u003ca href=\"https://github.com/black-puppydog\"\u003e\n          \u003cimg src=\"https://avatars.githubusercontent.com/u/189241?v=4\" alt=\"black-puppydog\" width=\"60px\"\u003e\n          \u003cbr/\u003e\u003csub\u003e\u003cb\u003eblack-puppydog\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n\t\t\t\u003c/th\u003e\n\t\t\t\u003c!-- Add more \u003cth\u003e\u003c/th\u003e blocks for more contributors --\u003e\n\t\t\u003c/tr\u003e\n\t\u003c/thead\u003e\n\u003c/table\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eTorchFSDD\u003c/b\u003e \u0026copy; 2021-2023, Edwin Onuonga - Released under the \u003ca href=\"https://opensource.org/licenses/MIT\"\u003eMIT\u003c/a\u003e License.\u003cbr/\u003e\n  \u003cem\u003eAuthored and maintained by Edwin Onuonga.\u003c/em\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feonu%2Ftorch-fsdd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feonu%2Ftorch-fsdd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feonu%2Ftorch-fsdd/lists"}