Skip to content


Concepts and Terms

  • Attribute Definitions are templates. They have a name and a value type, such as String, Number, or Boolean. Definitions must be created before attribute values can be assigned. Tracks and detections each have their own set of definitions.
  • Track Attributes apply to an entire track. Each track can only have one value for each track attribute definition.
  • Detection Attributes can be different for every frame in a track.

Example Attribute Definition

  • Track Attributes:
    • CompleteTrack: Boolean
    • FishLength: number (cm)
  • Detection Attributes:
    • Swimming: Boolean
    • Eating: Boolean

Example Attribute Values

  • Fish Track 1
    • Track Attributes
      • { "FishLength": 20 }
    • Detection Attributes
      • Frame 1
        • { "Eating": True }
      • Frame 2
        • { "Swimming": False, "Eating": True }


All Attribute definitions do not need to be assigned to values. CompleteTrack (Track Attribute) and Swimming for Frame 1 (Detection Attribute) weren't assigned in this example.

Using the Attributes Panel

Track Details Full Panel

  1. Select an existing track or detection with left click.
  2. Open the Track Details page by clicking on the button in the Type List area or pressing the A key.
  3. Here you will see the track/detection type, confidence pairs associated with it and then a list of track and detection attributes.
  4. For attributes there are two sections
    1. Track Attributes - All track level attributes
    2. Detection Attributes - attributes associated with the track on a per frame basis
  5. Attributes can be sorted by their name (alphabetically) or by their numeric value. Clicking on the or the button will swap between the two.
  6. Attribute Filtering
    1. The Attribute filtering icon will change color when filtering is being applied.
    2. Clicking on the filter icon will bring up the Attributes Details Panel


Attributes found during import in a VIAME CSV will automatically show up in the list. The data type of the attribute is guessed by examining values and may need to be manually corrected.

By default, all attributes associated with the dataset are visible and editable. You can hide unused attributes by clicking the toggle next to Attribute.

Show Unused Hide Unused
'Edit Attributes' 'View Attributes'

Creating Attribute Definitions

  1. Click on the Attribute icon for in either the track or detection attribute area.
    1. New Attribute Panel
  2. Enter a unique name
  3. Choose a Datatype
    1. Number
    2. Boolean (True/False)
    3. Text
      1. Custom text that the user provides
      2. A predefined list of text to choose from, separated by newline.
  4. Click Save to add the new attribute

Editing Attribute Definitions

Click the button next to an existing attribute to edit its definition.

Edit Attribute Panel


Editing or deleting an attribute definition doesn’t change any existing attribute values.

  • Deleting an attribute definition will cause it to disappear from the list, but the values will remain in the database.
  • Editing an attribute definition will change the way the controls behave, but will not change any existing set values.

Setting Attribute Values

  1. Click on the attribute value when in viewing mode to edit and set the attribute
  2. Or directly edit the value field when in the attribute editing mode
  3. Setting an attribute to the empty value will remove the value from the track/detection

Importing and Exporting Attributes

Attributes are part of the dataset configuration that can be imported and exported.

  1. Set up a dataset with all the attributes you need
  2. In the Download menu, choose Configuration.
  3. Use this configuration with other datasets
    1. Use the Import button to load this configuration to other datasets.
    2. Upload the configuration file when you create new datasets to initialize them with these attribute definitions.

Applying Attributes Demo

Applying Attributes Demo