vScriptValFuseClosePoints
Merges points that lie within a distance of each other into one point.
vScriptValFuseClosePoints takes an array of points and welds those within Distance Threshold of each other. Fuse Mode keeps the first point of each group or the average, and Axis Mode picks the axes used for the distance.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| Distance Threshold | Float | 0.02 | Points within this distance (or exactly at it) are joined. Minimum 0, default 0.02. |
| Fuse Mode | Dropdown | Average | Keep First or Average (default). |
| Axis Mode | Dropdown | XYZ | XYZ (default), XY, XZ, YZ, X Only, Y Only or Z Only. The axes used for the distance. |
| Minimum Cluster Size | Integer | 1 | Clusters with fewer points are removed from the output. Minimum 1, default 1. |
| Delete Singles | Integer | 0 | Removes points that have no neighbour within the threshold when on. Default off. |
+1 more parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| Input | DATATYPE | — | Data to process. |
Read the full description
The node builds clusters. A point joins a cluster if it is within Distance Threshold of any point already in it, so a chain of close points becomes one cluster. Each cluster becomes one point: the first point of the cluster (Keep First) or the average of its X, Y and Z (Average, the default).
Axis Mode measures the distance over XYZ, XY, XZ, YZ or a single axis. Clusters with fewer points than Minimum Cluster Size are removed from the output. Delete Singles removes clusters of one point. The order of the output follows the first point of each cluster.
A label under the controls shows the counts of input points, output points and clusters.
Example Connections
- Weld scattered points and draw
- Weld a jittered grid
vScriptValRandom.Output -> vScriptValFuseClosePoints.Input
vScriptValFuseClosePoints.Output -> vScriptValCameraProjection.ArrayA
vScriptValCameraProjection.Output -> vScriptValShapeRender.ArrayPoint
Background.Output -> vScriptValShapeRender.Input
vScriptValPointsOnGrid.Output -> vScriptValPointsJitter.Input
vScriptValPointsJitter.Output -> vScriptValFuseClosePoints.Input
vScriptValFuseClosePoints.Output -> vScriptValTranslate.Input