Description¶
- Class
jwst.coron.KlipStep
- Alias
klip
The klip
step is one of the coronagraphic-specific steps in the coron
sub-package and is used in Stage 3 calwebb_coron3 processing.
It applies the Karhunen-Loeve Image Plane (KLIP) algorithm to coronagraphic
images, using an accompanying set of reference PSF images, in order to fit and subtract an
optimal PSF from a source image. The KLIP algorithm uses a KL decomposition of the set of
reference PSF’s, and generates a model PSF from the projection of the target on the KL vectors.
The model PSF is then subtracted from the target image (Soummer, Pueyo, and Larkin 2012).
KLIP is a Principle Component Analysis (PCA) method and is very similar to the Locally
Optimized Combination of Images (LOCI) method. The main advantages of KLIP over LOCI are
the possibility of direct forward modeling and a significant speed increase.
The KLIP algorithm consists of the following high-level steps:
Partition the target and reference PSF images in a set of search areas, and subtract their average values so that they have zero mean
Compute the KL transform of the set of reference PSF’s
Choose the number of modes to keep in the estimated target PSF
Compute the best estimate of the target PSF from the projection of the target image on the KL eigenvectors
Calculate the PSF-subtracted target image
Arguments¶
The klip
step has one optional argument:
--truncate
This is an integer parameter with a default value of 50 and is used to specify the number of KL transform rows to keep when computing the PSF fit to the target.
Inputs¶
The klip
step takes two inputs: a science target exposure in the form of a 3D data
cube and a 4D aligned PSF image (“_psfalign”) product.
3D calibrated images¶
- Data model
- File suffix
_calints
A 3D calibrated science target product containing a stack of per-integration images. This should be a “_calints” product created by the calwebb_image2 pipeline. Normally one of the science target exposures specified in the ASN file used as input to the calwebb_coron3 pipeline.
4D aligned PSF images¶
- Data model
- File suffix
_psfalign
A 4D collection of PSF images that have been aligned to each of the per-integration images contained in the science target “_calints” product, created by the align_refs step.
Outputs¶
3D PSF-subtracted images¶
- Data model
- File suffix
_psfsub
The output is a 3D stack of PSF-subtracted images of the science target, having the same dimensions as the input science target (“_calints”) product. The PSF fitting and subtraction has been applied to each integration image independently. The file name syntax is exposure-based, using the root of the input “_calints” product, with the addition of the association candidate ID and the “_psfsub” product type suffix, e.g. “jw8607342001_02102_00001_nrcb3_a3001_psfsub.fits.”
Reference Files¶
The klip
step does not use any reference files.