xenial (1) limereg.1.gz

NAME

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

SEE ALSO

       The  full  documentation for limereg is maintained as a Texinfo manual.  If the info and limereg programs
       are properly installed at your site, the command

              info limereg

       should give you access to the complete manual.