manual register
Description
Perform manual registration of two images. One input image is designated as "fixed", the other as "moving".
The node will find a transform that maps the moving image onto the fixed image, and a translation that will ensure that both images remain uncropped. The fixed image will be translated only, the moving image will be transformed and then translated. Both transformed images are output and can then be merged or overlaid in a separate node.
The transform is found by designating points in each image which correspond to each other. The number of points must be the same in each image, and at least three (unless "translate only" is selected).
The canvas view can show the moving input, the fixed image, the transformed moving image, or the transformed fixed image. All images are shown as greyscale (since the input images will likely have different frequency bands).
The transform used is one of the following homographies:
- Euclidean - translation and rotation only
- Similarity - translation, rotation, and scaling; angles are preserved
- Affine - translation, rotation, scaling, and shearing; parallel lines are preserved
- Projective - translation, rotation, scaling, shearing, and perspective; straight lines are preserved
Points are added to the moving image by clicking with ctrl. Points are adding to the fixed image by clicking with shift.
If only the moving or fixed points are shown, either shift- or ctrl-clicking will add to the appropriate point set. The selected point can be deleted with the Delete key (but this will modify the numbering!)
Note that this node does not currently display DQ or uncertainty data in its canvas
A point can be selected and dragged by clicking on it. This may be slow because the warping operation will take place every update; disabling 'auto-run on change' is a good idea!
Uncertainty is warped along with the original image, as is DQ using nearest-neighbour (which may not be sufficient).
Connections
Inputs
| Index | Name | Type | Desc |
|---|---|---|---|
| 0 | moving | img | (none) |
| 1 | fixed | img | (none) |
Outputs
| Index | Name | Type | Desc |
|---|---|---|---|
| 0 | moving | img | (none) |
| 1 | fixed | img | (none) |
Parameters
| manual register | showMoving: boolean (default True) | Show moving points | |
| showFixed: boolean (default True) | Show fixed points | ||
| translate: boolean (default False) | Translate only - no other transform. Uses a single point. | ||
| moving: list | (ordered) | x: integer (default 0) | X coordinate |
| y: integer (default 0) | Y coordinate | ||
| fixed: list | (ordered) | x: integer (default 0) | X coordinate |
| y: integer (default 0) | Y coordinate | ||
| transform: string (euclidean, similarity, affine, projective) (default 'euclidean') | Transform type |
Automatically generated by generate_autodocs.py
Date: 2025-10-24T15:30:01.755150