Bring your own data

IMAGIMOB Studio provides the flexibility to import your existing datasets from your local hard drive to IMAGIMOB Studio.

Listed below are the specifications that you must follow to format your data.

Supported data formats

You can import different types of data, including audio, video and timeseries data. The table lists the supported data formats.

Data type	File type
Audio	.wav
Data	.csv, .data
Video	.mp4

Supported file formats

You can import data using the following file types in the Studio.

Data file

Data file is a regular comma seperated values (.csv) file that contains the unstructured data with timing information for one single recording.

A data file must meet the following specifications:

1. Each data file should contain the data for a single recording.

2. The naming convention of the data files depend on how the data is organised in the directory:

   • If the data is organised in a nested directory, the name of the data files in all the directories should be identical.

   • If the data is organised in a flat directory, the name of the data files must be recordingname_trackname, where recordingname is a unique recording identifier and trackname is the track name to be displayed in IMAGIMOB Studio. To know more about the directory structure, refer to Structuring the data directory.

3. The file extension should be .csv or .data.

4. The file should be UTF-8 encoded.

5. The first line of the file should be a header line providing column names separated by commas.

6. The remaining lines should consist of floating point numbers separated by commas.

7. The first column should contain the time in seconds from the start of the recording. The timestamps should be increasing.

8. The remaining columns should contain the entire unstructured input data points.

9. The floating point numbers should use a period (.) for decimal separation.

A sample data file -

Label file

Label file is a regular comma seperated values (.csv) file that specifies the classification labels with timing information for a recording.

A label file must meet the following specifications:

1. Each label file should contain the class labels for a single recording.

2. The naming convention of the label files depend on how the data is organised in the directory:

   • If the data is organised in nested directory, the name of the label files in all the directories should be identical.

   • If the data is organised in the flat directory, the name of the label file must be recordingname_trackname, where recordingname is a unique recording identifier and trackname is the track name to be displayed in IMAGIMOB Studio. To know more about the directory structure, refer to Structuring the data directory.

3. The file extension should be .csv or .label.

4. The file should be UTF-8 encoded.

5. The first line of the file should be a header line providing column names separated by commas.

6. The remaining lines should consist of label information fields separated by commas.

7. The floating point numbers should use a period (.) for decimal separation.

8. The file should have the following columns:
   

   • The Time column should list the starting time of the label in seconds.
     
   • The Length column should list the label length in seconds.
     
   • The Label column should list the class identifier. The value allowed is string.
     
   • The Confidence column should list the label confidence in the interval [0.0 .. 1.0], typically 1.0.
     
   • The Comment column should list the comment for your reference. This is optional and the value allowed is string.

A sample label file -

Structuring the data directory

After you create the project, the next step is to import the data into the project. You can import your existing dataset to an empty classification project to start building the model from scratch. You can also import additional dataset to a starter project and fine tune the model as per your business scenarios.

IMAGIMOB Studio supports the following folder structure for importing the data -

Nested folder structure

To import data using the nested folder structure, follow the requirements -

• Each recording should be placed in an individual folder.
• Each recording can contain mutiple data, video or label files.
• The data-label file pair in each folder should be named identically.
• The name of data file in each each folder should be named identically.
• The name of label file in each each folder should be named identically. It is recommended to keep the file name of all the label files as label.label.

A sample nested directory, where Data_A, Data_B, Data_C and Data_D represents the directories, and each directory consists of one data track (.data) and one label track (.label).

Flat folder structure

To import data using the flat folder structure, follow the requirements -

• Every recording or session should be placed in a single folder.
• Each recording can contain multiple data, video or label tracks.
• The data-label file pair belonging to the same recording should be named identically.
• The file name should be recordingname_trackname, where recordingname is the identifier for the recording being labeled and trackname is the track name to be displayed in IMAGIMOB Studio.
  

A sample flat directory, where Data represents the directory consisting three data tracks (.data) and three label track (.label).

After you have formatted the data as per the specifications listed above, you can now import data into IMAGIMOB Studio.