NAME

tranback -- Transform an X,Y position from output to input pixel position using the same conventions as drizzle

USAGE

tranback xout yout

PARAMETERS

xout = 400 [real]

The X pixel position in an output frame to be transformed.

yout = 400 [real]

The Y pixel position in an output frame to be transformed.

(nxin = 800) [real]

The X dimension of the input image (this is used to determine the centre which is the origin of the transformations).

(nyin = 800) [real]

The Y dimension of the input image (this is used to determine the centre which is the origin of the transformations).

(nxout = 800) [real]

The X dimension of the output image (this is used to determine the centre which is the origin of the transformations).

(nyout = 800) [real]

The Y dimension of the output image (this is used to determine the centre which is the origin of the transformations).

(scale = 1.0) [real]

Linear size of output pixels in terms of input pixels. A scale of 0.5 means a magnification of two from input to output.

(xsh = 0.0) [real]

A shift in X applied to the input position after the geometric transform. This shift may be defined either in the input or output frame, according to the value of the "shft_fr" parameter. Shifts are always along the axes of the image. Positive values shift the image to the right. Units are determined by the "shft_un" parameter.

(ysh = 0.0) [real]

A shift in Y applied to the input position after the geometric transform. This shift may be defined either in the input or output frame, according to the value of the "shft_fr" parameter. Shifts are always along the axes of the image. Positive values shift the image upwards. Units are determined by the "shft_un" parameter.

(rot = 0.0) [real]

The rotation in degrees anti-clockwise applied to the input image after the non-linear part of the transform was been performed. Whether or not the rotation is applied after or before the shifts is determined by the value of the "shft_fr" parameter.

(coeffs = "") [file name]

The name of a text file containing the coefficients for the geometrical transformation to be applied. These geometric transformations are always applied before the shifts, rotations and scale changes specified by other parameters.

(sh_units = "input") [string]

Whether the shifts are specified in units of "input" or "output" pixels.

(shft_fr = "input") [string]

The frame in which the shifts are applied, or to put it another way, whether to apply the rotation before the shifts. If "output" the input image center is mapped to the center of the output grid, rotated about that center and then shifted along the grid of the output image. If "input" then the input image center is mapped to the center of the output image, shifted along the grid of the output image and then rotated about the center of the output image. See notes below for a definition of the center of rotation.

(align = "center") [string]

Whether the reference point used in transforming the input image coordinates to the output ones is aligned on the corner or center of a pixel. If the task is being used to mimic shift-and-add this should be set to "corner" otherwise, and particularly when performing interlacing, it should be set to "center". More details of the definition of the image centers are given below.

(lambda = 555.0) [real]

The wavelength (in nm) associated with the image. This is used for the "Trauger" style coefficients for which the distortion is a weak function of wavelength. It is only relevant for WFPC2 and is otherwise ignored.

DESCRIPTION

This task transforms an X,Y position, assumed to be on an output virtual image of size nxout,nyout, back onto a virtual input image of size nxin,nyin using the conventions of the drizzle task. So, if an object on an input image at a certain position is drizzled with a given set of parameters then the position of that object on the output can be transformed back to where it came from using tranback with the same parameter values. The simple forward transformation can be accomplished using the companion task traxy.

Note that traxy and tranback are inverse operations but the parameters are specified in exactly the same way and don't need to be reversed. This task is iterative, using Newton-Raphson, and may not behave well in extreme cases.

EXAMPLES

If a star is at the position 542.649,1071.763 on an output drizzled
image where was it on the original input WFPC2 chip?

First the parameters of the tranback task are set to match those used by
drizzle then when the image was created, then:

dr> tranback mode=h
+ TRANBACK Version 0.2 (17th December 1999)
-Opening coefficients file: drizzle$coeffs/wf3-trauger
 Xin,Yin:    123.000   456.000 Xout,Yout:    542.649  1071.763

TIMINGS

It is, as one would expect, very quick!

SEE ALSO

drizzle, blot, tra