pccat

Concatenate 3-D point cloud array

Since R2020b

Syntax

ptCloudOut = pccat(ptClouds)

Description

ptCloudOut = pccat(ptClouds) concatenates a 3-D point cloud array, ptClouds. ptCloudOut contains the Location, Color, Normal, and Intensity property values of all the concatenated point clouds.

Examples

Combine Sequence of Point Clouds

Read a sequence of aligned point clouds.

filePath = fullfile(toolboxdir('vision'),'visiondata','pcdmapseq');
fileDS = fileDatastore(filePath,'ReadFcn',@pcread,'UniformRead',true);
ptClouds = readall(fileDS);

Concatenate point clouds into a single point cloud.

ptCloudOut = pccat(ptClouds);

Display concatenated point cloud.

pcshow(ptCloudOut)

Input Arguments

ptClouds — Point clouds

M-by-1 pointCloud array

Point cloud objects, specified as an M-by-1 pointCloud array.

Output Arguments

ptCloudOut — Concatenated point cloud

pointCloud object

Concatenated point cloud, returned as a pointCloud object. ptCloudOut contains the Location, Color, Normal, and Intensity property values of all the concatenated point clouds.

Tips

• If the input point clouds do not all have an assigned value for a property, the function does not assign a value for that property in the returned point cloud. For example, if some of the input point clouds have values for the Color property but another one does not, then the function does not return a value for the Color property of ptCloudOut.

• The function filters out points with NaN or Inf values.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

• All point clouds in the input point cloud array must be either organized or unorganized point clouds.

Version History

Introduced in R2020b