| pexamine | noao.digiphot.apphot | pexamine |
pexamine -- interactively examine or edit a photometry catalog
pexamine input output image
Photcolumns can be changed interactively from within PEXAMINE at the cost of rereading the database.
PEXAMINE supports five types of plots 1) an X-Y column plot 2) a histogram column plot 3) a radial profile plot 4) a surface plot and 5) a contour plot. Each supported plot type has its own parameter set which controls the appearance of the plot. The names of the five parameter sets are listed below.
cntrplot Parameters for the contour plot
histplot Parameters for the column histogram plot
radplot Parameters for radial profile plot
surfplot Parameters for surface plot
xyplot Parameters for the X-Y column plot
The same parameters dealing with graph formats occur in many of the parameter sets while some are specific only to one parameter set. In the summary below those common to more than one parameter set are shown only once. The characters in parenthesis are the graph key prefixes for the parameter sets in which the parameter occurs.
PEXAMINE is a general purpose tool for interactively examining and editing photometry catalogs produced by the APPHOT or DAOPHOT packages. It is intended to aid the user in assessing the accuracy of the photometry, in diagnosing problems with particular catalog objects, in searching the photometry data for relationships between the computed quantities, and in editing the catalog based on those observed relationships. PEXAMINE is intended to complement the more batch oriented editing facilities of the SELECT task.
PEXAMINE takes the input catalog input and the corresponding image image (if defined) and produces an output catalog of selected objects output (if defined) and an output catalog of deleted objects deletions (if defined). The input catalog may be either an APPHOT/DAOPHOT text database or an ST binary table database. The file type of the output catalogs output and deletions is the same as that of input .
READING IN THE DATA
PEXAMINE reads the column data specified by photcolumns and usercolumns for up to max_nstars beginning at star first_star into memory. The photcolumns parameter defines the list of standard photometry columns to be loaded. If "daophot" or "apphot" is selected then the standard columns are GROUP, ID, XCENTER, YCENTER, MSKY, MAG, MERR, CHI, SHARP and NITER and ID, XCENTER, YCENTER, MSKY, MAG and MERR respectively. Otherwise the user must set photcolumns to his or her own preferred list of standard photometry columns. Non-standard columns may also be specified using the parameter usercolumns . Valid column lists contain the full names of the specified columns in upper or lower case letters, separated by commas. Either photcolumns or usercolumns may be redefined interactively by the user after the task has started up, but only at the expense of rereading the data from input .
PEXAMINE will fail to load a specified column if that column is not in the photometry database, is of a datatype other than integer or real, or adding that column would exceed the maximum number of columns limit currently set at twenty. The user can interactively examine the list of requested and loaded standard photometry columns, as well as list all the columns in the input after the task has started up.
GRAPHICS AND IMAGE COMMAND MODE
PEXAMINE accepts commands either from the graphics cursor gcommands (graphics command mode) or the image display cursor icommands if available (image command mode). PEXAMINE starts up in graphics command mode, but all the interactive commands are accessible from both modes and the user can switch modes at any time assuming that the use_display parameter is set to "yes".
PEXAMINE interprets the cursor position in graphics command mode differently from how it interprets it in image command mode. In graphics command mode the cursor coordinates are the position of the cursor in the current plot, whereas in image command mode they are the x and y coordinates of the cursor in the displayed image. For example, if the user issues a command to PEXAMINE to locate the object in the catalog nearest the point in the current X-Y plot marked by the graphics cursor, PEXAMINE does so by searching the data for the object whose values of xcolumn and ycolumn most closely match those of the current cursor position. If the user issues a command to PEXAMINE to locate the object in the catalog corresponding to the object marked on the image display with the image cursor, PEXAMINE does so by searching the data for the object whose values of xposcolumn and yposcoumn most closely match and fall within match_radius of the current cursor position.
Input to PEXAMINE is through single keystroke commands or colon commands. Keystroke commands are simple commands that may optionally use the cursor position but otherwise require no arguments. The PEXAMINE keystroke commands fall into three categories, basic commands, data examining commands and data editing commands, all described in detail in the following sections. Colon commands take an optional argument and function differently depending on the presence or absence of that argument. When the argument is absent colon commands are used to display the current value of a parameter or list of parameters. When the argument is present they change their current value to that argument. The basic colon commands are described in detail below.
BASIC KEYSTROKE COMMANDS
These keystroke commands are used to display the help page, switch from graphics to image command mode and quit the task.
DATA EXAMINING COMMANDS
The data examining commands fall into two categories, those that examine the catalog data including l (catalog listing), o (object listing), x (Y column versus X column plot) and h (histogram column plot) commands, and those which examine the image data around specific catalog objects including r (radial profile plotting), s (surface plotting), c (contour plotting) and m (pixel dumping). The latter group require that image be defined. A brief summary of each data examining command is given below.
DATA EDITING COMMANDS
Data points can be deleted from the catalog in either graphics command mode or image command mode. In graphics command mode the graphics cursor and either the X-Y or histogram plot is used to delete points. In image command mode the image cursor and the displayed image are used to delete points. A data point has three possible states good, marked for deletion and deleted. Any one of the keystroke commands d (delete point), ( (delete points with x less than x cursor), ) (delete points with x greater than x cursor, ^ (delete points with y > y cursor), v (delete points with y < y cursor) or b (delete points in a box) can be used to mark points for deletion. The f key is used to actually delete the points and replot the data. In between marking the points for deletion and actually deleting the marked points the t (toggle) key can be used to undelete the last set marked. The full list of the data editing keystroke commands is given below.
BASIC COLON COMMANDS
All the PEXAMINE parameters can be changed interactively with colon commands, including those which determine which data is read in, which data is plotted and the parameters of each plot. A brief description of the basic commands is given here. The full list is given in the following section.
PEXAMINE Interactive Cursor Keystroke Commands
Basic Commands
? Print help for the PEXAMINE task
: PEXAMINE colon commands
g Activate the graphics cursor
i Activate the image cursor
e Exit PEXAMINE and save the edited catalog
q Quit PEXAMINE and discard the edited catalog
Data Examining Commands
l List the name, datatype and units for all columns in the catalog
o Print out the names and values of the stored columns for the
object nearest the cursor
x Replot the current y column versus the current x column
h Replot the current histogram
r Plot the radial profile of the object nearest the cursor
s Plot the surface of the object nearest the cursor
c Plot the contour plot of the object nearest the cursor
m Print the data values of the object nearest the cursor
p Replot the current graph
Data Editing Commands
z Reinitialize the data by removing all deletions and replot
d Mark the point nearest the cursor for deletion
u Undelete the marked point nearest the cursor
t Toggle between marking points for deletion or undeletion
( Mark points with X < X (cursor) for deletion or undeletion
) Mark points with X > X (cursor) for deletion or undeletion
v Mark points with Y < Y (cursor) for deletion or undeletion
^ Mark points with Y > Y (cursor) for deletion or undeletion
b Mark points inside a box for deletion or undeletion
f Actually delete the marked points and replot
PEXAMINE Interactive Colon Commands
:xcolumn [name] Show/set the X-Y plot X axis quantity
:ycolumn [name] Show/set the X-Y plot Y axis quantity
:hcolumn [name] Show/set the histogram plot quantity
:photcolumns [col1,col2,...] Show/set the list of photometry columns
:usercolumns [col1,col2,...] Show/set the list of user columns
:delete [yes/no] Delete or undelete points
:eparam [x/h/r/s/c] Edit/unlearn the specified plot pset
or
:unlearn
PEXAMINE Interactive X-Y Plotting Commands
:x1 [value] Left world x-coord if not autoscaling
:x2 [value] Right world x-coord if not autoscaling
:y1 [value] Lower world y-coord if not autoscaling
:y2 [value] Upper world y-coord if not autoscaling
:szmarker [value] Marker size
:marker [point|box|plus|cross|circle|diamond|hline|vline] Marker type
:logx [yes/no] Log scale the x axis?
:logy [yes/no] Log scale the y axis?
:box [yes/no] Draw box around periphery of window?
:ticklabels [yes/no] Label tick marks?
:grid [yes/no] Draw grid lines at major tick marks?
:majrx [value] Number of major divisions along x axis
:minrx [value] Number of minor divisions along x axis
:majry [value] Number of major divisions along y axis
:minry [value] Number of minor divisions along y axis
:round [yes/no] Round axes to nice values?
:fill [yes/no] Fill viewport vs enforce unity aspect ratio?
PEXAMINE Interactive Histogram Plotting Commands
:nbins [value] Number of bins in the histogram
:z1 [value] Minimum histogram intensity
:z2 [value] Maximum histogram intensity
:top_closed [y/n] Include z in the top bin?
:x1 [value] Left world x-coord if not autoscaling
:x2 [value] Right world x-coord if not autoscaling
:y1 [value] Lower world y-coord if not autoscaling
:y2 [value] Upper world y-coord if not autoscaling
:logy [yes/no] Log scale the y axis?
:box [yes/no] Draw box around periphery of window?
:ticklabels [yes/no] Label tick marks?
:majrx [value] Number of major divisions along x axis
:minrx [value] Number of minor divisions along x axis
:majry [value] Number of major divisions along y axis
:minry [value] Number of minor divisions along y axis
:round [yes/no] Round axes to nice values?
:fill [yes/no] Fill viewport vs enforce unity aspect ratio?
PEXAMINE Interactive Radial Profile Plotting Commands
:rinner [value] Inner radius of the region to be plotted
:router [value] Outer radius of the region to be plotted
:x1 [value] Left world x-coord if not autoscaling
:x2 [value] Right world x-coord if not autoscaling
:y1 [value] Lower world y-coord if not autoscaling
:y2 [value] Upper world y-coord if not autoscaling
:szmarker [value] Marker size
:marker [point|box|plus|cross|circle|diamond|hline|vline] Marker type
:logx [yes/no] Log scale the x axis?
:logy [yes/no] Log scale the y axis?
:box [yes/no] Draw box around periphery of window?
:ticklabels [yes/no] Label tick marks?
:grid [yes/no] Draw grid lines at major tick marks?
:majrx [value] Number of major divisions along x axis
:minrx [value] Number of minor divisions along x axis
:majry [value] Number of major divisions along y axis
:minry [value] Number of minor divisions along y axis
:round [yes/no] Round axes to nice values?
:fill [yes/no] Fill viewport vs enforce unity aspect ratio?
PEXAMINE Interactive Surface Plotting Commands
:ncolumns [value] Number of columns to be plotted
:nlines [value] Number of lines to be plotted
:axes [yes/no] Draw axes?
:angh [value] Horizontal viewing angle
:angv [value] Vertical viewing angle
:floor [value] Minimum value to be plotted
:ceiling [value] Maximum value to be plotted
PEXAMINE Interactive Contour Plotting Commands
:ncolumns [value] Number of columns to be plotted
:nlines [value] Number of lines to be plotted
:floor [value] Minimum value to be plotted
:ceiling [value] Maximum value to be plotted
:zero [value] Greyscale value of zero contour
:ncontours [value] Number of contours to be drawn
:interval [value] Contour interval
:nhi [value] Hi/low marking option
:dashpat [value] Bit pattern for generating dashed lines
:label [yes/no] Label major contours with their values?
:box [yes/no] Draw box around periphery of window?
:ticklabels [yes/no] Label tick marks?
:majrx [value] Number of major divisions along x axis
:minrx [value] Number of minor divisions along x axis
:majry [value] Number of major divisions along y axis
:minry [value] Number of minor divisions along y axis
:round [yes/no] Round axes to nice values?
:fill [yes/no] Fill viewport vs enforce unity aspect ratio?
1. Examine and edit an APPHOT aperture photometry catalog and a DAOPHOT allstar catalog without either attaching the associated image or using the image display.
pt> pexamine m92.mag.1 m92.mag.ed use_display-
... a plot of magnitude error versus magnitude appears on
the screen and the graphics cursor comes up ready to accept
commands
... the user sees a generally smooth trend of increasing
magnitude error with increasing magnitude except for a
single deviant point at the bright end of the plot
... the user decides to remove the deviant point using the
'd' keystroke command to mark the point and the 'f'
keystroke command to actually delete and replot the graph
... after examining the plot further the user decides to delete
all objects for which the magnitude error is > 0.1 magnitudes
using the '^' keystroke command, followed by the 'f'
keystroke command to actually replot and delete the data.
... after deciding that this new plot is satisfactory the user
issues the 'e' keystroke command to exit pexamine and save
the good data in m92.mag.ed
pt> pexamine m92.als.1 m92.als.ed use_display-
... a plot of magnitude error versus magnitude appears on the
screean and the graphics cursor comes up ready to accept
commands
... after looking at the plot the user decides that what they
really want to see is a plot of the goodness of fit parameter
chi versus magnitude
... the user issues the colon command :ycol chi followed by 'p'
keystroke command to replot the data
... the user sees a generally smooth trend of increasing
chi with increasing magnitude
... after examining the plot further the user decides to delete
all objects for which the chi value > 2.0 and the
magnitude is > 25 using the '^' key and ')' keystroke
commands followed by 'f' to save the deletions and replot
the data
... after deciding that this new plot is satisfactory the user
issues the 'e' keystroke command to exit pexamine and save
the good data in m92.als.ed
2. Examine and edit a DAOPHOT allstar catalog using the subracted image, the original image and the image display.
pt> display image.sub 1 ... display the subtracted image pt> pexamine orionk.als.1 orionk.als.ed image xcol=mag ycol=chi ... a plot of the goodness of fit versus magnitude appears on the terminal and the graphics cursor comes up ready to accept commands ... the user notices some very anomalous chi values and decides to see if these correspond to objects which have poor subtraction on the displayed image ... the user switches to image command mode by tapping the 'i' key, moves to the first poorly subtracted object and taps the 'o' key ... a list of the values of the loaded columns including chi appears in the text window , the program switchs to graphics mode and places the graphics cursor on the corresponding point in the X-Y plot ... the point in question indeed has a very high chi value and the user decides to try and investigate the reason for the anomalous value ... the user taps the 'r' key to get a radial profile of the object in the original image ... after carefully examining the profile it appears that the object's profile is too broad and that it is not a star ... the user switches back to the X-Y plot with the 'x' key, marks the point with the 'd' key and saves the deletions and replots with the 'f' key. ... the user goes back to image command mode with the 'i' key and begins investigating the next object ... finally after examining the image and making all the changes the user decides to quit and save the changes with the 'e' key
If the display device is on a remote resource the first image cursor request will cause PEXAMINE to hang. The remote resource is expecting the appropriate password which the user must type in to cause the the image cursor to appear. The normal password prompt is not being issued or flushed to the terminal. The solution to the problem is to put the password in the .irafhosts file
INDEF valued points cannot be accessed by PEXAMINE. INDEF valued points should be removed from the input catalog with SELECT prior to entering PEXAMINE.
ptools.select, ptools.txselect,ptools.tselect