STScI Logo

rplotx stsdas.hst_calib.foc.focgeom


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

NAME

rplotx -- Compare reseau grids, plotting vector differences.

USAGE

rplotx input1 entry input2 refentry

DESCRIPTION

This program plots magnified vector differences between similar-sized reseau grids. One or more plots may be produced to show different types of relations; you can produce a plot to show differences between pairs of reseau grids, differences between adjacent reseau marks, or movement of reseau marks through a series of grids.

Plots use the following symbols:


 "O" Indicates vector base (taken from the reference grid).

 "+" Indicates that a mark exists in the reference file, but not
     in the input file.

 "." Indicates that a mark in the input file has no corresponding
     reference mark.

A mark is presumed not to exist if the coordinate in the reseau file is INDEF, i.e., if there is a "hole."

Plotted vector lengths can be compared with the spacing between base marks (expressed in pixels), which can be read from the plot, bearing in mind the magnification factor.

PARAMETERS

input[file name]
Name of the input reseau file.
entry = * [string]
Entry names to be plotted from the input1 file. The default "*" will process all entries.
input[file name]
Name of the optional reseau file used as reference. This grid must have the same number of rows and columns as the grid contained in input1. If input2 is not used, then input1 is used as a reference grid. This parameter is not required when option = sequential.
refentry = "" [string]
Entry name identifying reference positions in input2. The default is blank, which matches entry names with those used in input1.
(options = all) [string, allowed values: all | sequential | ref]
Type of difference plot to be generated by rplotx. The value "sequential" will produce a plot showing only the differences between adjacent pairs of reseau marks from input1--the input2 and refentry parameters are ignored when producing a sequential plot. Selecting a "ref" plot will compare the input reseau grid to the reference grid (i.e., it will compare input1 with input2) and plot the differences. If "all" is selected, then a single plot is produced showing both the difference between adjacent marks as well as differences between the input grid and the reference grid.
(magnification = 60.0) [real]
The magnification factor to be used in plotting vectors.
(x= INDEF) [real]
The leftmost coordinate on the X axis to be used in producing the plot. If x1 is INDEF, then data from the reference entry is used.
(x= INDEF) [real]
The rightmost Y coordinate to be used for the plot. If x2 is INDEF, then data from the reference entry is used.
(y= INDEF) [real]
The bottom Y coordinate to be used for the plot. If y1 is INDEF, then data from the reference entry is used.
(y= INDEF) [real]
The top Y coordinate to be used in producing the plot. If y2 is INDEF, then data from the reference entry is used.
(device = "stdgraph") [string]
Which device should be used to plot the graph?

EXAMPLES

1. Find shifts in reseau marks by comparing adjacent marks in the reseau file called inres.


fo> rplotx inres * "" "" opt=seq

BUGS

REFERENCES

This task was written by David Giaretta.

SEE ALSO

rgenx, rprintx

Type "help focgeom opt=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