Polarization Analysis

Classes
class	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationChannels
	Structure containing the 4 polarization channels obtained by the demosaicing process. More...
class	oevislib_net.ComputerVision.PolarizationAnalysis.StokesVector
	Structure containing the three components of the Stokes vector. More...

Functions
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeStokesVector (PolarizationChannels inPolarizationChannels, StokesVector outStokesVector)
	Computes all the components of the Stokes vector associated to the input polarization channels.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeStokesVector (PolarizationChannels inPolarizationChannels, Optional< Image > outS0, Optional< Image > outS1, Optional< Image > outS2)
	Computes the components of the Stokes vector associated to the input polarization channels.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeLinearPolarizationComponents (StokesVector inStokesVector, int inLumaNormalizationValue, Optional< Image > outDoLP, Optional< Image > outAoLP, Optional< Image > outLuminance)
	Computes the matrices used to describe the linear polarization of light.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeLinearPolarizationComponents (Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, PolarizationPattern inPolarizationPattern, Optional< Image > outDoLP, Optional< Image > outAoLP, Optional< Image > outLuminance)
	Computes the matrices describing the linear polarization of light associated to an image acquired using a monochrome sensor with polarization filter array.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeLinearPolarizationComponents (Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, BayerType inBayerType, PolarizationPattern inPolarizationPattern, Optional< Image > outDoLP, Optional< Image > outAoLP, Optional< Image > outLuminance)
	Computes the matrices describing the linear polarization of light associated to an image acquired using a color sensor with polarization filter array.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.VirtualPolarizer (StokesVector inStokesVector, float inPolarizerAngle, float inPolarizerEfficiency, float inPolarizerReflectivity, StokesVector outVirtualStokesVector, Optional< PolarizationChannels > outVirtualPolarizationComponents)
	Simulates the system's polarization state, given the acquired StokesVector and the virtual polarizer orientation.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.Demosaic (Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, PolarizationPattern inPolarizationPattern, PolarizationChannels outChannels)
	Applies the demosaicing algorithm to an image acquired using a monochrome sensor with polarization filter array.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.Demosaic (Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, BayerType inBayerType, PolarizationPattern inPolarizationPattern, PolarizationChannels outRedChannels, PolarizationChannels outGreenChannels, PolarizationChannels outBlueChannels)
	Applies the demosaicing algorithm to a raw image acquired using a color sensor with polarization filter array.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.ExtractChannel (Image inImage, PolarizationAngle inPolarizationAngle, DemosaicingAlgorithm inDemosaicingAlgorithm, PolarizationPattern inPolarizationPattern, Image outChannel)
	Extracts a single polarization channel from an image acquired using a monochrome sensor with polarization filter array.
static void	oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.ComputeBlockMatrix (Image inImage, Image outBlockMatrix)
	Shuffles each pixel of the image so that the output image is divided into 4 areas, where each area only contains pixels with the same polarization angle.

Detailed Description

Function Documentation

ComputeBlockMatrix()

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.ComputeBlockMatrix ( Image inImage, Image outBlockMatrix )

inlinestatic

Shuffles each pixel of the image so that the output image is divided into 4 areas, where each area only contains pixels with the same polarization angle.

The placement of the 4 polarizations on the output image match the pattern of the input polarization pattern. The result is correct only for images acquired with a monochrome sensor.

Parameters

inImage	Raw image, acquired using a monochrome sensor with polarization filter array.
outBlockMatrix	Block matrix computed from the raw image.

ComputeLinearPolarizationComponents() [1/3]

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeLinearPolarizationComponents ( Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, BayerType inBayerType, PolarizationPattern inPolarizationPattern, Optional< Image > outDoLP, Optional< Image > outAoLP, Optional< Image > outLuminance )

inlinestatic

Computes the matrices describing the linear polarization of light associated to an image acquired using a color sensor with polarization filter array.

The size of the output images depend on the demosaicing algorithm. See the details for the pa::demosaic function for more information. Type is always Float with 3 channels.

Parameters

inImage	Raw image, acquired using a color sensor with polarization filter array.
inDemosaicingAlgorithm	Demosaicing algorithm applied to the raw image.
inBayerType	Color pattern of the polarization filter array.
inPolarizationPattern	Polarization pattern of the polarization filter array.
outDoLP	Computed Degree of Linear Polarization matrix.
outAoLP	Computed Angle of Linear Polarization matrix. Values are angles expressed in degrees.
outLuminance	Computed Luminance matrix.

ComputeLinearPolarizationComponents() [2/3]

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeLinearPolarizationComponents ( Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, PolarizationPattern inPolarizationPattern, Optional< Image > outDoLP, Optional< Image > outAoLP, Optional< Image > outLuminance )

inlinestatic

Computes the matrices describing the linear polarization of light associated to an image acquired using a monochrome sensor with polarization filter array.

The size of the output images depend on the demosaicing algorithm. See the details for the pa::demosaic function for more information. Type is always Float with a single channel.

Parameters

inImage	Raw image, acquired using a monochrome sensor with polarization filter array.
inDemosaicingAlgorithm	Demosaicing algorithm applied to the raw image.
inPolarizationPattern	Polarization pattern of the polarization filter array.
outDoLP	Computed Degree of Linear Polarization matrix.
outAoLP	Computed Angle of Linear Polarization matrix. Values are angles expressed in degrees.
outLuminance	Computed Luminance matrix.

