<br />

- **Description**:

LVIS: A dataset for large vocabulary instance segmentation.

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

- **Homepage** : <https://www.lvisdataset.org/>

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

- **Versions**:

  - `1.1.0`: Added fields `neg_category_ids` and `not_exhaustive_category_ids`.
  - `1.2.0`: Added class names.
  - `1.3.0`: Added minival split.
  - **`1.4.0`** (default): Added segmentation masks to the minival split.
- **Download size** : `25.38 GiB`

- **Dataset size** : `23.06 GiB`

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

- **Splits**:

| Split | Examples |
|---|---|
| `'minival'` | 4,809 |
| `'test'` | 19,822 |
| `'train'` | 100,170 |
| `'validation'` | 19,809 |

- **Feature structure**:

    FeaturesDict({
        'image': Image(shape=(None, None, 3), dtype=uint8),
        'image/id': int64,
        'neg_category_ids': Sequence(ClassLabel(shape=(), dtype=int64, num_classes=1203)),
        'not_exhaustive_category_ids': Sequence(ClassLabel(shape=(), dtype=int64, num_classes=1203)),
        'objects': Sequence({
            'area': int64,
            'bbox': BBoxFeature(shape=(4,), dtype=float32),
            'id': int64,
            'label': ClassLabel(shape=(), dtype=int64, num_classes=1203),
            'segmentation': Image(shape=(None, None, 1), dtype=uint8),
        }),
    })

- **Feature documentation**:

| Feature | Class | Shape | Dtype | Description |
|---|---|---|---|---|
|   | FeaturesDict |   |   |   |
| image | Image | (None, None, 3) | uint8 |   |
| image/id | Tensor |   | int64 |   |
| neg_category_ids | Sequence(ClassLabel) | (None,) | int64 |   |
| not_exhaustive_category_ids | Sequence(ClassLabel) | (None,) | int64 |   |
| objects | Sequence |   |   |   |
| objects/area | Tensor |   | int64 |   |
| objects/bbox | BBoxFeature | (4,) | float32 |   |
| objects/id | Tensor |   | int64 |   |
| objects/label | ClassLabel |   | int64 |   |
| objects/segmentation | Image | (None, None, 1) | uint8 |   |

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

- **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/lvis-1.4.0.png)

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

<iframe src="https:///frame/datasets/catalog/lvis_d12d08f464f22954645bb28f1af94dd6cb25580fdd589a04a152523548dbf9ca.frame" class="framebox inherit-locale " allow="clipboard-write https://" allowfullscreen is-upgraded></iframe>

- **Citation**:

    @inproceedings{gupta2019lvis,
      title={ {LVIS}: A Dataset for Large Vocabulary Instance Segmentation},
      author={Gupta, Agrim and Dollar, Piotr and Girshick, Ross},
      booktitle={Proceedings of the {IEEE} Conference on Computer Vision and Pattern Recognition},
      year={2019}
    }