Flat-Field Correction#

The Flat-Field Correction (FFC) camera feature allows you to remove non-uniformities in the image caused by differing light sensitivities of the sensor pixels and by illumination and illumination optics.

该功能的使用#

Non-uniformities in images are a common occurrence in digital imaging. These are caused by variations in the brightness output of sensor pixels as well as by the influence of light source and illuminations optics. Flat-field correction minimizes these non-uniformities by correcting the original pixel values, thus improving image quality and subsequent analysis.

Before flat-field correction can be applied, the camera needs to be calibrated. This involves calculating appropriate correction data. With this, the original pixels can be corrected during image acquisition resulting in an improved image.

The implementation of the Flat-Field Correction feature varies depending on the camera:

• ace 2 相机
• boost V 相机

Types of Flat-Field Correction#

Depending on the camera model, Basler cameras support block-based and column-based flat-field correction.

Block-based flat-field correction corrects image artifacts caused by photo response non-uniformities (PRNU) and low frequency variations deriving from the illumination and illumination optics. Block-based FFC "divides" the sensor into square blocks consisting of a certain number of pixels. During calibration, correction data is calculated for each square block, which is then interpolated and applied to each pixel of the sensor.

Column-based flat-field correction corrects image artifacts caused by dark signal non-uniformities (DSNU) and photo response non-uniformities (PRNU). For each column of the sensor, a correction value for both DSNU and PRNU must be calculated during calibration. During image acquisition, these column-wise correction values are applied to the original pixel values.

The following drawing shows the different principles of block-based and column-based flat-field correction.

Creating Correction Values (CV)#

Block-based flat-field correction: A sequence of bright field (flat field) images is taken to detect photo response non-uniformities (PRNU) and low frequency artifacts caused by, e.g., lighting or optics. The correction values (CV) are calculated by the camera and saved to the camera's flash memory.

Column-based flat-field correction: A sequence of dark field images is taken (A) to detect dark signal non-uniformities (DSNU) (dark current noise) and a sequence of bright field (flat field) images is taken (B) to detect photo response non-uniformities (PRNU). The correction values (CV) must then be calculated by the user and saved to the camera's flash memory.

Applying Flat-Field Correction#

The image artifacts are removed, provided that the flat-field correction feature is enabled. The original pixel values (OV) are corrected resulting in an improved image (Resulting Values, RV).

ace 2 相机#

Depending on your ace 2 camera model, block-based flat-field correction is available.

Block-Based Flat-Field Correction#

Creating a Flat-Field Correction Set#

This step involves calibrating the camera and storing the calculated correction values in a file referred to as a flat-field correction set. To do this, use the Block-Based Flat-Field Correction feature of the pylon Viewer.

You can create up to 4 correction sets.

Enabling a Flat-Field Correction Set#

To enable a flat-field correction set:

1. 设置 BslFlatFieldCorrectionMode parameter to On.

2. 设置 BslFlatFieldCorrectionSetIndex parameter to the index number of the set to be used, e.g., index number 2.

   The selected flat-field correction set is enabled automatically.

boost V 相机#

Basler boost V cameras support block-based flat-field correction and column-based flat-field correction. These two correction principles can be combined or used individually.

Block-Based Flat-Field Correction#

Creating a Flat-Field Correction Set#

This step involves calibrating the camera and storing the calculated correction values in a file referred to as a flat-field correction set. You can create up to 16 correction sets.

You need the following item before you start creating a flat-field correction set:

• A target with a uniform background, e.g., a white sheet of paper

To create a flat-field correction set:

