STScI Logo

shiftlines images.imgeom


NAME · USAGE_ · PARAMETERS · DESCRIPTION · EXAMPLES · TIMINGS
BUGS · SEE_ALSO

NAME

shiftlines -- shift lines in a list of images

USAGE

shiftlines input output shift

PARAMETERS

input
List of images to be shifted. Image sections are allowed.
output
List of output image names. If the output image name is the same as the input image name then the shifted image replaces the input image.
shift
Shift in pixels.
interp_type = "linear"
The interpolant type use to computed the output shifted image. The choices are the following:
nearest
nearest neighbor interpolation.
linear
linear interpolation in x.
poly3
third order interior polynomial in x.
poly5
fifth order interior polynomial in x.
spline3
cubic spline in x.
sinc
sinc interpolation in x. Users can specify the sinc interpolant width by appending a width value to the interpolant string, e.g. sinc51 specifies a 51 pixel wide sinc interpolant. The sinc width input by the user will be rounded up to the nearest odd number. The default sinc width is 31 pixels.
drizzle
1D drizzle resampling. Users can specify the drizzle pixel fraction by appending a value between 0.0 and 1.0 in square brackets to the interpolant string, e.g. drizzle[0.5]. The default value is 1.0. The value 0.0 is increased to 0.001. Drizzle resampling with a pixel fraction of 1.0 is identical to linear interpolation.
boundary_type = "nearest"
Boundary condition for shifts outside the input image. The minimum match abbreviated choices are:
"nearest"
Use the values of the nearest boundary pixel.
"wrap"
Generate a value by wrapping around to the opposite boundary.
"reflect"
Generate a value by reflecting around the boundary
"constant"
Use a user supplied constant pixel value.
constant = "0.0"
The constant for constant boundary extension.

DESCRIPTION

The list of images in input is shifted by the amount shift and copied to the list of output images output . The number of output image names must be the same as the number of input images. An output image name may be the same as the corresponding input image in which case the shifted image replaces the input image.

The shift is defined by the following relation.

xout = xint + shift

Features in the input image are moved to higher columns when the shift is positive and to lower columns when the shift is negative. For example, to shift a feature at column 10 to column 12 the shift is 2.0. The task has been optimized for integral pixel shifts.

There are five choices for the one dimensional image interpolation which is selected with the parameter interp_type . The value of the output pixels corresponding to input pixel positions outside the boundaries of the image is determined by the parameter boundary_type .

EXAMPLES

1. Shift the lines of an image by 0.25 pixels to the right.

cl> shiftlines imagein imageout 0.25

2. Shift the lines of an image by -.3 pixels using cubic spline interpolation and replace the input image by the output image.

cl> shiftlines image image -.3 interp=spline3

TIMINGS

It requires approximately 28 and 59 seconds to shift a 512 square image using linear and cubic spline interpolation respectively (Vax 11/750 with fpa).

BUGS

SEE ALSO

imshift, magnify, rotate, imlintran, blkrep, blkav, geotran


Source Code · Search Form · STSDAS