Send a PSF image to the imager (ds9).
image_psf( [id, newframe, tile] )
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
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.
|