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:: CubeModel
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:: QuadModel
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:: CubeModel
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.