punchbowl.level1.vignette#
Functions#
|
Prefect task to correct the vignetting of an image. |
Module Contents#
- punchbowl.level1.vignette.correct_vignetting_task(data_object: ndcube.NDCube, vignetting_path: str | pathlib.Path) ndcube.NDCube#
Prefect task to correct the vignetting of an image.
Vignetting is a reduction of an image’s brightness or saturation toward the periphery compared to the image center, created by the optical path. The Vignetting Module will transform the data through a flat-field correction map, to cancel out the effects of optical vignetting created by distortions in the optical path. This module also corrects detector gain variation and offset.
Correction maps will be 2048*2048 arrays, to match the input data, and built using the starfield brightness pattern. Mathematical Operation:
I’_{i,j} = I_i,j * FF_{i,j}
Where I_{i,j} is the number of counts in pixel i, j. I’_{i,j} refers to the modified value. FF_{i,j} is the small-scale flat field factor for pixel i, j. The correction mapping will take into account the orientation of the spacecraft and its position in the orbit.
Uncertainty across the image plane is calculated using the modelled flat-field correction with stim lamp calibration data. Deviations from the known flat-field are used to calculate the uncertainty in a given pixel. The uncertainty is convolved with the input uncertainty layer to produce the output uncertainty layer.
- Parameters:
data_object (PUNCHData) – data on which to operate
vignetting_path (pathlib) – path to vignetting function to apply to input data
- Returns:
modified version of the input with the vignetting corrected
- Return type:
PUNCHData