Generate Synthetic Dataset
==========================

.. role:: guimenu

.. role:: guiaction

.. role:: guioption

This is how you can generate a synthetic dataset using AI Hub.
Find more detailed information about generating data with the AI Hub :doc:`here. </ai_hub/data_generation>`

.. hint::
    Ensure the object mesh model is registered in the database before
    generating a dataset. See :doc:`Tutorial: Upload A Mesh Model </tutorials/upload_mesh>` for more
    details on uploading an externally sourced mesh model.

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:`DATA GENERATION`.

3. Select the type **Synthetic** from the **Data type** dropdown menu.

4. Select the object(s) you want to generate a dataset for from the list of
   registered objects in the **Available Objects** dropdown.

.. hint::
   Click on :guimenu:`Visualize Model` to  preview the last selected object in
   the right upper corner of the screen.

5. Provide a distinct name for the dataset in the **Dataset Name** field.

6. Specify the number of images to be generated in the **Number of Images**
   field. The number of images can be adjusted to suit your needs, but starting
   with around 100 images is a good approach.

.. note::
   The more images you generate, the more diverse your dataset will be, which
   can improve the performance of your model. However, generating too many
   images can also lead to longer processing times and larger file sizes, so
   it's important to find a balance that works for your specific use case.

7. To start the object generation, press the :guiaction:`Start Generate`
   button.

.. figure:: /_static/ai_hub/data_generation/ai-hub-generate-syn-dataset.jpg
    :align: center
    :class: padded-image

8. The progress bar should gradually fill up and some sample generated images
   would display. The generation process may take some time depending on the
   number of images selected.

9. Once the generation is complete, you will see a message indicating that
   the process has finished.

10. Successfully generated datasets can be found under :guimenu:`DATA MANAGEMENT`
    > :guimenu:`Datasets`. Database search allows finding the generated dataset
    by the assigned name.

Video Guide
-----------------

.. note::

   The video is a demonstration of the generation process. The actual interface
   may differ slightly from the one shown in the video.

.. video::  /_static/ai-hub-data-generation.mp4
    :width: 700