Loading [MathJax]/extensions/tex2jax.js

You are here: Start » FIL.NET » Invoke.AdjustPointGrids3D

Invoke.AdjustPointGrids3D

Aligns (rotation + translation) a point grid to match best the reference point grid.

Namespace:Fil
Assembly:FilNet.dll

Syntax

C++
C#
 
public static void AdjustPointGrids3D
(
	Fil.Point3DGrid inPoints,
	Fil.Point3DGrid inReferencePoints,
	int inMaxIterationCount,
	float inMatchFraction,
	float inDiscardFurthestFraction,
	Fil.Point3DGrid outAlignedPoints,
	Fil.Matrix outAlignment,
	Diagnostic<List<Fil.Point3D>> diagPointsWorkingSet,
	Diagnostic<List<Fil.Point3D>> diagReferencePointsWorkingSet,
	Diagnostic<List<List<Fil.Segment3D>>> diagAttractionSegments
)

Parameters

Name Type Range Default Description
inPointsFil.Point3DGridData points to be aligned, may contain background clutter.
inReferencePointsFil.Point3DGridReference points to align to, may only contain points belonging to the object of interest.
inMaxIterationCountint<1, INF>100Maximal number of iteration for the algorithm. Default value: 100.
inMatchFractionfloat<0.0f, 1.0f>0.1111111111111111fDefines fraction of input points that is being fitted in every iteration. Default value: 0.1111111111111111f.
inDiscardFurthestFractionfloat<0.0f, 1.0f>0.05fFraction of point pairs to be discarded during internal ICP loop. Furthest pairs are discarded, and only in last 10% of algorithm iterations. Useful for handling outliers in the inReferencePoints, as well as gaps/holes in the inPoints data. Default value: 0.05f.
outAlignedPointsFil.Point3DGridThe aligned input points.
outAlignmentFil.MatrixThe transform that aligns best the input points to the reference points.
diagPointsWorkingSetFil.Diagnostic<System.Collections.Generic.List<Fil.Point3D>>inPoints after decimation by inMatchFraction, i.e. points which will be fitted in every iteration.
diagReferencePointsWorkingSetFil.Diagnostic<System.Collections.Generic.List<Fil.Point3D>>inReferencePoints after decimation by inMatchFraction, i.e. points which will be fitted in every iteration.
diagAttractionSegmentsFil.Diagnostic<System.Collections.Generic.List<System.Collections.Generic.List<Fil.Segment3D>>>Attraction segments from every iteration. Note that the algorithm internally moves inReferencePoints towards inPoints (and returns inverse transformation), so the segments show movement of reference towards data.

See also