IRAF imexamine capabilitiesΒΆ
These are the capabilities of the IRAF version of the imexam task, called with imexamine [input [frame]], which lives in images.tv.imexamine. The following are imexamines input options:
- input is an optional list of images to be examined. If specified, images are examined in turn, displaying them automatically. If no images are specfied the images currently loaded into the image display are examined.
- output contains the rootname for output images created with the “t” key. If no name is specified then the name of the input image is used. A three digit numver is appended to the rootname, such as ”.001”, starting with 1 until no image is found with that name. Successive output images are numbered sequentially
- ncoutput and nloutput are the size of the output image created when the “t” key is pressed, where the output image is centered on the cursor location
- frame specifies which frame should be used
- logfile is the filename which records output of the commands producing text, if no filename is given no logfile will be produced
- defkey is the default key for cursor x-y input list. This key is applied to input cursor lists which do not have a cursor key specified. It is used to repetitively apply a cursor command to a list of positions typically obtained from another task
- allframes, if true then images from an input list are loaded by cycling through the available frames, otherwise the last frame loaded is reused
- nframes is then number of display frames to use when automatically loading images. It should not exceed the number of frames provided by the display device. If the number of frames is set to 0 then the task will query the display device to determine how many frames are currently allocated. New frames may be allocated during program execution by displaying images with the ‘d’ key.
- ncstat, nlstat correlate with the statistics command which computes values from a box centered on the specified cursor position with the number of columns and lines given by these parameters.
The following is a list of available cursor and colon commands while imexamine is active in the display, many but not all are available in this python imexam package:
-- IMEXAMINE COMMANDS --
CURSOR KEY COMMAND SUMMARY
? Help h Histogram p Previous frame x Coordinates
a Aperture Sum i Image cursor q Quit y Set origin
b Box coords j Line gauss fit r Radial plot z Print grid
c Column plot k Col gauss fit s Surface plot , Quick phot
d Load display l Line plot t Output image . Quick prof fit
e Contour plot m Statistics u Vector plot
f Redraw n Next frame v Vector plot
g Graphics cursor o Overplot w Toggle logfile
COLON COMMAND SUMMARY
allframes ceiling iterations naverage pointmode width
angh center label nbins radius x
angv constant logfile ncolumns round xformat
autoredraw dashpat logx ncontours rplot xlabel
autoscale defkey logy ncoutput select xorder
background eparam magzero ncstat szmarker y
banner fill majrx nhi ticklabel yformat
beta fitplot majry nlines title ylabel
boundary fittype marker nloutput top_closed yorder
box floor minrx nlstat unlearn z1,z2
buffer interval minry output wcs zero
OUTPUT OF 'a' AND 'r' KEYS
The 'a' key and logfile output has column labels and each object has one
line of measurements in the logfile and two lines on the terminal. The 'r'
key shows only the second line on the status line and the information from
the first line is in the graph title. The first line contains the x and y
center coordinates and optional world coordinates. The second line
contains the aperture magnitude and flux, the estimated background sky, the
profile fit peak, the ellipticity and position angle from the moment
analysis, and four estimates of the profile width. The four estimates are
from the moment analysis, the full-width enclosing half the flux, the
profile fit, and a direct estimate of the full width at half-maximum.
CURSOR KEY COMMANDS
? Print help
a Aperture radial photometry measurement (see above for output)
b Box coordinates for two cursor positions - c1 c2 l1 l2
c Column plot
d Load the image display
e Contour plot
f Redraw the last graph
g Graphics cursor
h Histogram plot
i Image cursor
j Fit 1D gaussian to image lines
k Fit 1D gaussian to image columns
l Line plot
m Statistics
image[section] npixels mean median stddev min max
n Next frame or image
o Overplot
p Previous frame or image
q Quit
r Radial profile plot (see above for output)
s Surface plot
t Output image centered on cursor (parameters output, ncoutput, nloutput)
u Centered vector plot from two cursor positions
v Vector plot between two cursor positions
w Toggle write to logfile
x Print coordinates
col line pixval [xorign yorigin dx dy r theta]
y Set origin for relative positions
z Print grid of pixel values - 10 x 10 grid
, Quick profile photometry measurement (Gaussian or Moffat)
. Quick radial profile plot and fit (Gaussian or Moffat)
COLON COMMANDS
Explicit image coordinates may be entered using the colon command syntax:
:column line key
where column and line are the image coordinates and the key is one
of the cursor keys. A special syntax for line or column plots is also
available as :c# or :l# where # is a column or line and no space is
allowed.
Other colon commands set or show parameters governing the plots and other
features of the task. Each graph type has it's own set of parameters.
When a parameter applies to more than one graph the current graph is assumed.
If the current graph is not applicable then a warning is given. The
"eparam" and "unlearn" commands may be used to change many parameters and
without an argument the current graph parameters are modified while with
the graph key as an argument the appropriate parameter set is modified.
In the list below the graph key(s) to which a parameter applies are shown.
allframes Cycle through all display frames to display images
angh s Horizontal angle for surface plot
angv s Vertical angle for surface plot
autoredraw cehlrsuv. Automatically redraw graph after colon command?
autoscale h Adjust number of histogram bins to avoid aliasing
axes s Draw axes in surface plot?
background jkr. Subtract background for radial plot and photometry?
banner cehjklrsuv. Include standard banner on plots?
beta ar Moffat beta parameter (INDEF to fit or value to fix)
boundary uv Boundary extension type for vector plots
box cehjklruv. Draw box around graph?
buffer r. Buffer distance for background subtraction
ceiling es Data ceiling for contour and surface plots
center jkr. Find center for radial plot and photometry?
constant uv Constant value for boundry extension in vector plots
dashpat e Dash pattern for contour plot
eparam cehjklrsuv. Edit parameters
fill e Fill viewport vs enforce unity aspect ratio?
fitplot r Overplot profile fit on data?
fittype ar Profile fitting type (gaussian|moffat)
floor es Data floor for contour and surface plots
interval e Contour interval (0 for default)
iterations ar Iterations on fitting radius
label e Draw axis labels for contour plot?
logfile Log file name
logx chjklruv. Plot x axis logrithmically?
logy chjklruv. Plot y axis logrithmically?
magzero r. Magnitude zero for photometry
majrx cehjklruv. Number of major tick marks on x axis
majry cehjklruv. Number of major tick marks on y axis
marker chjklruv. Marker type for graph
minrx cehjklruv. Number of minor tick marks on x axis
minry cehjklruv. Number of minor tick marks on y axis
naverage cjkluv Number of columns, lines, vectors to average
nbins h Number of histogram bins
ncolumns ehs Number of columns in contour, histogram, or surface plot
ncontours e Number of contours (0 for default)
ncoutput Number of columns in output image
ncstat Number of columns in statistics box
nhi e hi/low marking option for contours
nlines ehs Number of lines in contour, histogram, or surface plot
nloutput Number of lines in output image
nlstat Number of lines in statistics box
output Output image root name
pointmode chjkluv Plot points instead of lines?
radius r. Radius of object aperture for radial plot and photmetry
round cehjklruv. Round axes to nice values?
rplot jkr. Radius to plot in 1D and radial profile plots
select Select image or display frame
sigma jk Initial sigma for 1D gaussian fits
szmarker chjklruv. Size of marks for point mode
ticklabels cehjklruv. Label ticks?
title cehjklrsuv. Optional title for graph
top_closed h Close last bin of histogram
unlearn cehjklrsuv. Unlearn parameters to default values
wcs World coordinate system for axis labels and readback
width jkr. Width of background region
x [min max] chjklruv. Range of x to be plotted (no values for autoscaling)
xformat Coordinate format for column world coordinates
xlabel cehjklrsuv. Optional label for x axis
xorder jkr. X order of surface for background subtraction
y [min max] chjklruv. Range of y to be plotted (no values for autoscaling)
yformat Coordinate format for line world coordinates
ylabel cehjklrsuv. Optional label for y axis
yorder r. Y order of surface for background subtraction
z1 h Lower intensity value limit of histogram
z2 h Upper intensity value limit of histogram
zero e Zero level for contour plot