Metadata-Version: 2.0
Name: davisinteractive
Version: 0.0.1.dev2
Summary: Evaluation Framework for DAVIS Interactive Segmentation
Home-page: https://github.com/albertomontesg/davis-interactive
Author: Alberto Montes
Author-email: al.montes.gomez@gmail.com
License: GPL v3
Keywords: segmentation
Platform: UNKNOWN
Requires-Dist: numpy (>=1.12.1)
Requires-Dist: scikit-learn (>=0.18)
Requires-Dist: scikit-image (>=0.13.1)
Requires-Dist: networkx (>=2.0)
Requires-Dist: scipy (>=1.0.0)
Requires-Dist: pandas (>=0.21.1)
Requires-Dist: absl-py (>=0.1.13)
Requires-Dist: Pillow (>=4.1.1)

DAVIS Interactive Evaluation Framework
======================================

|Travis| |Codecov branch| |GPLv3 license|

This is a framework to evaluate interactive segmentation models over the
`DAVIS <http://davischallenge.org/index.html>`__ dataset. The code aims
to provide an easy-to-use interface to test and validate interactive
segmentation models.

This is the tool that will be used to evaluate the DAVIS Challenge on
Video Object Segmentation 2018 on the interactive track. More info about
the challenge on the
`website <http://davischallenge.org/challenge2018/interactive.html>`__.

**Note**: code still under development.

DAVIS Scribbles
---------------

On previous DAVIS Challenge the task consisted on object segmentation in
a semisupervised manner. The input given was the ground truth mask of
the first frame. For DAVIS interactive challenge we change the
annotation to scribbles which can be annotated faster by humans.

The interactive annotation and segmentation consist on a iterative loop
which is going to be evaluated as follows:

-  On the first iteration, a human annotated scribble will be provided
   to the segmentation model. All the scribbles are annotated over the
   DAVIS dataset and the objects annotated will be the same as the
   ground truth masks. **Note**: the annotated frame can be any of the
   sequence as the humans where asked to annotate the frames that found
   most relevant and meaningfull to annotate.
-  During the rest of the iterations, once the predicted masks have been
   submitted, an automated scribble is generated simulating human
   annotation. The new annotation will be performed on a single frame
   and this frame will be chosen as the worst on the evaluation metric.

**Evaluation**: For now, the evaluation metric will be the Jaccard
similarity :math:`\mathcal{J}`.

Citation
--------

Please cite both papers in your publications if DAVIS or this code helps
your research.

.. code:: tex

    @article{Caelles_arXiv_2018,
      author = {Sergi Caelles and Alberto Montes and Kevis-Kokitsi Maninis and Yuhua Chen and Luc {Van Gool} and Federico Perazzi and Jordi Pont-Tuset},
      title = {The 2018 DAVIS Challenge on Video Object Segmentation},
      journal = {arXiv:1803.00557},
      year = {2018}
    }

.. code:: latex

    @inproceedings{Perazzi2016,
      author = {F. Perazzi and J. Pont-Tuset and B. McWilliams and L. {Van Gool} and M. Gross and A. Sorkine-Hornung},
      title = {A Benchmark Dataset and Evaluation Methodology for Video Object Segmentation},
      booktitle = {Computer Vision and Pattern Recognition},
      year = {2016}
    }

.. |Travis| image:: https://img.shields.io/travis/albertomontesg/davis-interactive.svg?style=for-the-badge
   :target: https://travis-ci.org/albertomontesg/davis-interactive
.. |Codecov branch| image:: https://img.shields.io/codecov/c/github/albertomontesg/davis-interactive/master.svg?style=for-the-badge
   :target: https://codecov.io/gh/albertomontesg/davis-interactive
.. |GPLv3 license| image:: https://img.shields.io/badge/License-GPL_v3-blue.svg?style=for-the-badge
   :target: https://github.com/albertomontesg/davis-interactive/blob/master/LICENSE


