Ubuntu Manpage: limereg - Lightweight Image Registration

NAME

       limereg - Lightweight Image Registration

SYNOPSIS

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

DESCRIPTION

       limereg 1.4.1

       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.1]

--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