# Bulk upload

To add images in bulk, select Add new dataset option in the appearing pop-up window. Name your dataset with a string of characters without spaces. After confirming the name, you will be able to upload files in four ways: as a directory, multiple selected files, an archive, or images from the camera.

# Classification categories

Maintaining a directory structure in which the parent folder contains subfolders with images will result in the images being assigned categories that match the names of the subfolders.

Example:

In the example below, you have a folder called Train, with subfolders named: Ada Lovelace, Alice Milliat, Amelia Earhart etc.

The category names will be created to match the subfolder names. Spaces will be replaced by underscores:

The tabs represent the assigned categories. Categories can be added, edited or deleted.

If you create a new category and open the tab representing it, all photos added at this level will automatically be assigned to the classification category matching the tab name.

In the example, we added photos to the newly created category "Madonna". They were assigned to the category during upload.

Deleting the category assigned to photos that still exist will make them uncategorized. The OTHER category contains photos with no assigned category or detection objects.

# Annotated images

Images can be uploaded directly with annotation files. The image and annotation file names must match. When OSAI counts the files submitted for upload, it also counts the annotation files, but only the number of images will be displayed in the dataset properties.

Based on the information from the annotation files, labels are created on the images with the same name. If the annotation is invalid, it will be omitted, but the image will be retained - even if there is no corresponding annotation.

Images and annotations can be added independently. The order in which the files are uploaded is up to you. It is important that the annotation file (.xml or .txt) has the same name as the image file. Otherwise, the annotation will be omitted.

For example:

# Uploading archives

When uploading archives we support .zip, .tar, tar.gz extensions. Only one archive can be uploaded at a time, without additional images or annotations.

Uploaded images and annotations within the archive can be in one common subfolder or in two separate subfolders. In addition, in order to be properly included, the rules for uploading classifications and annotations described above must be followed.

# Upload finalization

OSAI supports two file types - .jpg and .png.

If there are files in a different format in the folder you are uploading, you will be notified. When the upload is complete, you will see a summary with the names of the files that could not be uploaded.

In the gallery view of a given dataset, you can delete selected images (trash icon) or add (+) more.

You will receive a notification when the photo upload process is complete.