{ "info": { "author": "Aaron Hosford", "author_email": "hosford42@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering :: Artificial Intelligence", "Topic :: Scientific/Engineering :: Image Recognition" ], "description": "# EMNIST\nExtended MNIST - Python Package\n\n## The EMNIST Dataset\n\nThe EMNIST Dataset is an extension to the original MNIST dataset to also include letters. For more details, see\nthe [EMNIST web page](https://www.nist.gov/itl/iad/image-group/emnist-dataset) and the \n[paper](http://arxiv.org/abs/1702.05373) associated with its release:\n\n Cohen, G., Afshar, S., Tapson, J., & van Schaik, A. (2017).\n EMNIST: an extension of MNIST to handwritten letters.\n Retrieved from http://arxiv.org/abs/1702.05373\n\n## The EMNIST Python Package\n\nThis package is a convenience wrapper around the EMNIST Dataset. The package provides functionality to \nautomatically download and cache the dataset, and to load it as numpy arrays, minimizing the boilerplate \nnecessary to make use of the dataset. (NOTE: The author of the Python package is not affiliated in any way \nwith the authors of the dataset and the associated paper.)\n\n## Installation\n\nTo install the EMNIST Python package along with its dependencies, run the following command:\n\n pip install emnist\n\nThe dataset itself is automatically downloaded and cached when needed. To preemptively download the data\nand avoid a delay later during the execution of your program, execute the following command after\ninstallation:\n\n python -c \"import emnist; emnist.ensure_cached_data()\"\n\nAlternately, if you have already downloaded the original IDX-formatted dataset from the EMNIST web page,\ncopy or move it to `~/.cache/emnist/`, where `~` is your home folder, and rename it from `gzip.zip` to \n`emnist.zip`. The package will use the existing file rather than downloading it again.\n\n## Usage\n\nUsage of the EMNIST Python package is designed to be very simple. \n\nTo get a listing of the available subsets:\n\n```python\n >>> from emnist import list_datasets\n >>> list_datasets()\n ['balanced', 'byclass', 'bymerge', 'digits', 'letters', 'mnist']\n```\n\n(See the [EMNIST web page](https://www.nist.gov/itl/iad/image-group/emnist-dataset) for details on each of \nthese subsets.)\n\nTo load the training samples for the 'digits' subset:\n\n```python\n >>> from emnist import extract_training_samples\n >>> images, labels = extract_training_samples('digits')\n >>> images.shape\n (240000, 28, 28)\n >>> labels.shape\n (240000,)\n```\n\nTo load the test samples for the 'digits' subset:\n\n```python\n >>> from emnist import extract_test_samples\n >>> images, labels = extract_test_samples('digits')\n >>> images.shape\n (40000, 28, 28)\n >>> labels.shape\n (40000,)\n```\n\nData is extracted directly from the downloaded compressed file to minimize disk usage, and is returned \nas standard numpy arrays.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/hosford42/EMNIST", "keywords": "MNIST EMNIST image recognition data dataset numpy idx neural networkmachine learning", "license": "", "maintainer": "", "maintainer_email": "", "name": "emnist", "package_url": "https://pypi.org/project/emnist/", "platform": "", "project_url": "https://pypi.org/project/emnist/", "project_urls": { "Homepage": "https://github.com/hosford42/EMNIST", "The EMNIST Dataset": "https://www.nist.gov/itl/iad/image-group/emnist-dataset", "The EMNIST Paper": "https://arxiv.org/abs/1702.05373v1" }, "release_url": "https://pypi.org/project/emnist/0.0/", "requires_dist": [ "numpy", "requests", "tqdm", "matplotlib ; extra == 'inspect'" ], "requires_python": ">=3.0", "summary": "Extended MNIST - Python Package", "version": "0.0" }, "last_serial": 5005084, "releases": { "0.0": [ { "comment_text": "", "digests": { "md5": "f6c36dd714ec2b518d69f4fc849bfd5c", "sha256": "80a3d062aab1f28fc48c895017051d44b3ae17e5bfc4040660714e9b0682d8fc" }, "downloads": -1, "filename": "emnist-0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f6c36dd714ec2b518d69f4fc849bfd5c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0", "size": 7320, "upload_time": "2019-03-29T21:06:47", "url": "https://files.pythonhosted.org/packages/d1/f4/78b24acbef9e8fe976dda700f16a3606f3b8363b015bc555f8050fbbd8ac/emnist-0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2b3358bf6991319b9d0a42528e76b1b8", "sha256": "755fcc4b63ed12740a9842fa9e8b22e4df019fc2d11b1f4bd0495fd56613ef5e" }, "downloads": -1, "filename": "emnist-0.0.tar.gz", "has_sig": false, "md5_digest": "2b3358bf6991319b9d0a42528e76b1b8", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0", "size": 6437, "upload_time": "2019-03-29T21:06:50", "url": "https://files.pythonhosted.org/packages/3a/f3/679ed5798a04b21cbd257e37509f2bbef306815a52e4ef580b0f70ed756f/emnist-0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f6c36dd714ec2b518d69f4fc849bfd5c", "sha256": "80a3d062aab1f28fc48c895017051d44b3ae17e5bfc4040660714e9b0682d8fc" }, "downloads": -1, "filename": "emnist-0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f6c36dd714ec2b518d69f4fc849bfd5c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0", "size": 7320, "upload_time": "2019-03-29T21:06:47", "url": "https://files.pythonhosted.org/packages/d1/f4/78b24acbef9e8fe976dda700f16a3606f3b8363b015bc555f8050fbbd8ac/emnist-0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2b3358bf6991319b9d0a42528e76b1b8", "sha256": "755fcc4b63ed12740a9842fa9e8b22e4df019fc2d11b1f4bd0495fd56613ef5e" }, "downloads": -1, "filename": "emnist-0.0.tar.gz", "has_sig": false, "md5_digest": "2b3358bf6991319b9d0a42528e76b1b8", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0", "size": 6437, "upload_time": "2019-03-29T21:06:50", "url": "https://files.pythonhosted.org/packages/3a/f3/679ed5798a04b21cbd257e37509f2bbef306815a52e4ef580b0f70ed756f/emnist-0.0.tar.gz" } ] }