location_object.Normalize Method

Corrects the PosWrtRef value of a Cartesian Location Object for any mathematical inconsistencies in the value.

location_object.Normalize

Prerequisites

The location_object must be a Cartesian Location Object.

Parameters

None

Remarks

After many sequential mathematics operations (e.g. Inverse, Mul) have been performed on a Cartesian Location Object, it is possible for the homogeneous transformation that is used to internally store the PosWrtRef value to suffer from mathematical inconsistencies. For example, certain rows and columns of the 4x4 matrix are vectors that must have unit values and be orthogonal to other vectors in the matrix. Given that all of the elements of a transformation are stored as double precision floating-point numbers, this problem is not very likely to occur. Nonetheless, as a convenience, the Normalize method can be executed on a Cartesian location_object and it will correct any mathematic errors that may have accumulated in the PosWrtRef value.

Examples

Dim loc1 As New Location     ' Create new Location set to default values
loc1.XYZ(10,20,30,0,180,25) ' Set PosWrtRef value of loc1
loc1.Normalize ' Won't alter loc1 since it is already correct

See Also

Location Class | location_object.Inverse |location_object.Mul