Normal Filtering

Description

This operator filters the point cloud based on the normal vector direction of each point. It calculates the angle difference between the normal vector of each point and the user-specified "Reference Normal", and retains (or removes if invert is enabled) those points whose angle difference is less than or equal to the set "Angle Threshold".

Overview

Filters point clouds based on normal vector directions, suitable for extracting point clouds oriented in a specific direction.

Scenarios

  • Extract surfaces with specific orientations: For example, extracting all approximately horizontal (normal close to [0,0,1] or [0,0,-1]) or vertical surface points in the scene.

  • Remove points with incorrect normals: In areas where normal estimation is inaccurate or erroneous, this method can filter out points whose normals deviate too much from expectations.

  • Segmentation based on surface orientation: Separating point cloud regions with similar normals.

Inputs and Outputs

Inputs

Point Cloud: The input must be a point cloud or a list of point clouds with normal information.

Outputs

Filtered point cloud: The list of point clouds with normals remaining after filtering.

Parameters

Reference Normal

Description

Defines a 3D vector [nx, ny, nz] as the reference normal direction for comparison.

Tuning Instructions

Enter a vector representing the surface orientation you want to keep or remove. For example, to keep or remove surfaces facing roughly upward, set it to [0, 0, 1] (assuming the Z axis points up); to keep or remove surfaces perpendicular to the X axis, set it to [1, 0, 0] or [-1, 0, 0].

Note: When setting the "Reference Normal", you only need to ensure the direction is correct — the vector’s length does not matter, as the operator automatically normalizes it to unit length.

[-1,0,0]

Parameter Range

Default: [0, 0, -1]

Angle Threshold

Description

Defines the maximum angle difference allowed between a point’s normal vector and the "Reference Normal".

Tuning Instructions

Determines the strictness of the filtering, set according to the expected surface curvature to be retained.

  • Smaller threshold (e.g., 10-30 degrees): Retains only points whose normals are very close to the reference normal, selecting surfaces with a more singular orientation.

  • Larger threshold (e.g., 60-90 degrees): Allows for larger normal deviations, retaining points with a wider range of orientations.

Parameter Range

[0, 180], Default value: 60, Unit: Degree

Parameter Range

Values/Range: [0, 180]

Default: 60

Unit: °

Invert Filter

Description

Inverts the filtering logic.

Tuning Instructions

Disabled (Default): Keeps points whose normal angle difference from the reference normal is less than the threshold.

Enabled: Removes points whose normal angle difference from the reference normal is less than the threshold, i.e., keeps points with an angle difference greater than or equal to the threshold.

Parameter Range

Default: False

Enable Node

Description

Controls whether this operator executes its computation.

Tuning Instructions

  • Enabled (Default): Runs the operator function normally.

  • Disabled: The operator performs no operation and directly outputs the input data.

Parameter Range

Default: True