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.