fitcoords images fitname
images
List of images containing the feature coordinates to be fit. If the
parameter combine is yes then feature coordinates from all the images
are combined and fit by a single function. Otherwise the feature coordinates
from each image are fit separately.
fitname =
If the input images are combined and fit by a single function then the fit
is stored under this name. If the images are not combined then the
fit for each image is stored under the name formed by appending the image
name to this name. A null prefix is acceptable when not combining but it
is an error if combining a list of images.
interactive = yes
Determine coordinate fits interactively?
combine = no
Combine the coordinates from all the input images and fit them by a single
function? If 'no' then fit the coordinates from each image separately.
database = database
Database containing the feature coordinate information used in fitting the
coordinates and in which the coordinate fit is recorded.
deletions = deletions.db
Deletion list file. If not null then points whose coordinates match those in
this file (if it exists) are initially deleted from the fit.
If the fitting is done interactively then the coordinates of
any deleted points (after exiting from the interactive fitting) are recorded
in this file.
function = chebyshev
Type of two dimensional function to use in fitting the user coordinates.
The choices are "chebyshev" polynomial and "legendre" polynomial.
The function may be abbreviated. If the task is interactive then
the user may change the function later.
xorder = 6
Order of the mapping function along the first image axis.
The order is the number of polynomial terms. If the task is interactive
then the user may change the order later.
yorder = 6
Order of the mapping function along the second image axis.
The order is the number of polynomial terms. If the task is interactive
then the user may change the order later.
logfiles = STDOUT,logfile
List of files in which to keep logs containing information about
the coordinate fit. If null then no log is kept.
plotfile = plotfile
Name of file to contain metacode for log plots. If null then no log plots
are kept. When the fitting is interactive the last graph is recorded in
the plot file and when not interactive a default plot is recorded.
graphics = stdgraph
Graphics output device.
cursor =
Graphics cursor input. If null the standard graphics cursor is used.
.ih
? List commands c Print data values for point nearest the cursor d Delete the point or set of points with constant x, y, or z nearest the cursor (p, x, y, z,) f Fit surface l Graph the last set of points (in zoom mode) n Graph the next set of points (in zoom mode) p Graph all features q Quit r Redraw a graph u Undelete the point or set of points with constant x, y, or z nearest the cursor (p, x, y, z,) w Window the graph. Type '?' to the "window:" prompt for more help. x Select data for the x axis (x, y, z, s, r) y Select data for the y axis (x, y, z, s, r) z Zoom on the set of points with constant x, y, or z (x, y, z) :corners Show the fitted values for the corners of the image :function type Set the function for the fitted surface (chebyshev, legendre) :show Show the fitting parameters :xorder value Set the x order for the fitted surface :yorder value Set the y order for the fitted surface
DESCRIPTION A two dimensional function of the image coordinates is fitted to the user coordinates from the specified images;
user coordinate = function (column, line) or z = s (x, y)
The coordinates from all the input images may be combined in a single fit or the coordinates from each image may be fit separately. If the the coordinates from the input images are combined then the fitted function is recorded in the database under the specified name. If the coordinates are fit separately the fitted function is recorded under a name formed by appending the image name to the specified root name.
When the task is interactive the user is first queried whether to perform the fitting interactively. The user may answer "yes", "no", "YES", or "NO" to the query. The lowercase responses apply only to the current fit and the uppercase responses apply to all remaining fits. When the fitting is done interactively the user may change the fitted function and orders iteratively, delete individual coordinates or entire features, and graph the fit and residuals in a number ways. The CURSOR COMMANDS section describes the graphics cursor keystrokes which are available. When selecting data for the graph axes the follow definitions apply:
x Input image column positions y Input image line positions z Input user coordinates s Fitted user coordinates r Residuals (s - z)
A very useful feature is zooming, deleting, or undeleting a subset of data points. The subsets are defined as points with the same x, y, or z value as the point indicated by the cursor when typing (z)oom, (d)elete, or (u)ndelete.
When a satisfactory coordinate fit has been determined exit with the (q)uit key. The user is asked if the fit is to be recorded in the database.
If a deletion list file is specified then the coordinates of any points deleted interactively are recorded in this file. This file then can be read by subsequent fits to initially delete points with matching coordinates. This is generally used when fitting a series of images non-interactively.
Information about the fitted function may be recorded. Textual information is written to the the specified log files (which may include the standard output STDOUT). The last interactive plot or a default non-interactive plot is written the specified plot file which may be examined and spooled at a later time.
A number of strong arc lines are identified along one column of an arc calibration image "arc001". The arc lines are then reidentified at every 20th column. A two dimensional dispersion solution is determined as follows:
cl> fitcoords arc001 fit.
The fitting is done interactively and deleted points are recorded. The fit is recorded under the name fit.arc001. A set of similar arc calibrations are fit non-interactively, with the same points deleted, as follows:
cl> fitcoords arc* interactive=no
Several stellar spectra are identified at different positions along the slit and traced to other lines. A fit to the geometric distortion is determined with the command:
cl> fitcoords star001,star003,star005 fitname=distortion combine=yes
In this case the coordinates from all the tracings are combined in a single fit called distortion.
The plots in the plot file are spooled to the standard plotting device as follows:
cl> gkimosaic plotfile
Gkimosaic is in the plot package.