Segmentation#

The Segmentation tab provides tools for refinement, clustering and analysis.

Merge
#merge
Remove
#remove
Transform
#transform
Crop
#crop
Cluster
#cluster
Trim
#trim
Thin
#thin
Downsample
#downsample
Distances
#distances
Properties
#properties

Merge#

Combines multiple clusters or creates new clusters from point selections:

For complete clusters:

  1. Select multiple clusters in the Object Browser

  2. Click Merge in the ribbon or press m after clicking the viewport.

  3. Selected clusters are combined into a single new cluster

For point selections:

  1. Use area selection (R key) to select points from one or more clusters

  2. Click Merge or press m after clicking the viewport.

  3. A new cluster is created containing only the selected points

  4. Original clusters remain but without the selected points

Remove#

Deletes selected clusters or removes points from clusters:

For complete clusters:

  1. Select one or more clusters in the Object Browser

  2. Click Remove or press Delete after clicking the viewport.

  3. Selected clusters are completely deleted

For point selections:

  1. Use area selection (R key) to select points within clusters

  2. Click Remove or press Delete after clicking the viewport.

  3. Only the selected points are removed from their parent clusters

  4. Empty clusters are automatically deleted

Select by Size#

Filters clusters by point count:

  1. Click Select in the ribbon

  2. Adjust the slider to set a minimum size threshold

  3. Clusters below the threshold are automatically selected

  4. Use in combination with Remove to clean up small clusters

Transform#

Applies rotation and translation to clusters:

  1. Select a cluster in the Object Browser

  2. Click Transform

  3. A 3D transformation widget appears around the cluster

  4. Use the transformation widget to move or rotate the cluster

  5. Press Transform again to exit transformation mode

Crop#

Trims points based on distance to other structures:

  1. Click Crop

  2. Select source structures to crop

  3. Select target structures to measure distance from

  4. Set the distance threshold

  5. Choose to keep points within or beyond the threshold

Cluster#

Groups points into separate clusters:

  1. Select a cluster with multiple distinct structures

  2. Click Cluster

  3. Choose clustering method:

    • Connected Components: Groups connected components (default). Particularly useful for postprocessing volume segmentations.

    • DBSCAN: Density-based clustering with distance and minimum points parameters

    • K-Means: Divides into a specified number of clusters

    • Birch: Hierarchical clustering using Clustering Feature Trees, ideal for large datasets

  4. Configure method-specific parameters:

    DBSCAN:
    • Distance: Maximum distance between points in the same cluster

    • Min Points: Minimum points required to form a cluster

    K-Means:
    • K: Number of target clusters

    Birch:
    • Clusters: Number of target clusters

    • Threshold: Radius threshold for merging subclusters (lower values create more clusters)

    • Branching Factor: Maximum subclusters per node (affects memory usage and clustering speed)

  5. Click OK to apply clustering

Outlier Removal#

Removes noise points using statistical methods:

  1. Select a cluster to clean

  2. Click Outlier

  3. Choose removal method:

    • Statistical: Removes points based on distance to neighbors

    • Eigenvalue: Removes edge points using covariance analysis

  4. Configure parameters:

    • Neighbors: Number of neighbors to consider for statistics

    • Threshold: Sensitivity of outlier detection (lower = more aggressive)

Trim#

Select points outside specified axis-aligned boundaries:

  1. Select a cluster

  2. Click Trim

  3. Two cutting planes appear in the 3D viewer

  4. Position the planes by dragging or use keyboard shortcuts:

    • X: Align planes to X-axis

    • Y: Align planes to Y-axis

    • Z: Align planes to Z-axis

  5. Points between the planes are preserved

  6. Press Trim again to exit trim mode

Thin#

Reduces point density while preserving structure:

  1. Select a cluster

  2. Click Thin

  3. Choose thinning method:

    • Outer: Keep surface/hull points

    • Core: Keep central/medoid points

    • Inner: Keep interior points using ray-casting

  4. Click OK to apply thinning

Downsample#

Reduces the number of points while maintaining overall structure:

  1. Select a cluster

  2. Click Downsample

  3. Choose downsampling method:

    • Radius: Remove points within a specified distance of each other

    • Number: Randomly subsample to a target number of points

  4. Configure parameters:

    • Radius: Minimum distance between retained points

    • Size: Target number of points for random subsampling

  5. Click OK to apply downsampling

Distances#

Analyzes distance distributions between clusters:

  1. Click Distances

  2. In the dialog:

    • Select source clusters/models to measure from

    • Select target clusters/models to measure to

    • Configure distance calculation parameters

  3. View results:

    • Distance histograms and statistics

    • Minimum, maximum, mean, and standard deviation

    • Export data as CSV for external analysis

  4. Use results to inform clustering or filtering decisions

Properties#

Advanced analysis and visualization dialog with three modes: Visualize, Distribution, and Statistics.

  1. Select objects in the Object Browser

  2. Click Properties in the ribbon

  3. Use Compute to calculate properties, then switch between tabs

Property Categories:

  • Distance: To camera, clusters, or models

  • Surface: Curvature, edge length, surface area, volume

  • Geometric: Dimensions, point counts, identity

  • Projection: Projected curvature, geodesic distance

Visualization Options:

  • Color Maps: Common colormaps (viridis, plasma, etc.)

  • Normalization: Per-object or global scaling

  • Quantiles: Statistical binning for outlier handling

  • Interactive: Real-time color mapping in 3D viewport

Visualize Tab: Compute geometric properties and display as interactive color maps in the 3D viewport.

Distribution Tab: Generate interactive export-ready histograms, density plots, and line charts with customizable styling.

Statistics Tab: View numerical summaries (min, max, mean, std dev) and export data as CSV/TSV files.

Tip

All data can be exported using the Export Data button.