3. Basic Operations

3.1. Run server

For running ReNomTAG, please use the following command in your working directory.

renom_tag

This command has the following options.

# Run with port 8081
renom_tag --port 8081

Then type the following URL into your web browser.

../_images/basic_operations01.png

The public directory will be loaded and following screen will be displayed.

../_images/basic_operations02.png

3.2. Select Dataset

After starting the application, select the dataset for tagging from the list on the left. If the list is not displayed, click the icon in the upper left to access the list and select your dataset. This icon can be used to switch between datasets at any time.

../_images/basic_operations11.png

3.3. Select Tagging Mode

ReNomTAG provides modes for creating both object detection tags (bounding boxes) and semantic segmentation labels (pixel-level annotations). Please select the mode you will use by clicking on the corresponding mode name in the upper right.

../_images/basic_operations03.png

3.3.1. Filter images

You can filter the images to be shown.

  • All : Show all images.
  • Need Review : Show images marked neither OK nor NG.
  • No Tags : Show images with no tags.
  • OK : Show images marked as OK by admin user.
  • NG : Show images marked as NG by admin user.
../_images/basic_operations04.png

3.3.2. Add tags or labels to images

Please refer to “4: How to tag” for an explanation of how to apply tags or labels to images.

3.3.3. Add comments to images

You can also add comments to images. Users in normal mode can view comments but they cannot edit or add them.

../_images/basic_operations05.png

3.4. Admin mode

ReNomTAG has two modes of operation, normal mode (default) and Admin mode. Admin mode has all functions found in normal mode as well as the following functions.

  • Add/delete class tags.
  • Mark tagged images as OK or NG.

3.4.1. Enter admin mode

To enter admin mode, please add admin to the URL as shown below.

../_images/basic_operations06.png

The title of the page should change to Admin.

../_images/basic_operations07.png

3.4.2. Add new class tags

If you are in admin mode, you can add new class tags. To do this, type the new class tag name into the form shown below.

Next, click the Add New Tag button.

You can also add a shortcut key. The shortcut key can be changed in either admin or normal mode.

../_images/basic_operations08.png

3.4.3. Delete class tags

If you are in admin mode, you can also delete existing class tags. To do this, click the Delete Tag List button shown in red below.

Next, select the individual tags you would like to delete, and click Delete.

../_images/basic_operations09.png

3.4.4. Apply marks to images

Admin mode also provides a marking function. You can mark tagged images as OK or NG.

To apply a mark, please click the OK or NG button.

../_images/basic_operations10.png

After clicking the save button, the mark will be saved.

3.4.5. Return to normal mode

To return to normal mode, please remove admin from the URL.


3.5. Use ReNomTAG with multiple users

You can add multiple user directories under the public folder and then choose which directory you would like to work on.

../_images/basic_operations11.png

The image above represents the following directory structure. There are 4 user directories (Alice, Bob, user1 and user2).

working_directory # Current Working directory
    │
    └── public
        │
        ├── Alice
        │   ├── dataset
        │   │   ├── image1.jpg
        │   │   ├── ...
        │   │   └── imageN.jpg
        │   └── label
        │       ├── image1.xml
        │       ├── ...
        │       └── imageN.xml
        │
        ├── Bob
        │   ├── dataset
        │   │   ├── image_car1.jpg
        │   │   ├── ...
        │   │   └── image_carN.jpg
        │   └── label
        │       ├── image_car1.xml
        │       ├── ...
        │       └── image_carN.xml
        │
        ├── user1
        │   ├── dataset
        │   │   ├── image_person1.jpg
        │   │   ├── ...
        │   │   └── image_personN.jpg
        │   └── label
        │       ├── image_person1.xml
        │       ├── ...
        │       └── image_personN.xml
        │
        └── user2
            ├── dataset
            │   ├── image_bird1.jpg
            │   └── image_bird2.jpg
            └── label
                ├── image_bird1.xml
                └── image_bird2.xml

You can access and work in any user directory. The data in each directory is not shared with other directories.

Note

The user-separated directories are recognised by ReNomTAG if they contain the dataset and label sub-directories.

3.6. Supported Browsers

ReNomTAG currently supports Google Chrome. In some instances, default shortcut keys for Google Chrome may conflict with ReNomTAG shortcut keys. Please disable the browser shortcut key in order to use the corresponding shortcut in ReNomTAG.