class documentation

Open Images V7 is a dataset of ~9 million images, roughly 2 million of which are annotated and available via this zoo dataset.

The dataset contains annotations for classification, detection, segmentation, point labels, and visual relationship tasks for the 600 boxable object classes.

This dataset supports partial downloads:

  • You can specify subsets of data to download via the``label_types``, classes, attrs, and max_samples parameters
  • You can specify specific images to load via the image_ids parameter

See :ref:`this page <dataset-zoo-open-images-v6>` for more information about partial downloads of this dataset.

Full split stats:

  • Train split: 1,743,042 images (513 GB)
  • Test split: 125,436 images (36 GB)
  • Validation split: 41,620 images (12 GB)

Notes:

  • Not all images contain all types of labels
  • All images have been rescaled so that their largest dimension is at most 1024 pixels

Example usage:

#
# Load 50 random samples from the validation split
#
# By default, all label types are loaded, including "points"
#

dataset = foz.load_zoo_dataset(
    "open-images-v7",
    split="validation",
    max_samples=50,
    shuffle=True,
)

session = fo.launch_app(dataset)

#
# Load detections, classifications, and points for 25 samples from the
# validation split that contain fedoras and pianos
#
# Images that contain all `label_types` and `classes` will be
# prioritized first, followed by images that contain at least one of
# the required `classes`. If there are not enough images matching
# `classes` in the split to meet `max_samples`, only the available
# images will be loaded.
#
# Images will only be downloaded if necessary
#

dataset = foz.load_zoo_dataset(
    "open-images-v7",
    split="validation",
    label_types=["detections", "classifications", "points"],
    classes=["Fedora", "Piano"],
    max_samples=25,
)

session.dataset = dataset

#
# Download the entire validation split and load detections
#
# Subsequent partial loads of the validation split will never require
# downloading any images
#

dataset = foz.load_zoo_dataset(
    "open-images-v7",
    split="validation",
    label_types=["detections"],
)

session.dataset = dataset
Dataset size
561 GB
Source
https://storage.googleapis.com/openimages/web/index.html
Parameters
label_typesa label type or list of label types to load. The supported values are ("detections", "classifications", "points", "relationships", "segmentations"). By default, all label types are loaded
classesa string or list of strings specifying required classes to load. If provided, only samples containing at least one instance of a specified class will be loaded
attrsa string or list of strings specifying required relationship attributes to load. Only applicable when label_types includes "relationships". If provided, only samples containing at least one instance of a specified attribute will be loaded
image_ids

an optional list of specific image IDs to load. Can be provided in any of the following formats:

  • a list of <image-id> strings
  • a list of <split>/<image-id> strings
  • the path to a text (newline-separated), JSON, or CSV file containing the list of image IDs to load in either of the first two formats
num_workersa suggested number of threads to use when downloading individual images
shufflewhether to randomly shuffle the order in which samples are chosen for partial downloads
seeda random seed to use when shuffling
max_samplesa maximum number of samples to load per split. If label_types, classes, and/or attrs are also specified, first priority will be given to samples that contain all of the specified label types, classes, and/or attributes, followed by samples that contain at least one of the specified labels types or classes. The actual number of samples loaded may be less than this maximum value if the dataset does not contain sufficient samples matching your requirements. By default, all matching samples are loaded
Method __init__ Undocumented
Instance Variable attrs Undocumented
Instance Variable classes Undocumented
Instance Variable image_ids Undocumented
Instance Variable label_types Undocumented
Instance Variable max_samples Undocumented
Instance Variable num_workers Undocumented
Instance Variable seed Undocumented
Instance Variable shuffle Undocumented
Property name The name of the dataset.
Property supported_splits A tuple of supported splits for the dataset, or None if the dataset does not have splits.
Property supports_partial_downloads Whether the dataset supports downloading partial subsets of its splits.
Property tags A tuple of tags for the dataset.
Method _download_and_prepare Internal implementation of downloading the dataset and preparing it for use in the given directory.

Inherited from ZooDataset (via FiftyOneDataset):

Static Method get_info_path Returns the path to the ZooDatasetInfo for the dataset.
Static Method has_info Determines whether the directory contains ZooDatasetInfo.
Static Method load_info Loads the ZooDatasetInfo from the given dataset directory.
Method download_and_prepare Downloads the dataset and prepares it for use.
Method get_split_dir Returns the directory for the given split of the dataset.
Method has_split Whether the dataset has the given split.
Method has_tag Whether the dataset has the given tag.
Property has_patches Whether the dataset has patches that may need to be applied to already downloaded files.
Property has_splits Whether the dataset has splits.
Property has_tags Whether the dataset has tags.
Property importer_kwargs A dict of default kwargs to pass to this dataset's fiftyone.utils.data.importers.DatasetImporter.
Property is_remote Whether the dataset is remotely-sourced.
Property parameters An optional dict of parameters describing the configuration of the zoo dataset when it was downloaded.
Property requires_manual_download Whether this dataset requires some files to be manually downloaded by the user before the dataset can be loaded.
Method _get_splits_to_download Undocumented
Method _is_dataset_ready Undocumented
Method _is_split_ready Undocumented
Method _patch_if_necessary Internal method called when an already downloaded dataset may need to be patched.
def __init__(self, label_types=None, classes=None, attrs=None, image_ids=None, num_workers=None, shuffle=None, seed=None, max_samples=None): (source)

Undocumented

Undocumented

Undocumented

image_ids: None = (source)

Undocumented

label_types: None = (source)

Undocumented

max_samples: None = (source)

Undocumented

num_workers: None = (source)

Undocumented

Undocumented

Undocumented

The name of the dataset.

@property
supported_splits = (source)

A tuple of supported splits for the dataset, or None if the dataset does not have splits.

@property
supports_partial_downloads = (source)

Whether the dataset supports downloading partial subsets of its splits.

A tuple of tags for the dataset.

def _download_and_prepare(self, dataset_dir, _, split): (source)

Internal implementation of downloading the dataset and preparing it for use in the given directory.

Parameters
dataset_dirthe directory in which to construct the dataset. If a split is provided, this is the directory for the split
_Undocumented
splitthe split to download, or None if the dataset does not have splits
scratch_dira scratch directory to use to download and prepare any required intermediate files
Returns
tuple of
  • dataset_type: the fiftyone.types.Dataset type of the dataset
  • num_samples: the number of samples in the split. For datasets that support partial downloads, this can be None, which indicates that all content was already downloaded
  • classes: an optional list of class label strings