Manual Mode

Table of Contents



What is manual mode?

Manual mode is one of two ways to correct the results of tracking.

The following operations can manually be performed on each object:

  • Add New Track
  • Remove Track
  • Join Tracks
  • Break Track
  • Adjust Track
    • Adjust Size of Object
    • Flip Orientation of Object
    • Adjust Location and Orientation of Object
  • Mark Track Completed

How do I switch to manual mode?

Manual mode is pre-selected by default when entering correction mode in ABC Tracker. To return to manual mode after performing corrections during "Guided Mode," click on the green "Guided Mode" button.


How do I perform each type of manual review?

Add New Track

To add a new track:

  1. Right click on the region of the video where the new track should be added
  2. Type "n" or click on the "Add New Track" button



  3. Click on the center of the new object, and drag the cursor in the direction of the object's head before releasing; the length of the generated line is not important, but the direction of this line is important



  4. Adjust the size of the new object using the adjustment diamonds on each side of the bounding box (red arrows below). The orientation can also be adjusted using the extra adjustment diamond at the object's head (black arrow below).



  5. Save changes either by (a) right clicking on the object and selecting the green checkmark, or (b) clicking the green checkmark in the toolbox to the left side of the viewing window


Remove Track

To remove an existing track:

  1. Click on the track to be removed
  2. Type "r" or select the "remove track" button that appears in the toolbox (see below)

     

Join Tracks

The join feature is used when ABC Tracker has generated two separate tracks (different bounding boxes) for the same object. This can happen at the beginning or end of a track. Performing a join operation will merge the track data into a single track.

If there is a gap between the two tracks being merged, it will be filled using linear interpolation. If a significant time gap exists between two objects, it is advised to extend one/both tracks before joining them or to adjust the track positions after the join is performed.

To join two tracks;

  1. Select one of the two tracks to be joined by clicking on it
  2. Type "j" or click on the join button in the toolbox



     

    After click on this button, the bounding box on the selected object will be replaced by a star and the other objects' bounding boxes will be highlighted

  3. Select the track that should be joined with the first track



  4. Click on the join button again (see step 2)


Break Track

The break feature is used when a single track should be split into two tracks. In the event of an ID switch, both tracks can be broken and then joined to their correct tracks.

  1. Select an object by clicking on it
  2. Scrub to the frame where the break should occur

    When breaking a track, the current frame will be the last frame of the first track. The new track will begin on the next frame.

  3. Type "b" or click on the "Break Track Here" button in the toolbox (see below)


Adjust Track: Adjust Size

To modify the size of an object for all frames in the video:

  1. Select an object by clicking on it
  2. Type "a" or click the "Adjust Track" button in the toolbox (see below)



  3. Click on the "Adjust Size" button in the toolbox (see below)



  4. Adjust the size of the new object using the adjustment diamonds on each side of the bounding box (red arrows below). The orientation can also be adjusted using the extra adjustment diamond at the object's head (black arrow below).



  5. Save changes either by (a) right clicking on the object and selecting the green checkmark, or (b) clicking the green checkmark in the toolbox to the left side of the viewing window

Adjust Track: Flip Orientation

The orientation of an object is indicated by a diamond on the head-edge of the object's bounding box. That orientation can be flipped 180 degrees using an orientation adjustment.

To modify the orientation of an object:

  1. Select an object by clicking on it
  2. Type "a" or click the "Adjust Track" button in the toolbox (see below)



  3. Click on the "Flip Orientation" button in the toolbox for the type of flip to be performed (see below)
    1. There are three types of orientation flips:
      1. Flip orientations before current frame
      2. Flip all orientations
      3. Flip orientations after current frame



        Currently, orientation flip types (i) and (iii) will not change the objects orientation. In an effort to improve the tracking algorithm, a sudden flip of an object is not presently allowed. To request this feature, please submit a feature request

  4. Save changes either by (a) right clicking on the object and selecting the green checkmark, or (b) clicking the green checkmark in the toolbox to the left side of the viewing window

Adjust Track: Adjust Location and Orientation

The orientation of an object is indicated by a diamond on the head-edge of the object's bounding box. That orientation can be flipped 180 degrees using an orientation adjustment.

To modify the orientation of an object:

  1. Select an object by clicking on it
  2. Type "a" or click the "Adjust Track" button in the toolbox (see below)



  3. Once the object is selected, the X, Y, and THETA values for that object at that frame can be modified:
    1. Click on the center of the object and drag the mouse in the direction of the object's head before releasing the button on the mouse; although the length of the arrow is not important, the direction of the arrow is important

      A mark can be repeated as many times as needed; only the final state of the mark will be saved




    2. Continue scrubbing forward or backward in video to complete as many marks as desired; the marks will be indicated by a circle on the time bar (see below)

      Caution

      Important: the gaps between manual adjustments will be filled with linear interpolation, meaning all data between adjustment marks (see red area on time bar above) will be replaced with the average time/distance between marks

      It is recommended that:

      • Markings be close together to minimize the impact of linear interpolation
      • A separate adjustment review be performed for each region of a track that needs to be edited

      In a future version, ABC Tracker may perform tracking on the region between adjustment reviews; to request this, please submit a feature request

  4. Save changes either by (a) right clicking on the object and selecting the green checkmark, or (b) clicking the green checkmark in the toolbox to the left side of the viewing window

Mark Track Completed

After a track has been reviewed, that track can be marked "Complete." This will replace the colored bounding box around an object with a white star, making it easier to identify objects that are still being reviewed.

To mark an object complete:

  1. Select an object by clicking on it
  2. Click on the "Mark Completed" button in the toolbox (see below)

Once multiple objects are completed, this feature can help identify which objects still need to be reviewed:

To remove the completed symbol from an object that was previously marked "Complete," repeat steps 1-2 on the completed object.