1. 设置 Width and Height parameters of the 图像 ROI to their maximum values.
2. Disable the Decimation and Dual ROI features, if available.
3. Disable Binning.
4. Set Reverse X and Reverse Y as you would for later operation.
5. Illuminate the sensor homogeneously to 70 % saturation, e.g., by placing a white sheet of paper in the camera's entire field of view.
6. 设置 BslFlatFieldCorrectionSelector parameter to BlockBased.
7. 设置 BslFlatFieldCorrectionMode parameter to On.
8. 设置 BslFlatFieldCorrectionSetIndex parameter to the desired index number of the set to be created, e.g., 2.
9. Click the Continuous Shot button in the toolbar of the pylon Viewer to start image acquisition.
10. Execute the BslFlatFieldCorrectionSetCreate command to create a new flat-field correction set.
    A sequence of bright images is acquired and evaluated. The resulting correction data are generated and collected in the flat-field correction set selected.

11. Save the settings to the camera's flash memory by executing the BslFlatFieldCorrectionSetSave command.
    If the flat-field correction set with, e.g., index number 2, already contains correction data, these are overwritten and replaced by the new correction values.

    The created flat-field correction set is enabled automatically.

Enabling a Flat-Field Correction Set#

To enable a flat-field correction set:

1. 设置 BslFlatFieldCorrectionMode parameter to On.
2. 设置 BslFlatFieldCorrectionSetIndex parameter to the index number of the set to be used, e.g., index number 2.
3. Execute the BslFlatFieldCorrectionSetLoad command.

Column-Based Flat-Field Correction#

Calculating the Correction Values Using the pylon Viewer#

→ See the Column-Based Flat-Field Correction feature of the pylon Viewer.

Calculating the Correction Values Using the pylon API#

The following mathematical parameters are involved:

• DMean: mean gray value of all pixels in the dark field image
• GMean: mean gray value of all pixels in the bright field image
• DSNU_Coeff(x): dark signal non-uniformity (DSNU) coefficient
• PRNU_Coeff(x): photo response non-uniformity (PRNU) coefficient
• UserGD_Offset: user-defined global dark offset

where x is the column index.

To calculate the correction values:

1. Protect the sensor from light, e.g., by placing a plastic cap on the lens, and acquire a sequence of dark images.
2. Sum up the gray values of all pixels in all acquired images and divide the sum by the total number of pixels. The result is the mean gray value of all pixels in the dark field image (DMean).
3. Calculate the mean gray value for each column x (D(x)).
4. Illuminate the sensor homogeneously to 70 % saturation, e.g., by placing a white sheet of paper in the camera's entire field of view, and acquire a sequence of bright images.
5. Sum up the gray values of all pixels in all acquired images and divide the sum by the total number of pixels. The result is the mean gray value of all pixels in the bright field image (GMean).
6. Calculate the mean gray value for each column x (G(x)).
7. If necessary, determine a global dark offset value according to your needs (UserGD_Offset).

8. For each column x, calculate the coefficients DSNU_Coeff(x) and PRNU_Coeff(x) as follows:

   

9. Use the calculated values for setting the corresponding camera parameters via the pylon API.

   • Column index (x): BslFlatFieldCorrectionCoeffX
   • DMean: BslFlatFieldCorrectionDMean
   • DSNU_Coeff(x): BslFlatFieldCorrectionCoeffDSNU
   • PRNU_Coeff(x): BslFlatFieldCorrectionCoeffPRNU
   • UserGD_Offset: BslFlatFieldCorrectionUserGD

10. After having set all correction values for all columns, you can test flat-field correction by acquiring a series of images.

11. If you're satisfied with the image quality, save the settings to the camera's flash memory by executing the BslFlatFieldCorrectionSaveToFlash command.

Choosing the Flat-Field Correction Type#

即： BslFlatFieldCorrectionSelector allows you choose the flat-field correction type to be used. You can set the parameter to the following values:

• BlockBased: Block-based flat-field correction is performed.
• ColumnBased: Column-based flat-field correction is performed.

Enabling or Disabling Flat-Field Correction#

To enable or disable flat-field correction, set the BslFlatFieldCorrectionMode 参数设置为以下值：

• On: The camera performs flat-field correction depending on the flat-field correction type chosen.

