About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2008

URL: http://cxc.harvard.edu/sherpa4.1/image_psf.py.html
AHELP for Sherpa 4.1

image_psf

Context: py.sherpa

Synopsis

Send a PSF image to the imager (ds9).

Syntax

image_psf( [id, newframe, tile] )

Description

A Sherpa PSF model can be defined with data read from a 2D image, or can be calculated from a model function. If either type of PSF model has been assigned to a 2D data set, then the image_psf() function evaluates the model (that has been set as the PSF kernel) over the source data array, and sends the PSF image to the imager (ds9) for display. The PSF image size will match the size of the data array set with the load_psf and set_psf commands. This function can also instruct the imager to display the PSF data in a new frame, or to tile all frames in the imager (by default, both the newframe and tile options are False).

  • 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

Example

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

The function sends image data from a PSF model to the imager, when that model has been defined by data read in from a PSF file. If no argument is given, the PSF model assigned to the default data set ID is assumed; the PSF data are sent to the current imager frame; and the imager frames are not tiled. If a different data set ID is given, then data from the PSF model for that data set are displayed. If the newframe option is set to True, the PSF data are displayed in a new imager frame. If the tile option is set to True, all imager frames are tiled for display.

Bugs

See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.

Last modified: December 2008



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