2. Directory structure

2.1. Directory structure

Before starting ReNomTAG, we will explain the directory structure.

Assuming that you run ReNomTAG from working_directory , image datasets must be aligned according to the following directory structure.

The directory names for the public , dataset and label directories must not be changed.

The role of each directory is described below.

• public

  This is the root directory for datasets. The directory name public must not be changed.

• user1, user2…

  These directories contain image data and user-created label data for each user. These directories’ names can be changed.

• dataset

  This directory contains image data for tagging.

• label

  User-created label data will be automatically saved into this directory.

• detection

  Detection annotation files (.xml) will be automatically saved into this directory. To create a detection dataset for ReNomIMG, copy the xml files in here along with their corresponding image files to the ReNomIMG data folder.

• segmentation

  Segmentation annotation files (.png) will be automatically saved into this directory. To create a segmentation dataset for ReNomIMG, copy the png files in here along with their corresponding image files to the ReNomIMG data folder.

• classification

  Classification label list (target.txt) will be automatically saved into this directory. To create a classification dataset for ReNomIMG, copy the target.txt file in here along with all corresponding image files to the ReNomIMG data folder.

working_directory # Current Working directory
    │
    └── public # This name must be `public`.
        │
        ├── user1 # Dataset for user1. You can use any name for this directory.
        │   ├── dataset # Directory in which image data is placed. This name must be `dataset`.
        │   │   ├── image1.jpg
        │   │   ├── image2.jpg
        │   │   ├── ...
        │   │   └── imageN.jpg
        |   |
        │   └── label # Directory to which tag data will be output. This name must be `label`.
        |       ├── detection # Directory to which detection tag data will be output. The folder name must be set to `detection`.
        |       |   ├── image1.xml # To use detection data in ReNomIMG, please use the xml files here as label files for the corresponding image files.
        │       |   ├── ...
        |       |   └── imageN.xml
        |       |
        |       ├── segmentation # Directory to which segmentation tag data will be output. The folder name must be set to `segmentation`.
        |       |   ├── png # Automatically created by ReNomTAG.
        |       |   |   ├── class_map.txt # Mapping between class id and class name.
        │       |   |   ├── image1.png # To use segmentation data in ReNomIMG, please use the png files here as label files for the corresponding image files.
        │       |   |   ├── ...
        │       |   |   └── imageN.png
        |       |   |
        |       |   └── xml # Automatically created by ReNomTAG
        |       |       ├── image1.xml
        |       |       ├── ...
        |       |       └── imageN.xml
        |       |
        |       └── classification # Directory to which classification label data will output. The folder name must be set to `classification`.
        |           ├── target.txt # To use classification data in ReNomIMG, please use this file as the label file for the corresponding image files.
        |           └── xml # Automatically created by ReNomTAG. Not necessary for using classification data in ReNomIMG.
        │               ├── image1.xml
        │               ├── ...
        │               └── imageN.xml
        │
        ├── user2 # Dataset for user2
        │   │
       ...   ...
        │
        └── userN
            ├── dataset
            │   ├── image_car1.jpg
            │   └── image_car2.jpg
            └── label
                ├── ...

2.2. Provide image data

Please place the image data into the dataset directory.

ReNomTAG is only able to load file names with halfwidth-alphanumeric (0-9, a-z, A-Z) and under-bar (_) characters. Filenames with, for example, hyphen (-), asterisk(*), etc cannot be loaded.

ReNomTAG supports images with “.jpeg”, “.jpg”, “.png”, or “.bmp” file extensions.

---