Last modified: December 2013

Jump to: Description · Examples · See Also

AHELP for CIAO 4.11 Sherpa v1


Context: psfs


Send a PSF kernel image to the imager (ds9).


image_kernel( [id, newframe, tile] )


The image_kernel command sends the kernel data to the imager (ds9) for display. This image may be congruent to the PSF data (see "ahelp image_psf"), but is more commonly a filtered and recentered subset. If a 1D PSF was loaded, use the plot_kernel command ("ahelp plot_kernel") instead. To view the full, unfiltered PSF, use the image_psf command.

What is the difference between the PSF and the kernel?

The point spread function (PSF) is defined by the full (unfiltered) PSF image loaded into Sherpa or the PSF model expression evaluated over the full range of the dataset; both types of PSFs are established with the load_psf() command. The kernel is the subsection of the PSF image or model which is used to convolve the data. This subsection is created from the PSF when the size and center of the kernel are defined by the command set_psf(). While the kernel and PSF might be congruent, defining a smaller kernel helps speed the convolution process by restricting the number of points within the PSF that Sherpa must evaluate.


Example 1

sherpa> image_kernel()

Image the kernel of the default dataset. If an imager frame already exists, the kernel image will replace the current contents of the frame.

Example 2

sherpa> image_kernel(2, newframe=True, tile=True)

An image of the kernel for dataset id=2 is sent to ds9. A new frame is created for the image; the frame is tiled with any other existing ds9 frames.

See Also

load_image, pack_image, unpack_image
image_model, image_model_component, image_source, image_source_component
contour_kernel, contour_psf, delete_psf, get_kernel, get_psf, image_psf, load_conv, load_psf, plot_kernel, plot_psf, set_psf, show_kernel, show_psf
contour, contour_data, contour_model, contour_ratio, contour_resid, image_close, image_data, image_deleteframes, image_fit, image_getregion, image_open, image_ratio, image_resid, image_setregion, image_xpaget, image_xpaset