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.
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
, orellipse
. - 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 | | | |