orient: Reorient image to N up and E left or undo re-orientation

Package: xdimsum

Usage

orient input y2n_angle

Parameters

input
The name of the input image to be reoriented.
y2n_angle
The angle in degrees from the image y axis to the north axis measured from north through east. Y2n_angle must be between 0.0 and 360.0 degrees.
rotation = yes
Is the rotation of the input image north axis to the east axis counter-clockwise ?
invert = no
Invert the original reorientation ? If invert = yes then the input image is returned to its original orientation.

Description

ORIENT orients the input image input to within 45 degrees of north up and east to the left using the geometry parameters y2n_angle and rotation. The reorientation operation can be undone by setting invert = yes.

ORIENT is used by the XNREGISTAR task to orient the output combined image to within 45 degrees of north up and east left, and by the MASKDEREG task to return the object mask created from the combined image to the original orientation before creating object masks for the individual images.

Examples

1. Reorient an image which is already in the default orientation, i.e. do nothing.

cl> orient ss_demo01 0.0 rotation+ invert-

2. Reorient an image with north pointing left and east pointing down.

cl> orient ss_demo01 90.0 rotation+ invert-

3. Reorient an image with north pointing left and east pointing up and then return it to the original orientation.

cl> orient ss_demo01 90.0 rotation- invert-
cl> orient ss_demo01 90.0 rotation- invert+

Time requirements

Bugs

See also

xnregistar, maskdereg