Import Multiview Image Groups

Overview • Preparation • How To Run • How To Use • Additional Settings • Demo Video

Overview

Import multiview image groups and create a new project in the current Team -> Workspace.

Application key points:

• Tag for images is defined by user in the modal window when starting the app
• All images in groups in the created project will be tagged
• Images Grouping option will be turned on by default in the created project
• Images will be grouped by tag's value
• Tag value is defined by group directory name
• Works with .nrrd image format (2D only)
• Projects with .nrrd images format can be exported only with Export to Supervisely format app

Preparation

Archive zip, tar, tar.xz, tar.gz

Archive structure:

.
└── my_project.zip
    └── cars catalog 
        └── used cars 
            ├── 105 
            │   ├── car_105_front.jpg
            │   └── car_105_top.jpg
            ├── 202 
            │   ├── car_202_front.jpg
            │   └── car_202_top.jpg
            ├── 357 
            │   ├── car_357_front.jpg
            │   └── car_357_top.jpg
            ├── car_401_front.jpg
            ├── car_401_top.jpg
            └── car_401_side.jpg

Folder

Folder structure:

.
└── cars catalog
    └── used cars
        ├── car_id_105
        │   ├── car_105_front.jpg
        │   └── car_105_top.jpg
        ├── car_id_202
        │   ├── car_202_front.jpg
        │   └── car_202_top.jpg
        ├── car_id_357
        │   ├── car_357_front.jpg
        │   └── car_357_top.jpg
        ├── car_401_front.jpg
        ├── car_401_top.jpg
        └── car_401_side.jpg

Structure explained:

1. Archive must contain only 1 project directory. Name of the project directory will be used for created supervisely project.
2. Inside project directory must be dataset directory. Name of the dataset directory will be used for created dataset.
3. Group directories must be populated with images and placed inside dataset directory. All images inside groups will be tagged.
4. All images in the root dataset directory will be uploaded as a regular images and will not be tagged.

Example of created project using the example below and tag car id as user input:

• Project name: cars catalog
• Dataset name: used cars
• Images:

Image name	Tag
car_105_front.jpg	car id: 105
car_105_top.jpg	car id: 105
car_202_front.jpg	car id: 202
car_202_top.jpg	car id: 202
car_357_front.jpg	car id: 357
car_357_top.jpg	car id: 357
car_401_front.jpg
car_401_top.jpg
car_401_side.jpg

Download example data: IMAGES | NRRD

Prepare project and drag and drop it to Team Files.

How To Run

Step 1. Add Import Multiview Image Groups app to your team from Ecosystem

Step 2. Run app from the context menu of your data on Team Files page:

Step 3. Define group tag name in modal window and enable/disable synchronized view for images group.

Step 4. Once app is started, new task will appear in workspace tasks. Wait for the app to process your data.

How To Use

Step 1. Open imported project.

Step 2. Open dataset using new image annotator.

Additional Settings

1. To display single images switch off Images Grouping setting.

2. If you want to disable images groupping for the whole project, go to Project->Settings->Visuals uncheck

3. Windowing tool is available when working with .nrrd files. It helps to filter pixels to see bones, air, liquids and etc

4. Images view synchronization

Synchronization OFF

Synchronization ON

Demo Video