class_docstr: Exporter that writes VOC detection datasets to disk.
  
  See :ref:`this page <VOCDetectionDataset-export>` for format details.
  
  Args:
      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
          :func:`fiftyone.core.storage.normalize_path`
      include_paths (True): whether to include the absolute paths to the
          images in the ``<path>`` 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
class_docstr_tok: ["Exporter","that","writes","VOC","detection","datasets","to","disk",".","See",":","ref",":","`","this","page","<","VOCDetectionDataset-export",">","`","for","format","details",".","Args",":","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","``",":","do","n'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",":","func",":","`","fiftyone.core.storage.normalize_path","`","include_paths","(","True",")",":","whether","to","include","the","absolute","paths","to","the","images","in","the","``","<","path",">","``","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"]
code: def requires_image_metadata(self):
      return True
  
imports: import logging
  import os
  import jinja2
  import eta.core.utils
  import fiftyone.constants
  import fiftyone.core.labels
  import fiftyone.core.metadata
  import fiftyone.core.storage
  import fiftyone.core.utils
  import fiftyone.utils.data
label_desc: Use image node_id 2 for calling the VOCDetectionDatasetExporter obj's underlying member method code with example usage: obj.requires_image_metadata() and returns: True