Skip to the navigation links
Last modified: 1 November 2022

URL: https://cxc.cfa.harvard.edu/ciao/PSFs/psftools.html

PSF Central

Using the Chandra PSF



Listed below are most of the available tools in CIAO which make use of the PSF information. Also linked are documents which explain their use.

Tool/Script Description Related Threads

arestore

Applies the Lucy-Richardson deconvolution algorithm to 2D images.

Deconvolving an Image

[Thumbnail image: A source image, PSF image, and the deconvolved source.]

[Version: full-size]

[Print media version: A source image, PSF image, and the deconvolved source.]

Deconvolving an Image

An observed source (left), corresponding PSF (center), and the deconvolved image of the source (right).

aprates

Computes values and bounds for source intensity quantities. Requires a PSF fraction, derivable from a PSF image, as an input argument.

ecf_calc

Provides the integrated radial profile (encircled counts fraction) of a 2D image or events file.

ECF Profile

[Thumbnail image: Profile generated from the r_mid and fraction columns of the ecf_calc output file.]

[Version: full-size]

[Print media version: Profile generated from the r_mid and fraction columns of the ecf_calc output file.]

ECF Profile

The ECF profile generated from the fraction and r_mid columns of the output from ecf_calc.

celldetect

Legacy source detection algorithm that makes use of obsolete and inaccurate, built-in, calibration tables of PSF sizes at specific energy and encircled counts fraction arguments. At any given position, the size of the detect cell is determined using this PSF information, where the cell size increases the further off-axis from the field of view center.

This is a fast and robust method that works well for point sources without need for detailed PSF shape and only an approximate size; however, it has difficulties when handling extended sources and crowded fields; and is not particularly sensitive to faint sources.

wavdetect

Source detection algorithm that correlates Mexican-Hat wavelets with an image and may use the PSF-size maps created by mkpsfmap as a tool input to help constrain detected source properties.

This algorithm Works well for point sources embedded in extended emission and crowded fields, needing only an approximate PSF shape; however, it is memory intensive and slow, especially on large images and when many wavelet scales are used.

psfsize_srcs/src_psffrac

Determine a region's radius for a given PSF-size and obtain the PSF fraction for a given region.

srcextent

Measures the source and PSF sizes for a 2D image and events file.

srcflux

Calculates the net count rates and fluxes of sources in Chandra observations with PSF corrections.

srcflux psfmethod-parameter Approximations

[Thumbnail image: Figure illustrating the psfmethod approximation options.]

[Version: full-size]

[Print media version: Figure illustrating the psfmethod approximation options.]

srcflux psfmethod-parameter Approximations

This figure conceptually shows the different psfmethod approximations used by srcflux. The "ideal" method assumes 100% of the PSF is enclosed in the source region; the "quick" method only for circular regions uses tabulated calibrations to calculate the PSF fraction in the source region and assumes the background PSF fraction is zero. The "arfcorr" method runs the arfcorr tool at the characteristic mono-chromatic energy for the energy band to create a radially symmetric PSF model; and the "psffile" method uses a user-supplied image of the PSF.

tg_create_mask

Uses calibration tables of PSF FWHMs ($CALDB/data/chandra/default/wpsf/hrmaD1996-11-01wpsfN0001.fits) as a function of off-axis angles to create region mask files that encompass the grating zeroth-order and dispersed spectra.