• DSNUOnly: The camera performs DSNU correction only.

  信息

  This parameter value is only available when choosing column-based flat-field correction.

• Off (default): The camera does not perform the flat-field correction type chosen.

外部链接#

• Flat-field correction (Wikipedia)

详情#

显示所有相机型号

示例代码#

Block-Based Flat-Field Correction#

// NOTE: Valid for selected ace 2 cameras. Check the "Specifics" section
// Set the flat-field correction mode to On
camera.BslFlatFieldCorrectionMode.SetValue(BslFlatFieldCorrectionMode_On);
// Set the desired index number of the set to be enabled
camera.BslFlatFieldCorrectionSetIndex.SetValue(BslFlatFieldCorrectionSetIndex_1);

// NOTE: Valid for boost V cameras
// Set the type of flat-field correction to Block-Based
camera.BslFlatFieldCorrectionSelector.SetValue(BslFlatFieldCorrectionSelector_BlockBased);
// Set the flat-field correction mode to On
camera.BslFlatFieldCorrectionMode.SetValue(BslFlatFieldCorrectionMode_On);
// Set the desired index number of the set to be created
camera.BslFlatFieldCorrectionSetIndex.SetValue(BslFlatFieldCorrectionSetIndex_1);
// Create new flat-field correction data for the flat-field correction set selected
camera.BslFlatFieldCorrectionSetCreate.Execute();
// Save the correction data to the camera's flash memory
camera.BslFlatFieldCorrectionSetSave.Execute();

INodeMap& nodemap = camera.GetNodeMap();
// NOTE: Valid for selected ace 2 cameras. Check the "Specifics" section
// Set the flat-field correction mode to On
CEnumParameter(nodemap, "BslFlatFieldCorrectionMode").SetValue("On");
// Set the desired index number of the set to be enabled
CEnumParameter(nodemap, "BslFlatFieldCorrectionSetIndex").SetValue("");

// NOTE: Valid for boost V cameras
// Set the type of flat-field correction to Block-Based
CEnumParameter(nodemap, "BslFlatFieldCorrectionSelector").SetValue("BlockBased");
// Set the flat-field correction mode to On
CEnumParameter(nodemap, "BslFlatFieldCorrectionMode").SetValue("On");
// Set the desired index number of the set to be created
CEnumParameter(nodemap, "BslFlatFieldCorrectionSetIndex").SetValue("");
// Create new flat-field correction data for the flat-field correction set selected
CCommandParameter(nodemap, "BslFlatFieldCorrectionSetCreate").Execute();
// Save the correction data to the camera's flash memory
CCommandParameter(nodemap, "BslFlatFieldCorrectionSetSave").Execute();

// NOTE: Valid for selected ace 2 cameras. Check the "Specifics" section
// Set the flat-field correction mode to On
camera.Parameters[PLCamera.BslFlatFieldCorrectionMode].SetValue(PLCamera.BslFlatFieldCorrectionMode.On);
// Set the desired index number of the set to be enabled
camera.Parameters[PLCamera.BslFlatFieldCorrectionSetIndex].SetValue(PLCamera.BslFlatFieldCorrectionSetIndex.);

// NOTE: Valid for boost V cameras
// Set the type of flat-field correction to Block-Based
camera.Parameters[PLCamera.BslFlatFieldCorrectionSelector].SetValue(PLCamera.BslFlatFieldCorrectionSelector.BlockBased);
// Set the flat-field correction mode to On
camera.Parameters[PLCamera.BslFlatFieldCorrectionMode].SetValue(PLCamera.BslFlatFieldCorrectionMode.On);
// Set the desired index number of the set to be created
camera.Parameters[PLCamera.BslFlatFieldCorrectionSetIndex].SetValue(PLCamera.BslFlatFieldCorrectionSetIndex.);
// Create new flat-field correction data for the flat-field correction set selected
camera.Parameters[PLCamera.BslFlatFieldCorrectionSetCreate].Execute();
// Save the correction data to the camera's flash memory
camera.Parameters[PLCamera.BslFlatFieldCorrectionSetSave].Execute();

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* NOTE: Valid for selected ace 2 cameras. Check the "Specifics" section */
/* Set the flat-field correction mode to On */
errRes = PylonDeviceFeatureFromString(hdev, "BslFlatFieldCorrectionMode", "On");
CHECK(errRes);
/* Set the desired index number of the set to be enabled */
errRes = PylonDeviceFeatureFromString(hdev, "BslFlatFieldCorrectionSetIndex", "");
CHECK(errRes);

