AutoMerge

A tool for automatically finding the two best matching frames at the end of one video file and the beginning of another video file.

The tool supports four different image similarity metrics:

• MSE - Mean Squared Error
• NRMSE - Normalized Root Mean Squared Error
• PSNR - Peak Signal-to-Noise Ratio
• SSIM - Structural Similarity Index Measure

Usage

AutoMerge.py {options} {leading video} {following videos} {seconds} {method}

Finds the best matching frames in the {seconds} last seconds of {leading video} and the {seconds} first seconds of {following videos}, using {method} as similarity measure.

• {leading video} is the path to the leading video.

• {following videos} is the path or a comma separated list of paths to one or several following videos.

• {seconds} is the number of seconds to search.

• {method} is the similarity measure to use. Valid options are: mse, nrmse, psnr, and ssim.

• {options} can be any combination of the following:

  • --verbose {integer} where {integer} can be any of the following:
    • 0 = nothing
    • 1 = stage of operation
    • 2 = threading and time
    • 3 = detailed processing
  • --colour or --greyscale: colour on / off (default off)
  • --downscale or --no-downscale: downscale on / off (default on)

AutoMerge.py --help shows this usage information.

GUI

Alternatively the GUI can be used by running GUI.py. The GUI will always run with {verbose} set to 3.

Stitch

A tool for stitching together two video files and generates images showing the error of the stitch. Useful for testing the result of AutoMerge.

Provided two video files, two frame numbers, and two duration numbers, it will generate a .mp4 video file consisting of a combination of a portion of the first video file up until the first frame number and a portion of the second video file starting at the second frame number. Both portions are the length of the two duration numbers, respectively. This file will be placed in a subdirectory out, together with four .jpg files. The first two images are the frames from the videos where the stitch is made, the third image is the absolute error of the two frames, and the fourth image is the SSIM error of the two frames.

Usage

stitch.py {options} {first video} {second video} {first frame} {second frame}

• {first video} is the path to the first video.

• {second video} is the path to the second video.

• {first frame} the number of the frame to stitch at in the first video.

• {second frame} the number of the frame to stitch at from the second video.

• {options} can be any combination of the following:

  • -l {integer} or --lead-len {integer}: Number of seconds from lead video to include, {integer} has to be greater than 0, and defaults to 5.
  • -f {integer} or --follow-len {integer}: Number of seconds from following video to include, {integer} has to be greater than 0, and defaults to 5.

stitch.py --help shows usage information.