Collect Real Data
==================
.. role:: guimenu

.. role:: guiaction

.. role:: guioption

Follow this guide to learn how to collect real, live data using a robot that
can be used in performing cognitive tasks.

Using the Real Data Collection Wizard
--------------------------------------

.. note::
   What is :ref:`Real Data Collection Wizard
   <ai_hub/ai_dev_arena:Real Data Collection Wizard>`?


1. Using an external PC, access Maira GUI at `http://192.168.2.14:8080 <http://192.168.2.14:8080>`_ and
   switch to :strong:`AI Hub Mode`.

2. Click :guimenu:`AI DEV ARENA` and a new tab to `AI Dev Arena <http://192.168.2.14:8089>`_
   opens.

3. Click :guimenu:`Real Data Collection Wizard` to open the wizard.

4. Press the :guioption:`Start` button to begin capturing new images.

.. figure:: /_static/ai_hub/ai_dev_arena/ai_dev_arena03.png
    :align: center
    :class: padded-image

5. Place the objects of interest on your workspace. Click the
   :guioption:`Capture Image` button to capture an image. There is an image
   counter on the bottom for your reference.

.. hint::
    For better results, introduce variations e.g.,

    * capture images of the object in different orientations, backgrounds and
      lighting conditions.
    * capture images of an object from different angles by adjusting the
      robot’s position using :guioption:`ZeroG` mode.
    * place the object at off-center positions in the camera view
    * introduce some occlusions to the object by placing other distractor objects
      in front of it.

.. caution::
    To save a dataset, a minimum of **10 images** is required.

.. figure:: /_static/ai_hub/ai_dev_arena/ai_dev_arena04.png
    :align: center
    :class: padded-image

6. Click :guioption:`Go To View Images` to review the collected images and delete any unwanted ones. To capture additional images, click :guioption:`Go To Record Images`.

7. To save the dataset, simply enter a descriptive dataset name and select a
   suitable type. Click :guioption:`Save Dataset` to save the dataset.

.. list-table::
    :widths: 20 30
    :header-rows: 1

    * - Type
      - Description
    * - ``TO_LABEL``
      - indicates that every image consists of objects of interest
        and is intended to be annotated using :doc:`Neura CVAT </ai_hub/data_annotation>`.
    * - ``ENVIRONMENT``
      - indicates that there are no objects of interest in the dataset.
    * - ``OBJECT_ONBOARDING``
      - for images that will be used in the
        :ref:`Object Onboarding Wizard <ai_hub/ai_dev_arena:Object Onboarding Wizard>`.

.. figure:: /_static/ai_hub/ai_dev_arena/ai_dev_arena05.png
    :align: center
    :class: padded-image

.. note::
    If you saved a ``TO_LABEL`` type dataset, the following tutorial will guide you on
    annotating the dataset using :doc:`Neura CVAT </ai_hub/data_annotation>`.

    See :doc:`Tutorial: Annotate Real Data </tutorials/annotate_data>`