FlatFieldCorrection Class

Flat field correction filter.

Inheritance Hierarchy

SystemObject
Accord.Imaging.FiltersBaseInPlaceFilter
Accord.Imaging.FiltersFlatFieldCorrection

Namespace: Accord.Imaging.Filters
Assembly: Accord.Imaging (in Accord.Imaging.dll) Version: 3.8.0

Syntax

Copy

public class FlatFieldCorrection : BaseInPlaceFilter

Public Class FlatFieldCorrection
	Inherits BaseInPlaceFilter

Request Example View Source

The FlatFieldCorrection type exposes the following members.

Constructors

	Name	Description
	FlatFieldCorrection	Initializes a new instance of the FlatFieldCorrection class.
	FlatFieldCorrection(Bitmap)	Initializes a new instance of the FlatFieldCorrection class.

Top

Properties

	Name	Description
	BackgoundImage	Background image used for flat field correction.
	FormatTranslations	Format translations dictionary. (Overrides BaseInPlaceFilterFormatTranslations.)
	UnmanagedBackgoundImage	Background image used for flat field correction.

Top

Methods

	Name	Description
	Apply(Bitmap)	Apply filter to an image. (Inherited from BaseInPlaceFilter.)
	Apply(BitmapData)	Apply filter to an image. (Inherited from BaseInPlaceFilter.)
	Apply(UnmanagedImage)	Apply filter to an image in unmanaged memory. (Inherited from BaseInPlaceFilter.)
	Apply(UnmanagedImage, UnmanagedImage)	Apply filter to an image in unmanaged memory. (Inherited from BaseInPlaceFilter.)
	ApplyInPlace(Bitmap)	Apply filter to an image. (Inherited from BaseInPlaceFilter.)
	ApplyInPlace(BitmapData)	Apply filter to an image. (Inherited from BaseInPlaceFilter.)
	ApplyInPlace(UnmanagedImage)	Apply filter to an unmanaged image. (Inherited from BaseInPlaceFilter.)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ProcessFilter	Process the filter on the specified image. (Overrides BaseInPlaceFilterProcessFilter(UnmanagedImage).)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Extension Methods

	Name	Description
	HasMethod	Checks whether an object implements a method with the given name. (Defined by ExtensionMethods.)
	IsEqual	Compares two objects for equality, performing an elementwise comparison if the elements are vectors or matrices. (Defined by Matrix.)
	To(Type)	Overloaded. Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime. (Defined by ExtensionMethods.)
	ToT	Overloaded. Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime. (Defined by ExtensionMethods.)

Top

Remarks

The goal of flat-field correction is to remove artifacts from 2-D images that are caused by variations in the pixel-to-pixel sensitivity of the detector and/or by distortions in the optical path. The filter requires two images for the input - source image, which represents acquisition of some objects (using microscope, for example), and background image, which is taken without any objects presented. The source image is corrected using the formula: src = bgMean * src / bg, where src - source image's pixel value, bg - background image's pixel value, bgMean - mean value of background image.

Note
If background image is not provided, then it will be automatically generated on each filter run from source image. The automatically generated background image is produced running Gaussian Blur on the original image with (sigma value is set to 5, kernel size is set to 21). Before blurring the original image is resized to 1/3 of its original size and then the result of blurring is resized back to the original size.

Note

If background image is not provided, then it will be automatically generated on each filter run from source image. The automatically generated background image is produced running Gaussian Blur on the original image with (sigma value is set to 5, kernel size is set to 21). Before blurring the original image is resized to 1/3 of its original size and then the result of blurring is resized back to the original size.

Note
The class processes only grayscale (8 bpp indexed) and color (24 bpp) images.

Sample usage:

Copy

// create filter
FlatFieldCorrection filter = new FlatFieldCorrection( bgImage );
// process image
filter.ApplyInPlace( sourceImage );

Source image:

Background image:

Result image:

Reference

Accord.Imaging.Filters Namespace