# HOW-TO Inspect¶

This HOW-TO deals primarily with image inspection methods. Other inspection routines are described in their relevent sections (see, e.g.,) These and other inspection routines may eventually be linked from this HOW-TO formally, but they will never be described in any detail here.

## Image Inspect Plot¶

Image inspection takes place primarily a MatPlotLib (PyLab) window and is illustrated in the figure below. The plot contains a representation of the image with a title containing the filename of the frame being inspected. There are also pixel coordinate indicators for convenience. As this plot is within a Pylab window, all the familiar manupulation routines are available (e.g., panning, zooming, etc.) In addition to these, there are some single-key commands to create new plots that illustrate specific details around the cursor position. The next section gives details on these.

## Image Inspect Method¶

Image inspection can be called from any BaseFrame-derived frame, and is called by executing the frame’s inspect() method:

awe> frame = BaseFrame(pathname='filename.fits')
awe> frame.inspect()


There are also a large number of options to control how the plot looks and even what is plotted. A summary of the options is given below:

• optional list or array representing the image to be inspected (can be MxN for greyscale, or MxNx3 for RGB)
• tuple of (x0, y0, x1, y1) representing the image coordinates of the two oposing corners of the sub image to consider
• the factor by which the dynamic range is increased in units of sigma (0 gives full range)
• number of iterations in the kappa-sigma range clipping
• PyLab color map instance
• lower display range in native units (e.g. ADU)
• upper display range in native units (e.g. ADU)
• type of interpolation the PyLab viewer uses (nearest, bilinear, etc.)
• width of the PyLab figure window (in inches)
• ratio by which to scale the figure height (default: x_dim/y_dim)
• external viewer to use in case the image is too large
• always use the viewer
• width and height in pixels of region of interest
• number of contour levels for the contour plot of the region of interest
• number of bins in the histogram plot
• extension of the filetype to save plot to (png, ps, or eps) None disables saving
• compare this frame to its previous version using difference imaging (current-previous), pixels is ignored
• depth of query for previous version (0 goes as deep as possible) when compare is True
• a second of the same type of Frame object to replace previous when compare is True (if color is True, other can be a list of two images)
• kappa-sigma clip each image prior to subtraction when compare is True
• use color combining (RGB) instead of differencing when compare is True (kappa, vmin/vmax only honored when clip is True), this image is R, other is B if single, other is [G, B] if it is a list (EXPERIMENTAL)

Also, there are a number of commands that work on an area around the current cursor position. A summary of these commands are given below:

• closes the most recent plot window when pressed in the main window
• displays the X and Y coordinate (FITS standard unit indexed) and the count level
• performs aperture photometry on brightest feature in the region of interest (NOT YET IMPLEMENTED)
• displays a contour plot of the region of interest (see contour_levels)
• displays a histogram of the pixel values of the region of interest (see num_bins)
• displays a radial plot of the brightest feature in the region of interest
• displays a wireframe plot of the region of interest
• displays profile plots in both X and Y dimensions versus intensity (count level)

Please see the inspect docstring for more details and current details on both of these:

awe> help(frame.inspect)


## Image Display Method¶

A display method is available for all frames:

awe> frame.display()


This will open up the frame in skycat, by default.