Back to FabImage Library website

You are here: Start » Function Reference » Point3DGrid » Point3DGrid Fitting » RemoveOutliersFromPoint3DGrid

RemoveOutliersFromPoint3DGrid


Header: FIL.h
Namespace: fil
Module: Vision3DPro

Removes noise from a given Point3DGrid. All points that are too far from their neighbors are removed.

Syntax

C++
C#
 
void fil::RemoveOutliersFromPoint3DGrid
(
	const fil::Point3DGrid& inPointGrid,
	ftl::Optional<const fil::Region&> inRoi,
	const float inStdDevMultiple,
	const int inNeighborCount,
	fil::Point3DGrid& outGrid,
	float& diagThreshold,
	float& diagAverageDistance
)

Parameters

Name Type Range Default Description
Input value
inPointGrid const Point3DGrid& Input Point3DGrid
Input value
inRoi Optional<const Region&> NIL Region of interest
Input value
inStdDevMultiple const float 0.0 - 1.5f Allows to set a threshold based on standard deviation of average distances between points on input.
Input value
inNeighborCount const int 1 - 10 Defines number of neighbors used to compute average distances between vertices.
Output value
outGrid Point3DGrid& Cleaned input
Diagnostic input
diagThreshold float& Threshold used by the algorithm.
Diagnostic input
diagAverageDistance float& Average distance between input points and their neighborhood

Errors

List of possible exceptions:

Error type Description
DomainError inNeighborCount is larger than the number of valid points in RemoveOutliersFromPoint3DGrid.
DomainError Input grid has no valid points in RemoveOutliersFromPoint3DGrid.
DomainError Input grid is empty in RemoveOutliersFromPoint3DGrid.