filters.relaxationdartthrowing#
The Relaxation Dart Throwing Filter is a variation on Poisson sampling. The approach was first introduced by [McCool and Fiume, 1992]. The filter operates nearly identically to filters.sample, except it will continue to shrink the radius with each pass through the point cloud until the desired number of output points is reached.
See also
filters.decimation, filters.fps and filters.sample all perform some form of thinning or resampling.
Note
The shuffle
option does not reorder points in the PointView, but
shuffles the order in which the points are visited while processing, which
can improve the quality of the result.
Options#
- decay
Decay rate for the radius shrinkage. [Default: 0.9]
- radius
Starting minimum distance between samples. [Default: 1.0]
- count
Desired number of points in the output. [Default: 1000]
- shuffle
Choose whether or not to shuffle order in which points are visited. [Default: true]
- seed
Seed for random number generator, used only with shuffle.
- where
An expression that limits points passed to a filter. Points that don’t pass the expression skip the stage but are available to subsequent stages in a pipeline. [Default: no filtering]
- where_merge
A strategy for merging points skipped by a
where
option when running in standard mode. Iftrue
, the skipped points are added to the first point view returned by the skipped filter. Iffalse
, skipped points are placed in their own point view. Ifauto
, skipped points are merged into the returned point view provided that only one point view is returned and it has the same point count as it did when the filter was run. [Default:auto
]