Recognizing objects
===================

.. _choregraphe-tuto-learn-object:

Teaching NAO to recognize objects
-------------------------------------

Introduction
++++++++++++

Using the video monitor, NAO can learn images, objects and rooms to recognize.

How can you do this?
++++++++++++++++++++

1. Click the **View** > **Video monitor**. The video monitor panel opens.

2. Click the **Play** button

   .. image:: /medias/dev/tutos/choregraphe/beginning_play_button.png

   The video monitor displays what NAO is seeing.

3. Click the **Learn** button.

   A 4 seconds countdown starts to let you time for placing correctly the object you want to learn:

   .. image:: /medias/dev/tutos/choregraphe/capturing-vision.png

   At 0, the image switch to QVGA resolution and is captured.

4. With the mouse, click the contour of the object you want to learn. At the end, click again the first point

   to close the form as here:

   .. image:: /medias/dev/tutos/choregraphe/contour-vision.png

   .. note::

      For a room, take the contour of the full image.

   A pop-up opens.

5. Enter the information about the object, book or room:

   .. image:: /medias/dev/tutos/choregraphe/object-tag.png

6. Click **OK**.

   The data for the object are now saved in the default database on your computer.

7. Return to step 2. if you want to learn other objects

8. When you have finished with learning objects, send the database to NAO by 
   clicking on **Send current vision recognition database to NAO** button

9. Launch or relaunch the **Vision Reco** box so NAO can detect the newly learned objects.

.. note::

   The database is not stored with the behavior but in a specific directory. To create several 
   databases with different objects lists or share it on other computers, you can clear, export
   and import the database using the dedicated buttons in the video monitor.

Refer to :ref:`ALVisionRecognition Overview <alvisionrecognition>` for further explanation on that module.