Classifiers

Classifiers are used to filter objects by various attributes in videos. They can be used in queries to , e.g. look for 'PPE helmet' for Person objects or 'Emergency Vehicle' for Car objects.

You can find the list of available Classifiers here.

1. In the upper right corner, click the Settings button.

2. Click Classifiers.

All classifiers added to IRIS+ Professional are listed here, along with their various properties. You can also upload new classifiers and delete existing ones.

2. Click the +Upload new classifier button.
3. Browse for and upload an .fsl file using the upload interface.

Create Text Classifier

You can also create a text classifier directly in the UI. This is useful for simple classifiers that do not require complex training.

Read below for examples of classifiers you can create.

1. In the Classifiers page, click the Create classifier button.

2. Enter a name for the classifier.

3. Select one or multiple object types for which the classifier will be used (e.g., Person, Car, etc.).

Object Types

You can select multiple object types to create a classifier that applies to all of them. For example, you can create a classifier for both Car and Truck objects if you want to filter both types based on the same text pattern - e.g. "White vehicles".

Referencing the object type in class sentences (e.g. "Person wearing baseball cap") is not required, as the classifier will already match objects of the selected types.

4. Add classes to the classifier by clicking the +Add Class button.

Classes are the specific attributes you want to filter by, such as "Emergency" for vehicle objects or "PPE helmet" for Person objects. Each class must be mutually exclusive and must cover all possible cases, meaning that no two classes should overlap in their definitions. At least two classes must be added to a classifier.

Once multiple classes are added, the classifier will match objects based on the sentences provided in each class and will assign the object to the class that matches the sentences.

Do not use negation in class sentences, such as "non-blue vehicles" or "not wearing helmet".

Classifiers are designed to match specific attributes, so using negation can lead to unexpected results. Instead, to specify an object without any attributes (e.g. people not wearing a helmet), simply add the object type itself as the sentence - e.g. for a "no helmet" class, add "Person" as the sentence. You may use negation in the classifier and class names.

• Class Name: Enter the name of the class (e.g., "White vehicles").

• Sentences: Enter the sentences that will be used to match the class. You can add multiple sentences, each on a new line. For example, if you want to match "White car", "White truck", etc., you can enter those sentences here.

Example Classifiers

Vehicle coloursEmergency vehiclesPerson wearing any headwearPerson wearing a specific headwear

To create a classifier for vehicle colours, you can do so with the following properties:

• Object Types: Car, Truck (or any other relevant vehicle types)

• Classifier Name: "Vehicle colours"

• Classes:

  • Class 1: "Yellow vehicles"

  • Sentence: "Yellow"

  • Class 2: "White vehicles"

  • Sentence: "White"

  • Class 3: "Black vehicles"

  • Sentence: "Black"

Add all remaining colours.

To create a classifier for emergency vehicles, you can do so with the following properties:

• Object Types: Car, Truck (or any other relevant vehicle types)
• Classifier Name: "Emergency vehicles"

• Classes:

  • Class 1: "Emergency vehicles"

  • Sentences:

    1. "Emergency vehicle"

    2. "Vehicle with siren"

    3. "Police car"

    4. "Fire truck"

    5. "Ambulance"

  • Class 2: "Regular vehicles"

  • Sentences:

    1. "Car"

    2. "Truck"

    3. "Van"

A classifier with the following properties will let you filter for two kinds of detections: people wearing any headwear and people without headwear.

• Object Types: Person
• Classifier Name: "Headwear"

• Classes:

  • Class 1: "Headwear"

  • Sentences:

    1. "PPE helmet"

    2. "Safety helmet"

    3. "Hard hat"

    4. "Baseball cap"

    5. "Cap"

    6. "Hat"

    Add all possible types of headwear in separate sentences.

  • Class 2: "No headwear"

  • Sentences:

    1. "Person"

A classifier with the following properties will let you look for specific types of headwear worn by people.

• Object Types: Person
• Classifier Name: "Specific headwear"

• Classes:

  • Class 1: "No headwear"

  • Sentence: "Person""

  • Class 2: "Baseball cap"

  • Sentence: "Baseball cap"

  • Class 3: "PPE helmet"

  • Sentence: "PPE helmet"

  • Class 4: "Hard hat"

  • Sentence: "Hard hat"

Add all other types of headwear you would like to search for in separate classes.