CVB++ 14.0
LineScanCalibrationConfiguration Class Referencefinal

A set of parameters, which is used to configure line-scan calibration. More...

#include <cvb/foundation/calibration_line_scan.hpp>

Public Member Functions

 LineScanCalibrationConfiguration (std::uint32_t maxIterations, std::uint32_t polyDegree, double tolerance, Foundation::CalibrationLineScan::ScanDirection scanDirection, Foundation::CalibrationLineScan::PreDefinedPixelSizeMode preDefinedPixelSizeMode, double pixelSize) noexcept
 Constructor for line-scan calibration configuration. More...
 
std::uint32_t MaxIterations () const noexcept
 Gets the number of maximal iterations for all nonlinear solvers in the calibration algorithm. More...
 
void SetMaxIterations (std::uint32_t maxIterations) noexcept
 Sets number of maximal iterations for all nonlinear solvers in the calibration algorithm. More...
 
std::uint32_t PolyDegree () const noexcept
 Gets a positive (or zero) integer value that defines the polynomial to be used. More...
 
void SetPolyDegree (std::uint32_t polyDegree) noexcept
 Sets a positive (or zero) integer value that defines the polynomial to be used. More...
 
double Tolerance () const noexcept
 Gets the value for early stopping criteria. More...
 
void SetTolerance (double tolerance) noexcept
 Sets the value for early stopping criteria. More...
 
Foundation::CalibrationLineScan::ScanDirection ScanDirection () const noexcept
 Gets the scanning direction of camera. More...
 
void SetScanDirection (Foundation::CalibrationLineScan::ScanDirection scanDirection) noexcept
 Sets the scanning direction of camera. More...
 
Foundation::CalibrationLineScan::PreDefinedPixelSizeMode PreDefinedPixelSizeMode () const noexcept
 Gets the decision if the calibrator uses predefined pixel size. More...
 
void SetPreDefinedPixelSizeMode (Foundation::CalibrationLineScan::PreDefinedPixelSizeMode preDefinedPixelSize) noexcept
 Sets the decision if predefined pixel size needs to be used. More...
 
double PixelSize () const noexcept
 Gets the pixel size of transformed image. More...
 
void SetPixelSize (double pixelSize) noexcept
 Sets the pixel size of transformed image. More...
 

Detailed Description

A set of parameters, which is used to configure line-scan calibration.

Constructor & Destructor Documentation

◆ LineScanCalibrationConfiguration()

LineScanCalibrationConfiguration ( std::uint32_t  maxIterations,
std::uint32_t  polyDegree,
double  tolerance,
Foundation::CalibrationLineScan::ScanDirection  scanDirection,
Foundation::CalibrationLineScan::PreDefinedPixelSizeMode  preDefinedPixelSizeMode,
double  pixelSize 
)
inlinenoexcept

Constructor for line-scan calibration configuration.

Parameters
[in]maxIterationsNumber of maximal iterations for all nonlinear solvers in the calibration algorithm.
[in]polyDegreeA positive (or zero) integer value that defines the polynomial to be used.
[in]toleranceValue for early stopping criteria.
[in]scanDirectionScanning direction of camera.
[in]preDefinedPixelSizeModeDecision if predefined pixel size needs to be used.
[in]pixelSizePixel size of transformed image.
Exceptions
Doesnot throw any exception.

Member Function Documentation

◆ MaxIterations()

std::uint32_t MaxIterations ( ) const
inlinenoexcept

Gets the number of maximal iterations for all nonlinear solvers in the calibration algorithm.

Returns
The number of maximal iterations for all nonlinear solvers in the calibration algorithm.
Exceptions
Doesnot throw any exception.

For line-scan calibration through polynomial this is used twice for finding the best polynomial to equalize the differences between edge points and to find the right feed-forward factor.

◆ PixelSize()

double PixelSize ( ) const
inlinenoexcept

Gets the pixel size of transformed image.

Returns
The pixel size of transformed image.
Exceptions
Doesnot throw any exception.

This parameter is used if and only if pre-defined pixel size is used. Then this value is the (fixed) metric resolution of the calibrated image.

◆ PolyDegree()

std::uint32_t PolyDegree ( ) const
inlinenoexcept

Gets a positive (or zero) integer value that defines the polynomial to be used.

Returns
A positive (or zero) integer value that defines the polynomial to be used.
Exceptions
Doesnot throw any exception.

By now only PolyDegree that is equal to 3 is supported.

◆ PreDefinedPixelSizeMode()

Gets the decision if the calibrator uses predefined pixel size.

Returns
The decision if it uses predefined pixel size.
Exceptions
Doesnot throw any exception.

True, if the predefined pixel resolution (set with a value PixelSize returns) is used for the metric calibration.

◆ ScanDirection()

Gets the scanning direction of camera.

Returns
The scanning direction of camera.
Exceptions
Doesnot throw any exception.

◆ SetMaxIterations()

void SetMaxIterations ( std::uint32_t  maxIterations)
inlinenoexcept

Sets number of maximal iterations for all nonlinear solvers in the calibration algorithm.

Parameters
[in]maxIterationsThe number of maximal iterations for all non linear solvers in the calibration algorithm.
Exceptions
Doesnot throw any exception.

◆ SetPixelSize()

void SetPixelSize ( double  pixelSize)
inlinenoexcept

Sets the pixel size of transformed image.

Parameters
[in]pixelSizeThe pixel size of transformed image.
Exceptions
Doesnot throw any exception.

◆ SetPolyDegree()

void SetPolyDegree ( std::uint32_t  polyDegree)
inlinenoexcept

Sets a positive (or zero) integer value that defines the polynomial to be used.

Parameters
[in]polyDegreeA positive (or zero) integer value that defines the polynomial to be used.
Exceptions
Doesnot throw any exception.

◆ SetPreDefinedPixelSizeMode()

void SetPreDefinedPixelSizeMode ( Foundation::CalibrationLineScan::PreDefinedPixelSizeMode  preDefinedPixelSize)
inlinenoexcept

Sets the decision if predefined pixel size needs to be used.

Parameters
[in]preDefinedPixelSizeThe decision if predefined pixel size needs to be used.
Exceptions
Doesnot throw any exception.

◆ SetScanDirection()

void SetScanDirection ( Foundation::CalibrationLineScan::ScanDirection  scanDirection)
inlinenoexcept

Sets the scanning direction of camera.

Parameters
[in]scanDirectionThe scanning direction of camera.
Exceptions
Doesnot throw any exception.

◆ SetTolerance()

void SetTolerance ( double  tolerance)
inlinenoexcept

Sets the value for early stopping criteria.

Parameters
[in]toleranceThe value for early stopping criteria.
Exceptions
Doesnot throw any exception.

◆ Tolerance()

double Tolerance ( ) const
inlinenoexcept

Gets the value for early stopping criteria.

Returns
The value for early stopping criteria.
Exceptions
Doesnot throw any exception.

Value that is used for stopping criteria in the nonlinear solvers.