Upload A Mesh Model
===================
.. role:: guimenu

.. role:: guiaction

.. role:: guioption

Here's how you can upload object meshes and bin meshes to the database from an
external drive.

.. note::
   Managing your data with :doc:`AI Hub: Data Management </ai_hub/data_management>`

Step 1: Preparing meshes in a Storage Device
------------------------------------
1. Format the external storage device to **FAT32** or **exFAT** format. This
   ensures compatibility with the robot system.

2. Prepare the mesh files according to the requirements listed in
   :ref:`Mesh model file requirements <ai_hub:Mesh model file requirements>`.

3. Transfer the mesh files to the external storage device. If you have multiple
   files for an object and you have multiple objects to upload, it is
   recommended to use one directory per object.

Step 2: Transferring the mesh model from a storage device
----------------------------------------------------------

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

2. Plug the USB containing the mesh files to the control box.

3. Go to :guimenu:`DATA MANAGEMENT` section and select :guimenu:`DATA TRANSFER`
   sub-tab.

4. Select your storage drive and navigate the pseudo file system to your mesh
   file(s).

5. Select the mesh file(s) to upload. You could inspect the selected meshes in
   the preview window. You could hit :guiaction:`Validate` to run a preliminary
   check if the mesh file requirements are fulfilled. Use the status message
   to guide on how to remedy the issue in cases of failure and try again.

.. hint::

   If your model includes a texture file, there is no need to select it as it
   will be automatically uploaded with the mesh file.

6. Click on :guiaction:`Upload` to upload the selected mesh files to the
   database.


7. In the file review, check the **bin_obj** checkbox if it's a bin mesh file.
   Once satisfied, click on :guiaction:`Upload` to initiate the upload process.

.. figure::  /_static/ai_hub/data_management/ai-hub-upload-objects-list.jpg
    :align: center
    :class: padded-image

8. The upload process may take some time depending on the size of the
   files and the number of files selected. Use the status message to guide on
   how to remedy the issue in cases of failure and try again.

.. figure::  /_static/ai_hub/data_management/ai-hub-upload-objects-folder.jpg
    :align: center
    :class: padded-image


.. figure::  /_static/ai_hub/data_management/ai-hub-upload-objects-check.jpg
    :align: center
    :class: padded-image


9. Successfully uploaded meshes can be found under :guimenu:`DATA MANAGEMENT` >
   :guimenu:`Mesh Models`. Database search allows finding the uploaded mesh by
   the assigned name.

Video Guide
-----------------
.. note::

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

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