Single-label image classification / cheat sheet

Use this cheat sheet

If your input data consists of labeled images containing exactly one of multiple classes. This is called single-label classification.

Example use cases

Note
Disclaimer
Please note that data sets, models and other content, including open source software, (collectively referred to as "Content") provided and/or suggested by Peltarion for use in the Platform, may be subject to separate third party terms of use or license terms. You are solely responsible for complying with the applicable terms. Peltarion makes no representations or warranties about Content and specifically disclaim all responsibility for any liability, loss, or risk, which is incurred as a consequence, directly or indirectly, of the use or application of any of the Content.

MNIST tagged 8 5 PA2

Images that contain exactly one handwritten number from 0 to 9.
(image source)

Data preparation

You can add your dataset in several different ways in the Datasets view. You can read more here on the requirements when you import from your data warehouse, directly from your local computer, via data API, or from an URL.
In this cheat sheet we’ll show you how to add it directly from your computer.

Images that you have on your local computer need to be archived inside a zip file, either with an index file or in structured folders.

Import data with and index.csv

Prepare a zip file with a folder containing all your images and a corresponding index.csv.
The Peltarion Platform supports .jpg or .png.

Format of index.csv

Structure of index.csv

The index.csv file is a simple text file where columns are separated by a comma: ",". Each column will be imported as a dataset feature, where the name of the feature is taken from the first line.

You need to give at least two features: the images and their target classes. To specify the images, write the name of the image file, together with their paths inside the zip file if they are located in subfolders.

Example:

Zip file structure containing images and an index file.

No csv structure

If the zip file does not contain any csv file, you must organize the included files in a folder- and subfolder-structure. Include all files in one category on one folder and name the folder.

Modeling

Use the Experiment wizard to build a model.

Zip file containing images but no index.

The first image files found are located in the second level of subfolders. Thus, the categorical features category_0 and category_1 are automatically created based on the folder names.

However, the car images are located in only one level of subfolder. As a result, they are not imported in the dataset.

Try the smallest depth model first

Try the smallest depth model first, since it will be faster to train and may already be complex enough to model your data well.

If the results are not good enough, you can move towards increasingly deep models in later experiments.

Run experiment

When you’ve created an experiment with the Experiment wizard, a ready-to-run model will populate the Modeling canvas. Everything needed will be set, input and target feature, weights (if you wanted those), loss function, activation, runtime settings, i.e., batch size, learning rate, number of epochs.

You can still edit/add/remove anything on the Modeling canvas or override all the existing choices, delete blocks, and add a new ones.

The only thing left to do is to press the Run button on the upper right corner to start the training process.

Run button

Deploy experiment view

Click New deployment.

Select your experiment and epoch for deployment.

Click the Enable switch to deploy the experiment.

Enable button

Image Classifier web app

To make it easier to test your model, we have provided a Image Classifier web app.

Click Open web app.

Open web app button
Deployment web app
Figure 1. Deployment web app
Was this page helpful?
YesNo