Ocean
Ocean::Geometry::Normalization Class Reference

This class implements functions to normalize geometric data. More...

Static Public Member Functions

static SquareMatrix3 calculateNormalizedPoints (Vector2 *points, const size_t number, SquareMatrix3 *points_T_normalizedPoints=nullptr)
 Normalizes the given 2D image points so that the root of the mean square distance of the normalized 2D points to the origin is equal to sqrt(2). More...
 
template<typename T >
static SquareMatrixT3< T > normalizedTransformation (const SquareMatrixT3< T > &transformation)
 Normalizes a given 3x3 transformation matrix which is defined up to a scale factor forcing a 1 in the lower right matrix corner after normalization. More...
 
template<typename T >
static void normalizeTransformation (SquareMatrixT3< T > &transformation)
 Normalizes a given 3x3 transformation matrix which is defined up to a scale factor forcing a 1 in the lower right matrix corner after normalization. More...
 

Detailed Description

This class implements functions to normalize geometric data.

Member Function Documentation

◆ calculateNormalizedPoints()

static SquareMatrix3 Ocean::Geometry::Normalization::calculateNormalizedPoints ( Vector2 points,
const size_t  number,
SquareMatrix3 points_T_normalizedPoints = nullptr 
)
static

Normalizes the given 2D image points so that the root of the mean square distance of the normalized 2D points to the origin is equal to sqrt(2).

This function will return the identity transformation if no normalization can be determined.

Parameters
pointsThe 2D points to normalize, can be invalid if 'number == 0'
numberThe number of points to be normalized, with range [0, infinity)
points_T_normalizedPointsOptional resulting transformation allowing to transform the normalized image points back to not-normalized image points
Returns
The transformation matrix which was used to normalize the image points, will be normalizedPoints_T_points

◆ normalizedTransformation()

template<typename T >
SquareMatrixT3< T > Ocean::Geometry::Normalization::normalizedTransformation ( const SquareMatrixT3< T > &  transformation)
static

Normalizes a given 3x3 transformation matrix which is defined up to a scale factor forcing a 1 in the lower right matrix corner after normalization.

Parameters
transformationThe transformation to normalize, with lower right corner not zero
Returns
The resulting normalized transformation
Template Parameters
TThe data type of the scalar to be used, either 'float' or 'double'

◆ normalizeTransformation()

template<typename T >
void Ocean::Geometry::Normalization::normalizeTransformation ( SquareMatrixT3< T > &  transformation)
static

Normalizes a given 3x3 transformation matrix which is defined up to a scale factor forcing a 1 in the lower right matrix corner after normalization.

Parameters
transformationThe transformation to normalize, with lower right corner not zero
Template Parameters
TThe data type of the scalar to be used, either 'float' or 'double'

The documentation for this class was generated from the following file: