limereg(1) Lightweight Image Registration

SYNOPSIS

limereg ,--rfile <reference image> --tfile <template image> /[,OPTIONS/]

DESCRIPTION

limereg 1.4.0

limereg - Lightweight Image Registration Performs a simple rigid image registration. The image files must have equal size. Supported image formats: *.bmp, *.dib, *.jpeg, *.jpg, *.jpe, *.jp2, *.png, *.pbm, *.pgm, *.ppm, *.sr, *.ras, *.tiff, *.tif.

OPTIONS

--help
Show usage information.
--version
Show application version and copyright information.
--rfile arg
Template image file (will be transformed). The template and reference images must be equal in size.
--tfile arg
Reference image file (will be matched against). The template and reference images must be equal in size.
--outfile arg
Output image file (optional). Gives the option to save the registered template image as grayscale result.
--maxiter arg
Max. amount of iterations. [Optional parameter, default: 150]
--levels arg
Amount of levels in the multilevel pyramid of shrinked image copies. 0 means autodetect by the formula log2(ImageWidth/32). [Optional parameter, default: 0]
--maxrot arg
Max. expected rotation in degrees. Used for internal optimizations in DSP calculation mode. If a rotation value will become necessary that is higher than specified here, the algorithm will still succeed but the calculation speed will slow down). [Optional parameter, default: 20]
--maxtrans arg
Max. expected translation in percent. Used for internal optimizations in DSP calculation mode. If a translation value will become necessary that is higher than specified here, the algorithm will still succeed but the calculation speed will slow down). [Optional parameter, default: 30]
--invert
Invert the internal grayscale representation. Best registration results are usually obtained with bright content on a dark background, consider setting this parameter, if you have dark content on a bright background. This setting affects only the internal operation, it will not be visible on GUI or file output images. [Flag parameter]
--stopsens arg
Sensitivity of the STOP criteria for the gauss-newton algorithm. [Optional parameter, use ranges between 1 (not sensitive, stops early) to 0.0001 (very sensitive) default: 0.7]
--cdn arg
Clip dark pixels until (including) the given luminance to zero. This reduces image sensor noise in the usually uninteresting dark pixels. A high value optimizes data compression and calculation performance at the cost of calculation accuracy. [Optional parameter, range 0...255, 0 disables any clipping, default: 10]
--nogui
If active no GUI output will be shown. Use this for batch registration of several images. [Flag parameter]

EXAMPLES

limereg --tfile t.jpg --rfile r.png Shifts/Rotates t.jpg for alignment with r.png and displays the result.

limereg --tfile t.bmp --rfile r.tif --nogui --outfile o.jpg Outputs the result to o.jpg, no GUI display. :

COPYRIGHT

Copyright 2014, Roelof Berg, Licensed under the 3-clause BSD license at http://berg-solutions.de/limereg-license.html. Credit goes to Lars Koenig and Jan Ruehaak from Fraunhofer MEVIS in Germany.