blockedPointCloudDatastore

Datastore for use with blocks from blockedPointCloud objects

Since R2022a

Description

A blockedPointCloudDatastore object manages a collection of point cloud blocks that belong to one or more blockedPointCloud objects.

Creation

Syntax

bpcds = blockedPointCloudDatastore(bpcs)

bpcds = blockedPointCloudDatastore(bpcs,Name=Value)

Description

bpcds = blockedPointCloudDatastore(bpcs) creates a blockedPointCloudDatastore object that manages a collection of point cloud blocks of one or more blockedPointCloud objects, bpcs.

The BlockSize property of the first element in bpcs is the default datastore block size.

bpcds = blockedPointCloudDatastore(bpcs,Name=Value) specifies the BlockSize, BlockLocationSet, ReadSize and MinPoints properties of blockedPointCloudDatastore object by using one or more name-value arguments.

Input Arguments

bpcs — Blocked point clouds

array of blockedPointCloud objects

Blocked point clouds, specified as an array of blockedPointCloud objects.

Properties

BlockLocationSet — Blocks to include in datastore

blockLocationSet object

Blocks to include in the datastore, specified as a blockLocationSet object. The object specifies which blocks to include from the blocked point cloud bpcs. You can repeat or omit individual blocks. To obtain the default value, blockedPointCloudDatastore calls the selectBlockLocations function.

You cannot change the BlockLocationSet property after creating the blockedPointCloudDatastore.

BlockSize — Block size

three-element numeric row vector

Block size, specified as a three-element numeric row vector. The elements specify the size of each block in the X-, Y- and Z- dimensions, respectively.

The default value is the block size of the first blockedPointCloud in bpcs.

You cannot change the BlockSize property after creating the blockedPointCloudDatastore.

Example: BlockSize=[50 30 40]

MinPoints — Minimum number of points for each block

0 (default) | nonnegative scalar

Minimum number of points each block must contain, specified as a nonnegative scalar. The function discards blocks that contain fewer points than MinPoints.

PointClouds — Blocked point clouds

array of blockedPointCloud objects

Blocked point clouds that supply blocks for the blockedPointCloudDatastore, specified as an array of blockedPointCloud objects. All elements of pointClouds must have the same number of dimensions and be of the same type.

You cannot change the PointClouds property after creating the blockedPointCloudDatastore.

ReadSize — Number of blocks to return in each call to read function

1 (default) | positive integer

Number of blocks to return in each call to the read function, specified as a positive integer. Each call to the read function reads at most ReadSize blocks.

TotalNumBlocks — Total number of blocks available

Read-only: numeric scalar

This property is read-only.

Total number of blocks available, specified as a numeric scalar.

Object Functions

combine	Combine data from multiple datastores
hasdata	Returns true if more data is available in blockedPointCloudDatastore
numpartitions	Number of datastore partitions
partition	Partition blockedPointCloudDatastore
preview	Preview subset of data in datastore
read	Read data and metadata from blockedPointCloudDatastore
readall	Read all data from blockedPointCloudDatastore
reset	Reset datastore to initial state
shuffle	Shuffle data in datastore
subset	Create subset of datastore or FileSet
transform	Transform datastore

Examples

Create Point Cloud Datastore

Create a blocked point cloud from a LAZ file, specifying the block size.

pcfile = fullfile(toolboxdir("lidar"),"lidardata", ...
                "las","aerialLidarData.laz");
bpc = blockedPointCloud(pcfile,[50 50]);

Create a blocked point cloud datastore that contains the blocked point cloud.

bpcds = blockedPointCloudDatastore(bpc);

Read four blocks from the datastore.

bpcds.ReadSize = 4;
blocks = read(bpcds);

Display the details of the four blocks.

disp(blocks)

    {1×1 pointCloud}
    {1×1 pointCloud}
    {1×1 pointCloud}
    {1×1 pointCloud}

Create blockedPointCloudDatastore from Multiple Files

Create a FileSet object containing multiple LAS files.

fs = matlab.io.datastore.FileSet(...
   fullfile(toolboxdir("lidar"),"lidardata", ...
                "las"),"FileExtensions",".las");

Create an array of blockedPointCloud objects from the file set, and specify an adapter. Specifying an adapter means the blockedPointCloud function does not have to inspect each file to pick a suitable adapter.

readAdapter = lidar.blocked.LAS();
bpcs = blockedPointCloud(fs,[100 100],Adapter=readAdapter);

Create a blocked point cloud datastore from the blockedPointCloud array.

bpcds = blockedPointCloudDatastore(bpcs);

Read all data from the blockedPointCloudDatastore.

blocks = readall(bpcds);

Version History

Introduced in R2022a

R2023b: Specify the minimum number of points in every block

You can now specify the minimum number of points every block must contain by using the MinPoints property of the blockedPointCloudDatastore object.