STScI Logo

rtodbx stsdas.hst_calib.foc.focgeom


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

NAME

rtodbx -- Produce reseau data in a format suitable for geometry tasks in the images package.

USAGE

rtodbx input1 entry input2 refentry output

DESCRIPTION

This task produces reseau coordinates in a format that can be used by tasks outside the foc package, such as tasks in the images package. The file produced by rtodbx will contain lines having the columns XDIST, YDIST, (i.e., the distorted X and Y positions) XREF, and YREF (i.e., the reference X and Y positions). Four coordinates are generated for each point, corresponding to a distorted position and a reference position.

Both the distorted and reference reseau positions can be taken from the same reseau table, input1, or the reference positions can be taken from a separate reseau table, input2, if that parameter is not null.

PARAMETERS

input= [file name]
The reseau file used as input.
entry = * [string]
Name of the distorted positions entry. The default "*" will use the first entry in input1.
input[file name]
Optional parameter containing the name of a second reseau file that will provide reference positions. If this parameter is omitted, then input1 will provide references.
refentry = * [string]
Name of the reference position entry. The default "*" will use the first entry in input2, if provided, otherwise it will use the first position in input1.
output = STDOUT [file name]
File name for the output text file produced by rtodbx.

EXAMPLES

1. Produce a file called out.txt that will contain the distorted positions and reference positions from the dist and ref entries, respectively, in the file inres.


fo> rtodbx inres.tab dist "" ref out.txt

BUGS

REFERENCES

This task was written by David Giaretta.

SEE ALSO

geomap in the images package

Type "help focgeom option=sys" for a higher-level description of the focgeom package.

Type "help reseau" for a description of reseau files.


Source Code · Package Help · Search Form · STSDAS