ComputeLinearPolarizationComponents() [3/3]

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeLinearPolarizationComponents ( StokesVector inStokesVector, int inLumaNormalizationValue, Optional< Image > outDoLP, Optional< Image > outAoLP, Optional< Image > outLuminance )

inlinestatic

Computes the matrices used to describe the linear polarization of light.

The size of the output matrices match the size of the Stokes vector components. Type is always Float with a single channel.

Parameters

inStokesVector	Stokes vector computed from the raw image.
inLumaNormalizationValue	Value used to normalize the Luminance matrix.
outDoLP	Computed Degree of Linear Polarization matrix.
outAoLP	Computed Angle of Linear Polarization matrix. Values are angles expressed in degrees.
outLuminance	Computed Luminance matrix.

ComputeStokesVector() [1/2]

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeStokesVector ( PolarizationChannels inPolarizationChannels, Optional< Image > outS0, Optional< Image > outS1, Optional< Image > outS2 )

inlinestatic

Computes the components of the Stokes vector associated to the input polarization channels.

The size of the Stokes components match the size of the input matrices, while the type is always Float.

Parameters

inPolarizationChannels	Polarization channels demosaicked from the raw image.
outS0	Components S0 of the Stokes vector.
outS1	Components S1 of the Stokes vector.
outS2	Components S2 of the Stokes vector.

ComputeStokesVector() [2/2]

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.ComputeStokesVector ( PolarizationChannels inPolarizationChannels, StokesVector outStokesVector )

inlinestatic

Computes all the components of the Stokes vector associated to the input polarization channels.

The size of the Stokes components match the size of the input matrices, while the type is always Float.

Parameters

inPolarizationChannels	Polarization channels demosaicked from the raw image.
outStokesVector	Computed Stokes vector.

Demosaic() [1/2]

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.Demosaic ( Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, BayerType inBayerType, PolarizationPattern inPolarizationPattern, PolarizationChannels outRedChannels, PolarizationChannels outGreenChannels, PolarizationChannels outBlueChannels )

inlinestatic

Applies the demosaicing algorithm to a raw image acquired using a color sensor with polarization filter array.

Size and type of the output channels depend on the demosaicing algorithm. See the details for the pa::demosaic function for more information.

Parameters

inImage	Raw image, acquired using a color sensor with polarization filter array.
inDemosaicingAlgorithm	Demosaicing algorithm applied to the raw image.
inBayerType	Color pattern of the polarization filter array.
inPolarizationPattern	Polarization pattern of the polarization filter array.
outRedChannels	Polarization channels associated to the red pixels of the raw image.
outGreenChannels	Polarization channels associated to the green pixels of the raw image.
outBlueChannels	Polarization channels associated to the blue pixels of the raw image.

Demosaic() [2/2]

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.Demosaic ( Image inImage, DemosaicingAlgorithm inDemosaicingAlgorithm, PolarizationPattern inPolarizationPattern, PolarizationChannels outChannels )

inlinestatic

Applies the demosaicing algorithm to an image acquired using a monochrome sensor with polarization filter array.

Size and type of the output components depend on the demosaicing algorithm. In particular, considering an input image with size (w, h) and type T, the following is valid:

Parameters

inImage	Raw image, acquired using a monochrome sensor with polarization filter array.
inDemosaicingAlgorithm	Demosaicing algorithm applied to the raw image.
inPolarizationPattern	Pattern of the polarization filter array.
outChannels	Polarization channels computed starting from the raw image.

ExtractChannel()

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationDemosaicing.ExtractChannel ( Image inImage, PolarizationAngle inPolarizationAngle, DemosaicingAlgorithm inDemosaicingAlgorithm, PolarizationPattern inPolarizationPattern, Image outChannel )

inlinestatic

Extracts a single polarization channel from an image acquired using a monochrome sensor with polarization filter array.

Size and type of the output image depend on the demosaicing algorithm. See the details for the pa::demosaic function for more information.

Parameters

inImage	Raw image, acquired using a monochrome sensor with polarization filter array.
inPolarizationAngle	Selects the polarization angle that will be extracted.
inDemosaicingAlgorithm	Demosaicing algorithm applied to the raw image.
inPolarizationPattern	Pattern of the polarization filter array.
outChannel	Single polarization component extracted from the raw image.

VirtualPolarizer()

void oevislib_net.ComputerVision.PolarizationAnalysis.PolarizationAnalysis.VirtualPolarizer ( StokesVector inStokesVector, float inPolarizerAngle, float inPolarizerEfficiency, float inPolarizerReflectivity, StokesVector outVirtualStokesVector, Optional< PolarizationChannels > outVirtualPolarizationComponents )

inlinestatic

Simulates the system's polarization state, given the acquired StokesVector and the virtual polarizer orientation.

Parameters

inStokesVector	Stokes Vector of the current system state. The image can be acquired in any state (e.g. with polarized light, with unpolarized light).
inPolarizerAngle	Angle of the simulated polarization filter, expressed relative to camera orientation. The value should be expressed in degrees.
inPolarizerEfficiency	Efficiency of the virtual polarizer. Set to 1 to simulate the perfect polarizer. Range [0, 1].
inPolarizerReflectivity	Reflectivity of the virtual polarizer. Set to 0 to simulate the perfect polarizer. Range [0, 1].
outVirtualStokesVector	StokesVector of the simulated system.
outVirtualPolarizationComponents	PolarizationComponents of the simulated system. If Null, the object is not computed.