:py:mod:`kwcoco.data.grab_voc`
==============================

.. py:module:: kwcoco.data.grab_voc


Module Contents
---------------


Functions
~~~~~~~~~

.. autoapisummary::

   kwcoco.data.grab_voc.__torrent_voc
   kwcoco.data.grab_voc.convert_voc_to_coco
   kwcoco.data.grab_voc._convert_voc_split
   kwcoco.data.grab_voc._read_split_paths
   kwcoco.data.grab_voc.ensure_voc_data
   kwcoco.data.grab_voc.ensure_voc_coco
   kwcoco.data.grab_voc.main



.. py:function:: __torrent_voc()

   Requires:
       pip install deluge
       pip install python-libtorrent-bin

   .. rubric:: References

   https://academictorrents.com/details/f6ddac36ac7ae2ef79dc72a26a065b803c9c7230

   .. todo:: - [ ] Is there a pythonic way to download a torrent programatically?


.. py:function:: convert_voc_to_coco(dpath=None)


.. py:function:: _convert_voc_split(devkit_dpath, classes, split, year, root)

   split, year = 'train', 2012
   split, year = 'train', 2007


.. py:function:: _read_split_paths(devkit_dpath, split, year)

   split = 'train'
   self = VOCDataset('test')
   year = 2007
   year = 2012


.. py:function:: ensure_voc_data(dpath=None, force=False, years=[2007, 2012])

   Download the Pascal VOC data if it does not already exist.

   .. note:: - [ ] These URLS seem to be dead

   .. rubric:: Example

   >>> # xdoctest: +REQUIRES(--download)
   >>> devkit_dpath = ensure_voc_data()


.. py:function:: ensure_voc_coco(dpath=None)

   Download the Pascal VOC data and convert it to coco, if it does exit.

   :Parameters: **dpath** (*str*) -- download directory. Defaults to "~/data/VOC".

   :returns:

             mapping from dataset tags to coco file paths.
                 The original datasets have keys prefixed with underscores.
                 The standard splits keys are train, vali, and test.
   :rtype: Dict[str, str]


.. py:function:: main()