# fiftyone.utils.voc Utilities for working with datasets in [VOC format](http://host.robots.ox.ac.uk/pascal/VOC). Copyright 2017-2026, Voxel51, Inc.
[voxel51.com](https://voxel51.com/)

**Classes:** | [`VOCDetectionDatasetImporter`](#fiftyone.utils.voc.VOCDetectionDatasetImporter)([dataset_dir, ...]) | Importer for VOC detection datasets stored on disk. | |--------------------------------------------------------------------------------------------------------|-------------------------------------------------------| | [`VOCDetectionDatasetExporter`](#fiftyone.utils.voc.VOCDetectionDatasetExporter)([export_dir, ...]) | Exporter that writes VOC detection datasets to disk. | | [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation)([path, folder, filename, ...]) | Class representing a VOC annotations file. | | [`VOCObject`](#fiftyone.utils.voc.VOCObject)(name, bndbox, \*\*attributes) | An object in VOC detection format. | | [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox)(xmin, ymin, xmax, ymax) | A bounding box in VOC detection format. | | [`VOCAnnotationWriter`](#fiftyone.utils.voc.VOCAnnotationWriter)() | Class for writing annotations in VOC format. | **Functions:** | [`load_voc_detection_annotations`](#fiftyone.utils.voc.load_voc_detection_annotations)(xml_path) | Loads the VOC detection annotations from the given XML file. | |----------------------------------------------------------------------------------------------------|----------------------------------------------------------------| ### *class* fiftyone.utils.voc.VOCDetectionDatasetImporter(dataset_dir=None, data_path=None, labels_path=None, include_all_data=False, extra_attrs=True, shuffle=False, seed=None, max_samples=None) Bases: [`LabeledImageDatasetImporter`](fiftyone.utils.data.importers.md#fiftyone.utils.data.importers.LabeledImageDatasetImporter), [`ImportPathsMixin`](fiftyone.utils.data.importers.md#fiftyone.utils.data.importers.ImportPathsMixin) Importer for VOC detection datasets stored on disk. See [this page](../user_guide/import_datasets.md#vocdetectiondataset-import) for format details. * **Parameters:** * **dataset_dir** (*None*) – the dataset directory. If omitted, `data_path` and/or `labels_path` must be provided * **data_path** (*None*) – an optional parameter that enables explicit control over the location of the media. Can be any of the following: - a folder name like `"data"` or `"data/"` specifying a subfolder of `dataset_dir` where the media files reside - an absolute directory path where the media files reside. In this case, the `dataset_dir` has no effect on the location of the data - a filename like `"data.json"` specifying the filename of the JSON data manifest file in `dataset_dir` - an absolute filepath specifying the location of the JSON data manifest. In this case, `dataset_dir` has no effect on the location of the data - a dict mapping filenames to absolute filepaths If None, this parameter will default to whichever of `data/` or `data.json` exists in the dataset directory * **labels_path** (*None*) – an optional parameter that enables explicit control over the location of the labels. Can be any of the following: - a folder name like `"labels"` or `"labels/"` specifying the location of the labels in `dataset_dir` - an absolute folder path to the labels. In this case, `dataset_dir` has no effect on the location of the labels If None, the parameter will default to `labels/` * **include_all_data** (*False*) – whether to generate samples for all images in the data directory (True) rather than only creating samples for images with label entries (False) * **extra_attrs** (*True*) – whether to load extra annotation attributes onto the imported labels. Supported values are: - `True`: load all extra attributes found - `False`: do not load extra attributes - a name or list of names of specific attributes to load * **shuffle** (*False*) – whether to randomly shuffle the order in which the samples are imported * **seed** (*None*) – a random seed to use when shuffling * **max_samples** (*None*) – a maximum number of samples to import. By default, all samples are imported **Attributes:** | [`has_dataset_info`](#fiftyone.utils.voc.VOCDetectionDatasetImporter.has_dataset_info) | Whether this importer produces a dataset info dictionary. | |--------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [`has_image_metadata`](#fiftyone.utils.voc.VOCDetectionDatasetImporter.has_image_metadata) | Whether this importer produces [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instances for each image. | | [`label_cls`](#fiftyone.utils.voc.VOCDetectionDatasetImporter.label_cls) | The [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) class(es) returned by this importer. | **Methods:** | [`setup`](#fiftyone.utils.voc.VOCDetectionDatasetImporter.setup)() | Performs any necessary setup before importing the first sample in the dataset. | |--------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------| | [`close`](#fiftyone.utils.voc.VOCDetectionDatasetImporter.close)(\*args) | Performs any necessary actions after the last sample has been imported. | | [`get_dataset_info`](#fiftyone.utils.voc.VOCDetectionDatasetImporter.get_dataset_info)() | Returns the dataset info for the dataset. | | [`get_media_sources`](#fiftyone.utils.voc.VOCDetectionDatasetImporter.get_media_sources)() | Returns the media-source entries the importing dataset records before any sample is added, or None. | #### *property* has_dataset_info Whether this importer produces a dataset info dictionary. #### *property* has_image_metadata Whether this importer produces [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instances for each image. #### *property* label_cls The [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) class(es) returned by this importer. This can be any of the following: - a [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) class. In this case, the importer is guaranteed to return labels of this type - a list or tuple of [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) classes. In this case, the importer can produce a single label field of any of these types - a dict mapping keys to [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) classes. In this case, the importer will return label dictionaries with keys and value-types specified by this dictionary. Not all keys need be present in the imported labels - `None`. In this case, the importer makes no guarantees about the labels that it may return #### setup() Performs any necessary setup before importing the first sample in the dataset. This method is called when the importer’s context manager interface is entered, `DatasetImporter.__enter__()`. #### close(\*args) Performs any necessary actions after the last sample has been imported. This method is called when the importer’s context manager interface is exited, `DatasetImporter.__exit__()`. * **Parameters:** **\*args** – the arguments to `DatasetImporter.__exit__()` #### get_dataset_info() Returns the dataset info for the dataset. By convention, this method should be called after all samples in the dataset have been imported. * **Returns:** a dict of dataset info #### get_media_sources() Returns the media-source entries the importing dataset records before any sample is added, or None. Only importers of media-reference-backed samples provide these; see [`fiftyone.utils.lerobot.LeRobotDatasetImporter`](fiftyone.utils.lerobot.md#fiftyone.utils.lerobot.LeRobotDatasetImporter). ### *class* fiftyone.utils.voc.VOCDetectionDatasetExporter(export_dir=None, data_path=None, labels_path=None, export_media=None, rel_dir=None, include_paths=True, image_format=None, extra_attrs=True) Bases: [`LabeledImageDatasetExporter`](fiftyone.utils.data.exporters.md#fiftyone.utils.data.exporters.LabeledImageDatasetExporter), [`ExportPathsMixin`](fiftyone.utils.data.exporters.md#fiftyone.utils.data.exporters.ExportPathsMixin) Exporter that writes VOC detection datasets to disk. See [this page](../user_guide/export_datasets.md#vocdetectiondataset-export) for format details. * **Parameters:** * **export_dir** (*None*) – the directory to write the export. This has no effect if `data_path` and `labels_path` are absolute paths * **data_path** (*None*) – an optional parameter that enables explicit control over the location of the exported media. Can be any of the following: - a folder name like `"data"` or `"data/"` specifying a subfolder of `export_dir` in which to export the media - an absolute directory path in which to export the media. In this case, the `export_dir` has no effect on the location of the data - a JSON filename like `"data.json"` specifying the filename of the manifest file in `export_dir` generated when `export_media` is `"manifest"` - an absolute filepath specifying the location to write the JSON manifest file when `export_media` is `"manifest"`. In this case, `export_dir` has no effect on the location of the data If None, the default value of this parameter will be chosen based on the value of the `export_media` parameter * **labels_path** (*None*) – an optional parameter that enables explicit control over the location of the exported labels. Can be any of the following: - a folder name like `"labels"` or `"labels/"` specifying the location in `export_dir` in which to export the labels - an absolute folder path to which to export the labels. In this case, the `export_dir` has no effect on the location of the labels If None, the labels will be exported into `export_dir` using the default folder name * **export_media** (*None*) – controls how to export the raw media. The supported values are: - `True`: copy all media files into the output directory - `False`: don’t export media - `"move"`: move all media files into the output directory - `"symlink"`: create symlinks to the media files in the output directory - `"manifest"`: create a `data.json` in the output directory that maps UUIDs used in the labels files to the filepaths of the source media, rather than exporting the actual media If None, the default value of this parameter will be chosen based on the value of the `data_path` parameter * **rel_dir** (*None*) – an optional relative directory to strip from each input filepath to generate a unique identifier for each image. When exporting media, this identifier is joined with `data_path` and `labels_path` to generate output paths for each exported image and labels file. This argument allows for populating nested subdirectories that match the shape of the input paths. The path is converted to an absolute path (if necessary) via [`fiftyone.core.storage.normalize_path()`](fiftyone.core.storage.md#fiftyone.core.storage.normalize_path) * **include_paths** (*True*) – whether to include the absolute paths to the images in the `` elements of the exported XML * **image_format** (*None*) – the image format to use when writing in-memory images to disk. By default, `fiftyone.config.default_image_ext` is used * **extra_attrs** (*True*) – whether to include extra object attributes in the exported labels. Supported values are: - `True`: export all extra attributes found - `False`: do not export extra attributes - a name or list of names of specific attributes to export **Attributes:** | [`requires_image_metadata`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.requires_image_metadata) | Whether this exporter requires [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instances for each sample being exported. | |--------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [`label_cls`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.label_cls) | The [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) class(es) exported by this exporter. | **Methods:** | [`setup`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.setup)() | Performs any necessary setup before exporting the first sample in the dataset. | |--------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [`export_sample`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.export_sample)(image_or_path, detections[, ...]) | Exports the given sample to the dataset. | | [`close`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.close)(\*args) | Performs any necessary actions after the last sample has been exported. | | [`log_collection`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.log_collection)(sample_collection) | Logs any relevant information about the [`fiftyone.core.collections.SampleCollection`](fiftyone.core.collections.md#fiftyone.core.collections.SampleCollection) whose samples will be exported. | #### *property* requires_image_metadata Whether this exporter requires [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instances for each sample being exported. #### *property* label_cls The [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) class(es) exported by this exporter. This can be any of the following: - a [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) class. In this case, the exporter directly exports labels of this type - a list or tuple of [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) classes. In this case, the exporter can export a single label field of any of these types - a dict mapping keys to [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) classes. In this case, the exporter can handle label dictionaries with value-types specified by this dictionary. Not all keys need be present in the exported label dicts - `None`. In this case, the exporter makes no guarantees about the labels that it can export #### setup() Performs any necessary setup before exporting the first sample in the dataset. This method is called when the exporter’s context manager interface is entered, `DatasetExporter.__enter__()`. #### export_sample(image_or_path, detections, metadata=None) Exports the given sample to the dataset. * **Parameters:** * **image_or_path** – an image or the path to the image on disk * **label** – an instance of [`label_cls()`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.label_cls), or a dictionary mapping field names to [`fiftyone.core.labels.Label`](fiftyone.core.labels.md#fiftyone.core.labels.Label) instances, or `None` if the sample is unlabeled * **metadata** (*None*) – a [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instance for the sample. Only required when [`requires_image_metadata()`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.requires_image_metadata) is `True` #### close(\*args) Performs any necessary actions after the last sample has been exported. This method is called when the exporter’s context manager interface is exited, `DatasetExporter.__exit__()`. * **Parameters:** **\*args** – the arguments to `DatasetExporter.__exit__()` #### log_collection(sample_collection) Logs any relevant information about the [`fiftyone.core.collections.SampleCollection`](fiftyone.core.collections.md#fiftyone.core.collections.SampleCollection) whose samples will be exported. Subclasses can optionally implement this method if their export format can record information such as the [`fiftyone.core.collections.SampleCollection.info()`](fiftyone.core.collections.md#fiftyone.core.collections.SampleCollection.info) of the collection being exported. By convention, this method must be optional; i.e., if it is not called before the first call to [`export_sample()`](#fiftyone.utils.voc.VOCDetectionDatasetExporter.export_sample), then the exporter must make do without any information about the [`fiftyone.core.collections.SampleCollection`](fiftyone.core.collections.md#fiftyone.core.collections.SampleCollection) (which may not be available, for example, if the samples being exported are not stored in a collection). * **Parameters:** **sample_collection** – the [`fiftyone.core.collections.SampleCollection`](fiftyone.core.collections.md#fiftyone.core.collections.SampleCollection) whose samples will be exported ### *class* fiftyone.utils.voc.VOCAnnotation(path=None, folder=None, filename=None, segmented=None, metadata=None, objects=None) Bases: `object` Class representing a VOC annotations file. * **Parameters:** * **path** (*None*) – the path to the image * **folder** (*None*) – the name of the folder containing the image * **filename** (*None*) – the image filename * **segmented** (*None*) – whether the objects are segmented * **metadata** (*None*) – a [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instance * **objects** (*None*) – a list of [`VOCObject`](#fiftyone.utils.voc.VOCObject) instances **Methods:** | [`to_detections`](#fiftyone.utils.voc.VOCAnnotation.to_detections)([extra_attrs]) | Returns a [`fiftyone.core.labels.Detections`](fiftyone.core.labels.md#fiftyone.core.labels.Detections) representation of the objects in the annotation. | |-----------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | [`from_labeled_image`](#fiftyone.utils.voc.VOCAnnotation.from_labeled_image)(metadata, detections[, ...]) | Creates a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance for the given labeled image data. | | [`from_xml`](#fiftyone.utils.voc.VOCAnnotation.from_xml)(xml_path) | Creates a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance from an XML annotations file. | | [`from_dict`](#fiftyone.utils.voc.VOCAnnotation.from_dict)(d) | Creates a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance from a JSON dict representation. | #### to_detections(extra_attrs=True) Returns a [`fiftyone.core.labels.Detections`](fiftyone.core.labels.md#fiftyone.core.labels.Detections) representation of the objects in the annotation. * **Parameters:** **extra_attrs** (*True*) – whether to load extra annotation attributes onto the imported labels. Supported values are: - `True`: load all extra attributes found - `False`: do not load extra attributes - a name or list of names of specific attributes to load * **Returns:** a [`fiftyone.core.labels.Detections`](fiftyone.core.labels.md#fiftyone.core.labels.Detections) #### *classmethod* from_labeled_image(metadata, detections, path=None, filename=None, extra_attrs=True) Creates a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance for the given labeled image data. * **Parameters:** * **metadata** – a [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instance for the image * **detections** – a [`fiftyone.core.labels.Detections`](fiftyone.core.labels.md#fiftyone.core.labels.Detections) * **path** (*None*) – the absolute path to the image * **filename** (*None*) – the filename of the image * **extra_attrs** (*True*) – whether to include extra object attributes. Supported values are: - `True`: include all extra attributes found - `False`: do not include extra attributes - a name or list of names of specific attributes to include * **Returns:** a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) #### *classmethod* from_xml(xml_path) Creates a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance from an XML annotations file. * **Parameters:** **xml_path** – the path to the XML file * **Returns:** a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) #### *classmethod* from_dict(d) Creates a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance from a JSON dict representation. * **Parameters:** **d** – a JSON dict * **Returns:** a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) ### *class* fiftyone.utils.voc.VOCObject(name, bndbox, \*\*attributes) Bases: `object` An object in VOC detection format. * **Parameters:** * **name** – the object label * **bndbox** – a [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox) * **\*\*attributes** – additional custom attributes **Methods:** | [`from_annotation_dict`](#fiftyone.utils.voc.VOCObject.from_annotation_dict)(d) | Creates a [`VOCObject`](#fiftyone.utils.voc.VOCObject) from a VOC annotation dict. | |----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| | [`from_detection`](#fiftyone.utils.voc.VOCObject.from_detection)(detection, metadata[, ...]) | Creates a [`VOCObject`](#fiftyone.utils.voc.VOCObject) from a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection). | | [`to_detection`](#fiftyone.utils.voc.VOCObject.to_detection)(frame_size[, extra_attrs]) | Returns a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection) representation of the object. | #### *classmethod* from_annotation_dict(d) Creates a [`VOCObject`](#fiftyone.utils.voc.VOCObject) from a VOC annotation dict. * **Parameters:** **d** – an annotation dict * **Returns:** a [`VOCObject`](#fiftyone.utils.voc.VOCObject) #### *classmethod* from_detection(detection, metadata, extra_attrs=True) Creates a [`VOCObject`](#fiftyone.utils.voc.VOCObject) from a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection). * **Parameters:** * **detection** – a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection) * **metadata** – a [`fiftyone.core.metadata.ImageMetadata`](fiftyone.core.metadata.md#fiftyone.core.metadata.ImageMetadata) instance for the image * **extra_attrs** (*True*) – whether to include extra object attributes. Supported values are: - `True`: include all extra attributes found - `False`: do not include extra attributes - a name or list of names of specific attributes to include * **Returns:** a [`VOCObject`](#fiftyone.utils.voc.VOCObject) #### to_detection(frame_size, extra_attrs=True) Returns a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection) representation of the object. * **Parameters:** * **frame_size** – the `(width, height)` of the image * **extra_attrs** (*True*) – whether to include extra annotation attributes on the object. Supported values are: - `True`: include all extra attributes found - `False`: do not include extra attributes - a name or list of names of specific attributes to include * **Returns:** a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection) ### *class* fiftyone.utils.voc.VOCBoundingBox(xmin, ymin, xmax, ymax) Bases: `object` A bounding box in VOC detection format. * **Parameters:** * **xmin** – the top-left x coordinate * **ymin** – the top-left y coordinate * **xmax** – the bottom-right x coordinate * **ymax** – the bottom-right y coordinate **Methods:** | [`from_bndbox_dict`](#fiftyone.utils.voc.VOCBoundingBox.from_bndbox_dict)(d) | Creates a [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox) from a `bndbox` dict. | |---------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [`from_detection_format`](#fiftyone.utils.voc.VOCBoundingBox.from_detection_format)(bounding_box, frame_size) | Creates a [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox) from a bounding box stored in [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection) format. | | [`to_detection_format`](#fiftyone.utils.voc.VOCBoundingBox.to_detection_format)(frame_size) | Returns a representation of the bounding box suitable for storing in the `bounding_box` field of a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection). | #### *classmethod* from_bndbox_dict(d) Creates a [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox) from a `bndbox` dict. * **Parameters:** **d** – a `bndbox` dict * **Returns:** a [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox) #### *classmethod* from_detection_format(bounding_box, frame_size) Creates a [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox) from a bounding box stored in [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection) format. * **Parameters:** * **bounding_box** – `[x-top-left, y-top-left, width, height]` * **frame_size** – the `(width, height)` of the image * **Returns:** a [`VOCBoundingBox`](#fiftyone.utils.voc.VOCBoundingBox) #### to_detection_format(frame_size) Returns a representation of the bounding box suitable for storing in the `bounding_box` field of a [`fiftyone.core.labels.Detection`](fiftyone.core.labels.md#fiftyone.core.labels.Detection). * **Parameters:** **frame_size** – the `(width, height)` of the image * **Returns:** `[x-top-left, y-top-left, width, height]` ### *class* fiftyone.utils.voc.VOCAnnotationWriter Bases: `object` Class for writing annotations in VOC format. See [this page](../user_guide/export_datasets.md#vocdetectiondataset-export) for format details. **Methods:** | [`write`](#fiftyone.utils.voc.VOCAnnotationWriter.write)(annotation, xml_path) | Writes the annotations to disk. | |----------------------------------------------------------------------------------|-----------------------------------| #### write(annotation, xml_path) Writes the annotations to disk. * **Parameters:** * **annotation** – a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance * **xml_path** – the path to write the annotation XML file ### fiftyone.utils.voc.load_voc_detection_annotations(xml_path) Loads the VOC detection annotations from the given XML file. See [this page](../user_guide/import_datasets.md#vocdetectiondataset-import) for format details. * **Parameters:** **xml_path** – the path to the annotations XML file * **Returns:** a [`VOCAnnotation`](#fiftyone.utils.voc.VOCAnnotation) instance