#### NOTE
This is a **Hugging Face dataset**. For large datasets, ensure `huggingface_hub>=1.1.3` to avoid rate limits. Learn more in the <a href="https://docs.voxel51.com/integrations/huggingface.html#loading-datasets-from-the-hub" target="_blank">Hugging Face integration docs</a>.

<a href="https://huggingface.co/datasets/Voxel51/USPS" target="_blank">![Hugging Face](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Dataset-yellow)</a>

# Dataset Card for usps

<!-- Provide a quick summary of the dataset. -->

![image/png](https://huggingface.co/datasets/Voxel51/USPS/resolve/main/dataset_preview.jpg)

This is a [FiftyOne](https://github.com/voxel51/fiftyone) dataset with 9298 samples.

## Installation

If you haven’t already, install FiftyOne:

```bash
pip install -U fiftyone
```

## Usage

```python
import fiftyone as fo
import fiftyone.utils.huggingface as fouh

# Load the dataset
# Note: other available arguments include 'max_samples', etc
dataset = fouh.load_from_hub("Voxel51/USPS")

# Launch the App
session = fo.launch_app(dataset)
```

## Dataset Details

### Dataset Description

<!-- Provide a longer summary of what this dataset is. -->
- **Curated by:** Introduced by Jonathan J. Hull in [A Database for Handwritten Text Recognition Research](https://ieeexplore.ieee.org/document/291440) and available at [https://paperswithcode.com/dataset/usps](https://paperswithcode.com/dataset/usps).
- **Language(s) (NLP):** en
- **License:** unknown

### Dataset Sources [optional]

<!-- Provide the basic links for the dataset. -->
- **Repository:** https://paperswithcode.com/dataset/usps
- **Paper:** [A Database for Handwritten Text Recognition Research](https://ieeexplore.ieee.org/document/291440)

## Dataset Structure

<!-- This section provides a description of the dataset fields, and additional information about the dataset structure such as criteria used to create the splits, relationships between data points, etc. -->
```default
Name:        usps
Media type:  image
Num samples: 9298
Persistent:  False
Tags:        []
Sample fields:
    id:           fiftyone.core.fields.ObjectIdField
    filepath:     fiftyone.core.fields.StringField
    tags:         fiftyone.core.fields.ListField(fiftyone.core.fields.StringField)
    metadata:     fiftyone.core.fields.EmbeddedDocumentField(fiftyone.core.metadata.ImageMetadata)
    ground_truth: fiftyone.core.fields.EmbeddedDocumentField(fiftyone.core.labels.Classification)
```

The dataset has 2 splits: “train” and “test”. Samples are tagged with their split.

## Dataset Creation

Introduced by Jonathan J. Hull in [A Database for Handwritten Text Recognition Research](https://ieeexplore.ieee.org/document/291440)

## Citation

<!-- If there is a paper or blog post introducing the dataset, the APA and Bibtex information for that should go in this section. -->

**BibTeX:**

```default
@ARTICLE{291440,
  author={Hull, J.J.},
  journal={IEEE Transactions on Pattern Analysis and Machine Intelligence}, 
  title={A database for handwritten text recognition research}, 
  year={1994},
  volume={16},
  number={5},
  pages={550-554},
  keywords={Text recognition;Image databases;Testing;Cities and towns;Handwriting recognition;Gray-scale;Performance analysis;Writing;Digital images;Postal services},
  doi={10.1109/34.291440}}
```

## More Information

Dataset conversion and data card contributed by [Rohith Raj Srinivasan](https://huggingface.co/rohis).

## Dataset Card Authors

[Rohith Raj Srinivasan](https://huggingface.co/rohis)