Chandra X-Ray Observatory
Skip to the navigation links
Last modified: December 2010

Jump to: Description · Examples · See Also

AHELP for CIAO 4.3 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.

  • id - the id of the data set to use; if not given, uses the default dataset id (id=1 by default, see "ahelp get_default_id")
  • newframe - add a new frame; default=False
  • tile - tile image frame; default=False

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

Last modified: December 2010
Smithsonian Institute Smithsonian Institute

The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA.   Email: Smithsonian Institution, Copyright © 1998-2019. All rights reserved.