How to import

Explore various import methods on the Supervisely Platform, including importing different formats and modalities, importing from the cloud or via Ecosystem apps.

This 5-minute tutorial is a part of introduction to Supervisely series. You can complete them one-by-one, in random order, or jump to the rest of the documentation at any moment.

• How to import (you are here)

• How to annotate

• How to invite team members

• How to connect agents

• How to train models

You can learn more about Import, such as importing different formats, import from the cloud or adding data to existing datasets in this section.

Supported Formats and Modalities

Image Datasets:

• Auto-detect annotations in Supervisely, COCO, YOLO, Pascal VOC, Cityscapes, Images with PNG masks formats.

• Import images for Multi-view, Multispectral, Medical 2D (single) labeling.

• Upload images as links from CSV or TXT files or convert PDF pages to images.

• Images in any directory structure without annotations.

• Supported image formats: .jpg, .jpeg, jpe, .bmp, .png, .webp, .mpo, .tiff, .nrrd, .jfif, .avif, .heic.

Video Datasets:

• Auto-detect annotations in Supervisely, DAVIS (coming soon), MOT (coming soon) formats.

• Videos in any directory structure without annotations.

• Supported video formats: .avi, .mov, .wmv, .webm, .3gp, .mp4, .flv. ⚠️ All videos will be converted to .mp4 format during import.

Point Cloud Datasets:

• Auto-detect annotations in Supervisely format.

• Point clouds in any directory structure without annotations in PCD, LAS, LAZ, PLY formats.

Point Cloud Episode Datasets:

• Auto-detect annotations in Supervisely format.

• Point cloud episodes without annotations in PCD format.

Volume Datasets:

• Auto-detect annotations in Supervisely format.

• Volumes in any directory structure without annotations in DICOM, NRRD formats.

You can always use applications to import different modalities from our Ecosystem:

Import Images | Import Videos | Import Pointclouds | Import Pointcloud Episodes | Import DICOM Volumes | Import COCO Keypoints | Import Volumes in Supervisely format | Import KITTI-360 | Import Multispectral Images | and many other formats.

🪄 Here we will look at the fastest and easiest import option!

---

Let's start our journey with Supervisely by uploading our very first image. Of course, like we said before, you can import more complex dataset formats like COCO, or modalities, such as DICOM, connect a S3 cloud and much more, but let’s begin with a simple one.

We assume that you have already created an account in Supervisely. If not, you can create a free account in our Community Edition here.

First thing you will see after you login to Supervisely, is your Projects page where you can find your data. But there is nothing here yet — let’s fix that!

1. Click the Import Data button. Enter a unique name for the project, keeping in mind that it must be unique in the workspace and case-sensitive. You can also add a description of the project to provide additional information or to track project updates.

2. Next, select the Project type by defining the content modality: images, videos, point clouds, or DICOM 3D volumes.

Note that you can't mix multiple content types in the same project, and this setting can't be changed later.

3. Choose one of the available interfaces for labeling images (or other data modality). Our interfaces are designed for different industries and annotation scenarios.

4. After completing all required fields and selecting options, click Create to complete the project and begin uploading data.

5. In the modal window, drag and drop one or more images in one of the supported formats, such as .jpg, .jpeg, .mpo, .bmp, .png, .webp, .tiff, .tif, .nrrd, .jfif, .avif, .heic, NIfTI, DICOM . You can also check out the supported annotation formats.

🤗 Congratulations, the hardest part is over!

You will be redirected to the Tasks page where you can watch the progress of the application (your files are actually being uploaded to your Team Files).

You can click three dots (⋮) icon and check the application logs.

🤓 Nerd alert! Skip this section if you aren't interested how Supervisely works inside.

So what is going on here? First, Supervisely will choose one of the connected Agents and ask it to run the “Auto Import'' application. It will spawn a Docker container that will download the GitHub repository with the application code and run python code written with Supervisely SDK.

It will pull your images uploaded to the Team Files in the modal window, convert them, if needed (this particular application maybe does little, but others, like Import COCO format, will transform a lot) and use API to create a Project and add images to it.

Once the import is finished, you will see the link to your new project in the Output column of the table.

All set! Now, in the next section, let’s annotate your uploaded images.