You are here: Technical Reference > Flat Field Correction Control - BFS-U3-120S4 Version 1801.0.116.0
Flat Field Correction Control
Flat Field Correction (FFC) is used to suppress an image sensor Fixed Pattern Noise (FPN) which is a common image artifact for many CMOS sensors. FFC includes correction for both Dark Signal Non-Uniformity (DSNU) and Pixel Response Non-Uniformity (PRNU). The suppression for DSNU is achieved by black level correction and the suppression for PRNU is achieved by gain correction. A reference equation is given below:
Pn = ΔGn ⨯ ( Un + ΔOn )
- n could be pixel, row or column index.
- P is the corrected pixel value.
- U is the uncorrected pixel value.
- ΔG is the delta gain (gain correction), which is row/column/pixel dependent.
- ΔO is the delta offset (black level correction), which is row/column/pixel dependent.
Note that our FFC is currently column dependent only since the column FPN is the dominant noise for all sensors we support.
Flat Field Correction Control
FFC can be enabled or disabled using Flat Field Correction Enable. It is enabled by default.
Use Flat Field Correction Mode to select a mode. There are three FFC modes: Factory, User, and Calibration.
This is the default mode. In this mode, the camera uses the factory delta gain/offset parameters calibrated by FLIR.
The FFC coefficients change with different camera gain levels.
In this mode, the camera uses fixed FFC coefficients across all camera gain levels. The default values for this mode apply no FFC and are the equivalent of disabling FFC. To modify the values, you must switch to Calibration mode.
In this mode, the Flat Field User Table Control access (R/W) is available. At the same time, FFC will be automatically disabled and become unavailable. Therefore, values entered for delta gain/offset do not take effect until the mode is switched to User and FFC is enabled again.
Flat Field User Table Control
When in Calibration mode, you can access these controls.
Table x Coordinate specifies the horizontal coordinate of the FFC gain/offset. The FFC implementation supports only the x coordinate, for suppressing the column FPN.
Flat Field Gain specifies the delta gain for each table x coordinate.
Flat Field Offset (16-bit) specifies the delta offset for each table x coordinate. The step size should be queried before writing the value as it is normally much greater than 1 (e.g., 32). Entering a value that is not divisible by the step size results in an error.
User Table Reset sets all FFC parameters back to the last saved values loaded from the camera. If nothing has been previously saved, this resets to the default values which is the equivalent of disabling FFC.
User Table Save saves the FFC parameters into non-volatile memory which is preserved even when the camera is power cycled. This overwrites the existing saved user table.
The IMX226 mono sensor has an imaging artifact where the four pixels in a 2x2 group have slightly different sensitivities relative to each other. This causes mild fixed pattern noise (FPN) is the image which repeats over 2x2 pixel groups.
The BSIFlatFieldCorrection controls are used to fix this FPN by applying seperate small gains to the four pixel positions to compensate for each pixel having different sensitivity. The correction gains can either by controlled by the user or determined automatically based on the image content.
For manual BSI flat field correction control, set BsiFlatFieldCorrectionAuto to Off, select one of the four pixel positions with BsiFlatFieldCorrectionGainSelector, and then write the desired correction gain for that position to BsiFlatFieldCorrectionGain. Repeat for the other 3 pixel positions to completely specify the correction gains.
For automatic correction set BsiFlatFieldCorrectionAuto to Once or Continuous. In Once mode, the correction gains are updated once based on the current image content and then BsiFlatFieldCorrectionAuto is set to Off. In Continuous mode, the gains are continouly updated based on the images captured as the camera is streaming. The feature BsiFlatFieldCorrectionAutoDamping controls how quickly the correction gains are changed in Continuous mode. Higher damping means the gains are changed more gradually over time in smaller steps. Automatic correction is based on measuring the amount of imbalance between the four pixel positions in the image. Therefore it requires a well-exposed image. If the image is too bright or too dark, the correction gains will be kept at their previous vales until the exposure is adjusted.
The extent of the fixed pattern noise varies based on the illumination wavelength and the lens aperture. If the lighting or lens aperature changes during camera operation Continuous automatic correction is reccomended.
|BSI Flat Field Correction Enable||IBoolean||Guru||Enables flat field correction for Back Size Illuminated sensors that have fixed pattern noise across 2x2 groups of pixels.|
|IEnumeration||Guru||Sets the auto BSI flat field correction mode. Set to Off to manually set the correction gains. Set to Continuous to automaticaly adjust the gains continually based on the current image content. Set to Once for a one-time admatic adjustment of the gains.|
|IFloat||Guru||Controls how quickly BsiFlatFieldCorrectionAuto adjusts the values of BsiFlatFieldCorrectionGain. Higher damping means the gains are changed more gradually.|
|IEnumeration||Guru||Selects which pixel position has its correction gain controlled by the BsiFlatFieldCorrectionGain feature.|
|||IFloat||Guru||Controls the flat field correction gain of the pixel location specified by BsiFlatFieldCorrectionGainSelector. This is a linear multiplier applied to the pixel value.|
|Flat Field Correction Enable||IBoolean||Beginner||Enable or disable flat field correction.|
|Flat Field Correction Mode||IEnumeration||Expert||Selects flat field correction mode. Note that flat field correction parameters are accessible only in Calibration mode. When switching modes from Calibration to User or Factory, it is recommended to stop image streaming to give the camera enough time to load the corresponding table.|
|Flat Field User Table Control||ICategory||Expert||Category that contains User flat field correction table control features.|
Flat Field Correction Control Features
BSI Flat Field Correction Enable
Enables flat field correction for Back Size Illuminated sensors that have fixed pattern noise across 2x2 groups of pixels.
Sets the auto BSI flat field correction mode. Set to Off to manually set the correction gains. Set to Continuous to automaticaly adjust the gains continually based on the current image content. Set to Once for a one-time admatic adjustment of the gains.
Controls how quickly BsiFlatFieldCorrectionAuto adjusts the values of BsiFlatFieldCorrectionGain. Higher damping means the gains are changed more gradually.
Selects which pixel position has its correction gain controlled by the BsiFlatFieldCorrectionGain feature.
Controls the flat field correction gain of the pixel location specified by BsiFlatFieldCorrectionGainSelector. This is a linear multiplier applied to the pixel value.
Flat Field Correction Enable
Enable or disable flat field correction.
Flat Field Correction Mode
Selects flat field correction mode. Note that flat field correction parameters are accessible only in Calibration mode. When switching modes from Calibration to User or Factory, it is recommended to stop image streaming to give the camera enough time to load the corresponding table.
Flat Field User Table Control
Category that contains User flat field correction table control features.
© 2015-2017 FLIR® Integrated Imaging Solutions Inc.
All rights reserved.
Legal | Contact Support