Main Content

vision.labeler.loading.PointCloudSequenceSource Class

Namespace: vision.labeler.loading
Superclasses: vision.labeler.loading.MultiSignalSource

Load signals from point cloud sequence sources into Lidar Labeler app

Since R2020b

Description

The vision.labeler.loading.PointCloudSequenceSource class creates an interface for loading a signal from a point cloud sequence data source into the Lidar Labeler app. In the Select Point Cloud dialog box of the app, when Source Type is set to Point Cloud Sequence, this class controls the parameters in that dialog box.

To access this dialog box, in the app, select Import > Add Point Cloud.

This class loads point cloud sequences composed of PCD or PLY files.

The vision.labeler.loading.PointCloudSequenceSource class is a handle class.

Creation

When you export labels from a Lidar Labeler app session that contains a point cloud sequence source, the exported groundTruthLidar object stores an instance of this class in its DataSource property.

To create a PointCloudSequenceSource object programmatically, such as when programmatically creating a groundTruthLidar object, use the vision.labeler.loading.PointCloudSequenceSource function (described here).

Description

pcSeqSource = vision.labeler.loading.PointCloudSequenceSource creates a PointCloudSequenceSource object for loading a signal from a point cloud sequence data source. To specify the data source and the parameters required to load the source, use the loadSource method.

example

Properties

expand all

Name of the type of source that this class loads, specified as a string scalar.

Attributes:

GetAccess
public
Constant
true
NonCopyable
true

Description of the functionality that this class provides, specified as a string scalar.

Attributes:

GetAccess
public
Constant
true
NonCopyable
true

Name of the data source, specified as a string scalar. Typically, SourceName is the name of the file from which the signal is loaded.

Attributes:

GetAccess
public
SetAccess
protected

Parameters for loading a point cloud sequence signal from a data source, specified as a structure.

This table describes the required and optional fields of the SourceParams structure.

FieldDescriptionRequired or Optional
Timestamps

Timestamps for the point cloud sequence signal, specified as a cell array containing a single duration vector of timestamps.

In the Select Point Cloud dialog box of the app, if you set the Timestamps parameter to From Workspace and read the timestamps from a variable in the MATLAB® workspace, then the SourceParams property stores these timestamps in the Timestamps field.

Optional

If you set the Timestamps parameter to Use Default and use the default timestamps for point cloud sequence signals, then the structure does not include this field, and the SourceParams property is empty, []. For point cloud sequence signals, the default timestamp duration vector has elements from 0 to the number of valid point cloud files minus 1. Units are in seconds.

Attributes:

GetAccess
public
SetAccess
protected

Names of the signals that can be loaded from the data source, specified as a string vector.

Attributes:

GetAccess
public
SetAccess
protected

Types of the signals that can be loaded from the data source, specified as a vector of vision.labeler.loading.SignalType enumerations. Each signal listed in the SignalName property is of the type in the corresponding position of SignalType.

Attributes:

GetAccess
public
SetAccess
protected

Timestamps of the signals that can be loaded from the data source, specified as a cell array of duration vectors. Each signal listed in the SignalName property has the timestamps in the corresponding position of Timestamp.

Attributes:

GetAccess
public
SetAccess
protected

Number of signals that can be read from the data source, specified as a nonnegative integer. NumSignals is equal to the number of signals in the SignalName property.

Attributes:

GetAccess
public
SetAccess
public
Dependent
true
NonCopyable
true

Methods

expand all

Examples

collapse all

Specify the path to a folder containing a point cloud sequence.

pcSeqFolder = fullfile(toolboxdir('vision'),'visiondata', ...
    'pcdmapseq');

Create a point cloud sequence source. The sequence does not have a separate timestamps file to load with it, so specify the source parameters as empty. Load the folder path and the empty source parameters into the PointCloudSequenceSource object.

sourceName = pcSeqFolder;
sourceParams = [];

pcseqSource = vision.labeler.loading.PointCloudSequenceSource;
loadSource(pcseqSource,sourceName,sourceParams)

Read the first frame in the sequence. Display the frame.

signalName = pcseqSource.SignalName;
pc = readFrame(pcseqSource,signalName,1);

figure
pcshow(pc)

Figure contains an axes object. The axes object contains an object of type scatter.

Version History

Introduced in R2020b