class_docstr: Importer for BDD datasets stored on disk.
  
  See :ref:`this page <BDDDataset-import>` for format details.
  
  Args:
      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 filename like ``"labels.json"`` specifying the location of
              the labels in ``dataset_dir``
          -   an absolute filepath 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.json``
      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
class_docstr_tok: ["Importer","for","BDD","datasets","stored","on","disk",".","See",":","ref",":","`","this","page","<","BDDDataset-import",">","`","for","format","details",".","Args",":","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","filename","like","``","``","labels.json","''","``","specifying","the","location","of","the","labels","in","``","dataset_dir","``","-","an","absolute","filepath","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.json","``","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"]
code: def __iter__(self):
      self._iter_filenames = iter(self._filenames)
      return self
  
imports: from copy import deepcopy
  import logging
  import os
  import warnings
  import eta.core.serial
  import eta.core.utils
  import fiftyone
  import fiftyone.core.labels
  import fiftyone.core.metadata
  import fiftyone.core.storage
  import fiftyone.utils.data
label_desc: Use image node_id 2 for calling the BDDDatasetImporter obj's underlying member method code with example usage: obj.__iter__() and returns: self