fiftyone.utils.data.converters

Dataset format conversion utilities.

Copyright 2017-2025, Voxel51, Inc.

voxel51.com

Functions:

convert_dataset([input_dir, input_type, ...])

Converts a dataset stored on disk to another format on disk.

fiftyone.utils.data.converters.convert_dataset(input_dir=None, input_type=None, input_kwargs=None, dataset_importer=None, output_dir=None, output_type=None, output_kwargs=None, dataset_exporter=None, overwrite=False)

Converts a dataset stored on disk to another format on disk.

The input dataset may be specified by providing either an input_dir and a corresponding input_type or by providing a dataset_importer.

The output dataset may be specified by providing either an output_dir and a corresponding output_type or by providing a dataset_exporter.

Parameters:

• input_dir (None) – the input dataset directory

• input_type (None) – the fiftyone.types.Dataset type of the dataset in input_dir

• input_kwargs (None) – optional kwargs dict to pass to the constructor of the fiftyone.utils.data.importers.DatasetImporter for the input_type you specify

• dataset_importer (None) – a fiftyone.utils.data.importers.DatasetImporter to use to import the input dataset

• output_dir (None) – the directory to which to write the output dataset

• output_type (None) – the fiftyone.types.Dataset type to write to output_dir

• output_kwargs (None) – optional kwargs dict to pass to the constructor of the fiftyone.utils.data.exporters.DatasetExporter for the output_type you specify

• dataset_exporter (None) – a fiftyone.utils.data.exporters.DatasetExporter to use to export the dataset

• overwrite (False) – whether to delete existing directories before performing the export (True) or to merge the export with existing files and directories (False)