/* NOTE: Valid for boost V cameras */
/* Set the type of flat-field correction to Block-Based */
errRes = PylonDeviceFeatureFromString(hdev, "BslFlatFieldCorrectionSelector", "BlockBased");
CHECK(errRes);
/* Set the flat-field correction mode to On */
errRes = PylonDeviceFeatureFromString(hdev, "BslFlatFieldCorrectionMode", "On");
CHECK(errRes);
/* Set the desired index number of the set to be created */
errRes = PylonDeviceFeatureFromString(hdev, "BslFlatFieldCorrectionSetIndex", "");
CHECK(errRes);
/* Create new flat-field correction data for the flat-field correction set selected */
errRes = PylonDeviceExecuteCommandFeature(hdev, "BslFlatFieldCorrectionSetCreate");
CHECK(errRes);
/* Save the correction data to the camera's flash memory */
errRes = PylonDeviceExecuteCommandFeature(hdev, "BslFlatFieldCorrectionSetSave");
CHECK(errRes);

# NOTE: Valid for selected ace 2 cameras. Check the "Specifics" section
# Set the flat-field correction mode to On
camera.BslFlatFieldCorrectionMode.Value = "On"
# Set the desired index number of the set to be enabled
camera.BslFlatFieldCorrectionSetIndex.Value = ""

# NOTE: Valid for boost V cameras
# Set the type of flat-field correction to Block-Based
camera.BslFlatFieldCorrectionSelector.Value = "BlockBased"
# Set the flat-field correction mode to On
camera.BslFlatFieldCorrectionMode.Value = "On"
# Set the desired index number of the set to be created
camera.BslFlatFieldCorrectionSetIndex.Value = ""
# Create new flat-field correction data for the flat-field correction set selected
camera.BslFlatFieldCorrectionSetCreate.Execute()
# Save the correction data to the camera's flash memory
camera.BslFlatFieldCorrectionSetSave.Execute()

Column-Based Flat-Field Correction#

// Example: Set all correction values for all columns
// Dark signal non-uniformity (DSNU) coefficient
// CalculatedDSNU[0..width-1]
// Photo response non-uniformity (PRNU) coefficient
// CalculatedPRNU[0..width-1]
for (x=0; ++x; x<width)
{
    camera.BslFlatFieldCorrectionCoeffX.SetValue(x);
    camera.BslFlatFieldCorrectionCoeffDSNU.SetValue(CalculatedDSNU[x]);
    camera.BslFlatFieldCorrectionCoeffPRNU.SetValue(CalculatedPRNU[x]);
}

// Set the global dark offset value
camera.BslFlatFieldCorrectionUserGD.SetValue(40);

// Save the settings to the camera's flash memory
camera.BslFlatFieldCorrectionSaveToFlash.Execute();

// Set the type of flat-field correction to Column-Based
camera.BslFlatFieldCorrectionSelector.SetValue(BslFlatFieldCorrectionSelector_ColumnBased);

// Set the flat-field correction mode
camera.BslFlatFieldCorrectionMode.SetValue(BslFlatFieldCorrectionMode_On);

此示例代码仅适用于 C++ 语言。

您也可以使用 pylon Viewer 轻松设置参数。