Skip to content

Extract Tracking Data From nVision Movie

Overview and purpose

Export bounding box estimates and zones from .isxb files with tracking data to a .csv file. Timestamps are aligned to a single start time which is defined as the start time of the specified timing reference file.

Compute Credits

This tool uses 1.0 compute credits per hour.

Parameters

Parameter Required? Default Description
Movie Files True N/A Input .ISXB movie files
Time Ref True start One of 'start', 'unix', 'tsc' – the time reference for the CSV time stamps.

Details

Valid Inputs

Source Parameter File Type File Format
Movie Files nvision_movie isxb

Time Ref

The time reference for the CSV time stamps. If start is used, the timestamps represent the seconds since the start of the movie. If unix is used, the timestamps represent the seconds since the Unix epoch. If tsc is used, the timestamps represent the hardware counter value on the acquisition box when each frame was captured.

Outputs

Tracking

A CSV containing the tracking information, table will have the following columns:

  • Global Frame Number - The frame number in the movie, relative to the start of the first movie in the series.
  • Movie Number - The number of the movie in the series.
  • Local Frame Number - The frame number in the movie, relative to the start of the movie.
  • Frame Timestamp - The time of the frame in seconds, relative to the start of the movie.
  • Bounding Box Left - The left X coordinate of the bounding box.
  • Bounding Box Top - The top Y coordinate of the bounding box.
  • Bounding Box Right - The right X coordinate of the bounding box.
  • Bounding Box Bottom - The bottom Y coordinate of the bounding box.
  • Bounding Box Center X - The X coordinate of the center of the bounding box.
  • Bounding Box Center Y - The Y coordinate of the center of the bounding box.
  • Confidence - The confidence of the tracking algorithm in the tracking result. Values range from 0 to 1.
  • Zone ID - Unique identifier for the zone if the center of the bounding box is within a zone.
  • Zone Name - The name of the zone if the center of the bounding box is within a zone.

An example output is shown below:

Global Frame Number Movie Number Local Frame Number Frame Timestamp (s) Bounding Box Left Bounding Box Top Bounding Box Right Bounding Box Bottom Bounding Box Center X Bounding Box Center Y Confidence Zone ID Zone Name
20 0 20 1.00 51.56 155.91 133.80 224.07 92.68 189.99 31.01 4272235054 Rectangular Zone
21 0 21 1.05 55.21 154.12 127.26 226.53 91.23 190.32 15.08 4272235054 Rectangular Zone
22 0 22 1.10

Zones

A CSV containing the zone information, table will have the following columns:

  • ID - Unique identifier for the zone, this will match the Zone ID in the tracking file.
  • Enabled - A boolean indicating if the zone was enabled during the tracking.
  • Name - The name of the zone , this will match the Zone Name in the tracking file.
  • Description - A description of the zone.
  • Type - The type of the zone, this will be rectangle, polygon, or ellipse.
  • X # - A series of columns representing the X coordinates of the zone.
  • Y # - A series of columns representing the Y coordinates of the zone.
  • Major Axis - The major axis of the ellipse.
  • Minor Axis - The minor axis of the ellipse.
  • Angle - The angle of the ellipse.

An example output is shown below:

| ID | Enabled | Name | Description | Type | X 0 | Y 0 | X 1 | Y 1 | X 2 | Y 2 | X 3 | Y 3 | X 4 | Y 4 | X 5 | Y 5 | X 6 | Y 6 | X 7 | Y 7 | Major Axis | Minor Axis | Angle | |-------------|---------|-------------------|-------------------|-----------|---------|---------|---------|---------|---------|---------|---------|---------|---------|---------|---------|---------|---------|---------|---------|------------|------------|-------| | 1705078995618 | 1 | Ellipse Zone | | ellipse | 179.315 | 422.524 | | | | | | | | | | | | | | | 94.6154 | 19.6036 | 90 | | 1705079284270 | 1 | Rectangular Zone | | rectangle | 78.4144 | 54.4471 | 471.629 | 54.4471 | 471.629 | 295.604 | 78.4144 | 295.604 | | | | | | | | | | | | | 1705079359582 | 1 | Polygon Zone | | polygon | 212.18 | 321.923 | 329.802 | 320.769 | 340.18 | 390 | 416.288 | 340.385 | 471.64 | 368.077 | 470.486 | 447.692 | 351.712 | 452.308 | 254.847 | 447.692 | | | |

Previews