ExtractBlob3D

Reference to a cell containing a point cloud. The default value is $A$0.

Specifies the point cloud coordinate system in which the 3D fixture is defined. It is offset from the PointCloud origin in the following format with the following arguments:

{X, Y, Z, Rotation, Tilt, TiltDirection}

Specifies a reference to a Fixture3D structure defined in another cell to be used as the function's fixture. Set to 0 (OFF) to use the function's internal fixture instead.

Specifies the dimensions, offset and angle of the function's 3D region of interest (ROI). It is offset from the Fixture3D origin in the following format with the following arguments:

{SizeX, SizeY, SizeZ, X, Y, Z, Rotation, Tilt, TiltDirection}

Specifies a reference to 3D region defined in another cell to be used as the function's Region of Interest (ROI). Set to 0 (OFF) to use the function's internal Box3D structure as the ROI.

When checked, the function uses a plane derived from the configured Region3D region or External Region This is useful if you need only just a rough reference shape or surface, and you do not want to extract or explicitly define a plane. The setting is disabled (unchecked) by default.

Specifies the offset and the angle of the plane to use. It is offset from the PointCloud origin in the following format with the following arguments:

{X, Y, Z, Tilt, TiltDirection}

Specifies a reference to a Rectangle3D or Circle3D structure defined in another cell to be used by the function. Set to 0 (OFF) to use the function's internal Plane3D structure instead.

When checked, the function automatically tries to estimate the smallest distance that two points can be apart, but still be considered to belong to the same blob result. This is achieved by using the known point cloud and sensor sampling distance. This parameter is enabled by default.

Disable this setting to configure the connectivity distance manually.

Specifies the maximum distance (in real-world units) between two points at which they are still considered to be part of the same blob. The value range is between 0.010 – inf., and default value is 1.0.

When checked, the function automatically sets the noise threshold of the blobs to be detected, based on the detected point cloud sampling distance. This parameter is enabled by default.

Specifies the noise threshold of the blobs to be detected (in real-world units). This parameter creates a margin above and below the reference shape, and all points within this region are considered overlapping the reference shape. These points will not be part of any Positive or Negative blob types: only Unchanged blobs will contain them. Configuring this parameter properly helps you to deal with noisy points near the reference shape without affecting blob height and volume measurements.

The value range is from 0 to inf., and the default value is 0.

Specifies the maximum number of blobs to extract. The value range is 1 to 65535, and the default value is 1.

Specifies the minimum volume (in real-world units) that the blobs must have to be detected and included, allowing you to skip very small blobs that are probably caused by noise. The value range is from 0 to the configured value of the Maximum Volume property. The default value is 20).

Specifies the minimum height (in real-world units) that the blobs must have to be detected and included, allowing you to skip very small blobs that are probably caused by noise. The value range is from 0 to the configured value of the Maximum Height property. The default value is 1).

Specifies the blob types to detect or ignore by checking or unchecking their respective properties. The available types are the following:

• Positive: Specifies a positive volume with respect to the reference shape (that is a blob above the reference shape). This is the default setting.
• Negative: Specifies a negative volume with respect to the reference shape (that is a blob below the reference shape).
• Unchanged: Specifies an unchanged volume with respect to the reference (that is, a blob that overlaps the reference shape, and as such, indicates no change).

Specifies the logic by which the blobs of the referenced Blobs3D structure will be sorted. The available values are the following:

• None: No sorting logic will be applied to the list of blobs. Use this setting if you simply want a count of the blobs, or want to examine them without the need to order them.
• Volume: Sort the blobs by their volume. Use this setting if you want to examine the blobs sorted by their volume (e.g. from the largest volume to the smallest, or the opposite). This is the default setting.
• Bounding Box Size: Sort the blobs by the length of their bounding boxes on the specified axis. Use this setting if you want to examine the blobs sorted by their size (e.g., from the largest to the smallest, or the opposite), with the size specified by the bounding box dimensions of the blobs. This sorting key has four sub-types:
  • Bounding Box Size X: Sort the blobs by the X-axis length of their bounding boxes.
  • Bounding Box Size Y: Sort the blobs by the Y-axis length of their bounding boxes.
  • Bounding Box Size Z: Sort the blobs by the Z-axis length of their bounding boxes.
  • Bounding Box Size D: Sort the blobs by the diagonal length of their bounding boxes.
• Center of Mass: Sort the blobs by their 3D positions in the 3D point cloud. The blob's 3D position is specified by the location of its center of mass in the point cloud in the specified direction (that is, their X, Y, Z or radial distance from the origin of the specified Sort Reference space). This sorting key has four sub-types:
  • Center of Mass X: Sort the blobs by the X-axis distance of their center of mass from the origin of the Sort Reference space.
  • Center of Mass Y: Sort the blobs by the Y-axis distance of their center of mass from the origin of the Sort Reference space.
  • Center of Mass Z: Sort the blobs by the Z-axis distance of their center of mass from the origin of the Sort Reference space.
  • Center of Mass R: Sort the blobs by the Euclidean distance of their center of mass from the origin of the Sort Reference space.
• Center of Mass Spoke: Sort the blobs by their 2D positions. Use these sort keys, for example, if the objects are arranged in a circular fashion on a plane surface. The "2D position" refers to the blob's center of mass as projected onto the X/Y plane of the Sort Reference's space. This sorting key has two sub-types:
  • Center of Mass Spoke Angle Norm: Sort the blobs by the normalized spoke angle of their center of mass.
  • Center of Mass Spoke Angle Abs: Sort the blobs by the absolute spoke angle of their center of mass.
  • Center of Mass Spoke Radius: Sort the blobs by their center of mass distance from their origin to the center of mass location on the X-axis and Y-axis (disregarding the Z-axis height).
• Center of Mass Grid X then Y then Z: Sort by the center-of-mass' X-axis position, then Y-axis position, and finally Z-axis position.
• Center of Mass Grid Y then X then Z: Sort by the center-of-mass' Y-axis position, then X-axis position, and finally Z-axis position.

Specifies whether to sort the results in ascending or descending order.

Specifies a threshold to determine if 2 or more results are tied. If they are tied, they can be sorted by a subsequent sort. Only takes effect when multiple sorting rules are applied (e.g. grid sorting or appending a sort tool).

Specifies the origin of the coordinate space in which the positional and rotational values are defined. The available values are the following:

• Camera: The coordinate space is based off the system in which the point cloud's points are defined.
• Region: The coordinate space is based off the coordinate system of the region of interest (ROI) used in the job.

Selects the type of graphics to overlay on the image.