---
name: "limereg"
section: "1"
platform: "linux"
package: "limereg"
version: "1.4.1-4+b1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/limereg"
---

# limereg(1)

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

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.