# stl10

<br />

- **Description**:

The STL-10 dataset is an image recognition dataset for developing unsupervised
feature learning, deep learning, self-taught learning algorithms. It is inspired
by the CIFAR-10 dataset but with some modifications. In particular, each class
has fewer labeled training examples than in CIFAR-10, but a very large set of
unlabeled examples is provided to learn image models prior to supervised
training. The primary challenge is to make use of the unlabeled data (which
comes from a similar but different distribution from the labeled data) to build
a useful prior. All images were acquired from labeled examples on ImageNet.

- **Additional Documentation** :
  [Explore on Papers With Code](https://paperswithcode.com/dataset/stl-10)

- **Homepage** :
  [http://ai.stanford.edu/\~acoates/stl10/](http://ai.stanford.edu/%7Eacoates/stl10/)

- **Source code** :
  [`tfds.datasets.stl10.Builder`](https://github.com/tensorflow/datasets/tree/master/tensorflow_datasets/datasets/stl10/stl10_dataset_builder.py)

- **Versions**:

  - **`1.0.0`** (default): No release notes.
- **Download size** : `2.46 GiB`

- **Dataset size** : `1.86 GiB`

- **Auto-cached**
  ([documentation](https://www.tensorflow.org/datasets/performances#auto-caching)):
  No

- **Splits**:

| Split | Examples |
|---|---|
| `'test'` | 8,000 |
| `'train'` | 5,000 |
| `'unlabelled'` | 100,000 |

- **Feature structure**:

    FeaturesDict({
        'image': Image(shape=(96, 96, 3), dtype=uint8),
        'label': ClassLabel(shape=(), dtype=int64, num_classes=10),
    })

- **Feature documentation**:

| Feature | Class | Shape | Dtype | Description |
|---|---|---|---|---|
|   | FeaturesDict |   |   |   |
| image | Image | (96, 96, 3) | uint8 |   |
| label | ClassLabel |   | int64 |   |

- **Supervised keys** (See
  [`as_supervised` doc](https://www.tensorflow.org/datasets/api_docs/python/tfds/load#args)):
  `('image', 'label')`

- **Figure**
  ([tfds.show_examples](https://www.tensorflow.org/datasets/api_docs/python/tfds/visualization/show_examples)):

![Visualization](https://storage.googleapis.com/tfds-data/visualization/fig/stl10-1.0.0.png)

- **Examples** ([tfds.as_dataframe](https://www.tensorflow.org/datasets/api_docs/python/tfds/as_dataframe)):

<button id="displaydataframe">Display examples...</button>

- **Citation**:

    @inproceedings{coates2011stl10,
      title={ {An Analysis of Single Layer Networks in Unsupervised Feature Learning} },
      author={Coates, Adam and Ng, Andrew and Lee, Honglak},
      booktitle={AISTATS},
      year={2011},
      note = {\url{https://cs.stanford.edu/~acoates/papers/coatesleeng_aistats_2011.pdf} },
    }