track-features

This program tracks feature point through a video or list of images and produces a track file and optional homography sequence.

The default configuration of this tool depends on algorithm implementations in the FFmpeg and MVG arrows which will only available if the KWIVER_ENABLE_FFMPEG and KWIVER_ENABLE_MVG CMake flags are enabled.

track-features       [options] video-file [track-file]

Required arguments:

video-file - name of input video file.

track-file - name of output track file (default: results/tracks.txt)

Options are:

-h, --help

Display applet usage information.

-c, --config arg

Configuration file for tool.

-o, --output-config arg

Output a configuration. This may be seeded with a configuration file from -c/–config.

-g, --homography-file arg

An output homography file containing a sequence of homographies aligning one frame to another estimated from the tracks.

-m, --mask-file arg

An input mask video or list of mask images to indicate which pixels to ignore.

Default configuration

# Default configuration for the track-features applet

# If true, all mask images will be inverted after loading.
# This is useful if mask images read in use positive
# values to indicated masked areas instead of non-masked areas.
invert_masks = false

# If true, extract metadata from the video and use metadata to
# guide which frames are tracked.
use_video_metadata = true

# A majority of the time, mask images are a single channel,
# however it is feasibly possible that certain
# implementations may use multi-channel masks. If this is
# true we will expect multiple-channel mask images,
# warning when a single-channel mask is provided. If this
# is false we error upon seeing a multi-channel mask image.
expect_multichannel_masks = false

# select the descriptor type
descriptor_type := ocv_ORB
descriptor_binary := true

# Parameters for the feature tracker
block feature_tracker
  include core_feature_tracker.conf

  # The maximum number of frames for the GUI to process.
  # The tracker will choose frames distributed over the video
  max_frames = 500
endblock

block output_homography_generator
  include ocv_homography_estimator.conf
endblock