STScI Logo

improject stsdas.toolbox.imgtools


NAME · USAGE · DESCRIPTION · PARAMETERS · EXAMPLES · BUGS · REFERENCES
SEE_ALSO

NAME

improject -- Project an image along a chosen axis, decreasing the number of dimensions in the image by one.

USAGE

improject infile outfile projaxis

DESCRIPTION

This program projects an image along a chosen axis, producing an image with one fewer dimensions. The axis projected may be either summed or averaged. Processing a 1-dimensional image produces a 1-dimensional image with a single element.

The task appends an image section to each input image name to serve as a template for the output image; this reduces the dimension and establishes appropriate coordinate parameters for the output. For this reason, the input image name must not include an image section.

PARAMETERS

input [file name list]
List of input file names. An image section may not be used with the image names.
output [file name list]
List of output file names, one for each input file.
projaxis = [integer, min=1]
Axis along which to project. If this value exceeds the number of dimensions in an input image, then no operation will be performed.
(average = no) [boolean]
Average the image along the specified axis? If average=no, the task will produce a sum along the axis.
(highcut = 0.0) [real]
All values equal to or greater than, highcut will be disregarded, unless highcut=lowcut, in which case all points will be used.
(lowcut = 0.0) [real]
All values equal to or less than, lowcut will be disregarded, unless highcut=lowcut, in which case all points will be used.
(pixtype = real) [string, allowed values: real | long | int |
short | double]
Data type desired in the output image.
(verbose = yes) [boolean]
Print the file names of each image pair as they are processed?

EXAMPLES

1. Project an image along axis 2. If the input image is 2-dimensional, this example will produce a 1-dimensional image by summing the columns of the input image.

  im> improject inim outim 2

BUGS

REFERENCES

This task was written by David Giaretta.

SEE ALSO


Source Code · Package Help · Search Form · STSDAS