labelDefinitionCreatorLidar

R2026b

(To be removed) Store, modify, and create label definitions tables for lidar

labelDefinitionCreatorLidar will be removed in a future release. Use labelDefinitionCreatorMultiSensor instead. For information on updating your code, see Version History.

Description

The labelDefinitionCreatorLidar object stores definitions of labels and attributes to label ground truth data for a lidar workflow. Use various Object Functions to add, remove, modify, or display label definitions. Use the create object function to create a label definitions table from the labelDefinitionCreatorLidar object. You can use this label definitions table with the Lidar Labeler app.

Creation

Syntax

ldc = labelDefinitionCreatorLidar

ldc = labelDefinitionCreatorLidar(labelDefs)

Description

ldc = labelDefinitionCreatorLidar creates an empty label definition creator object, ldc, for the lidar workflow. Add label definitions to this object, as well as modify or remove them, using various Object Functions. Use the info object function to inspect the stored labels and attributes.

ldc = labelDefinitionCreatorLidar(labelDefs) creates a label definition creator object, ldc, for a lidar workflow that contains the definitions from the label definitions table labelDefs.

Input Arguments

labelDefs — Label definitions

table

Label definitions, returned as a table with up to eight columns. The possible columns are Name, Type, Group, Description, LabelColor, and Hierarchy. This table contains the definitions and attributes of labels used for labeling ground truth lidar data. For more details, see the labelDefinitions property of the groundTruthLidar object.

Object Functions

addLabel	(To be removed) Add label to label definition creator object for lidar workflow
addAttribute	(To be removed) Add attribute to label in label definition creator for lidar workflow

editLabelGroup	(To be removed) Modify label group name in label definition creator object for lidar workflow
editLabelDescription	(To be removed) Modify label description in label definition creator for lidar workflow
editAttributeDescription	(To be removed) Modify attribute description in label definition creator object for lidar workflow
editGroupName	(To be removed) Change group name in label definition creator for lidar workflow

removeLabel	(To be removed) Remove label from label definition creator for lidar workflow
removeAttribute	(To be removed) Remove attribute from label in label definition creator for lidar workflow

create

(To be removed) Create label definitions table from label definition creator object for lidar workflow

info	(To be removed) Display label or attribute information stored in label definition creator for lidar workflow

Examples

Create Label Definition Creator Object for Lidar Workflow and Add Label Definitions

Create an empty labelDefinitionCreatorLidar object.

ldc = labelDefinitionCreatorLidar;

Add a Cuboid label, Vehicle, to the label definition creator.

addLabel(ldc,'Vehicle','Cuboid')

Add a Color attribute to the Vehicle label as a list of three strings.

addAttribute(ldc,'Vehicle','Color','List',{'Red','White','Green'})

Display the details of the updated label definition creator object.

ldc

ldc = 
labelDefinitionCreatorLidar contains the following labels:

	Vehicle with 1 attributes and belongs to None group.	(info)

For more details about attributes, use the info method.

Create a label definitions table from the definition stored in the object.

labelDefs = create(ldc)

labelDefs = 1×6 table
       Name           Type       LabelColor     Group      Description     Hierarchy  
    ___________    __________    __________    ________    ___________    ____________

    {'Vehicle'}    {[Cuboid]}    {0×0 char}    {'None'}       {' '}       {1×1 struct}

	Get insights using Copilot

Create Label Definition Creator Object for Lidar Workflow from Label Definitions Table

Load a lidar label definitions table into the workspace.

load('lidarLabelerGTruth.mat')

Create a labelDefinitionCreatorLidar object from the label definitions table.

ldc = labelDefinitionCreatorLidar(gTruth.LabelDefinitions)

ldc = 
labelDefinitionCreatorLidar contains the following labels:

	car with 0 attributes and belongs to None group.	(info)
	bike with 0 attributes and belongs to None group.	(info)
	pole with 0 attributes and belongs to None group.	(info)
	vegetation with 0 attributes and belongs to None group.	(info)

For more details about attributes, use the info method.

Add a new attribute to the car label.

addAttribute(ldc,'car','Color','List',{'Red','Green','Blue'})

Display the details of the updated labelDefinitionCreatorLidar object.

ldc

ldc = 
labelDefinitionCreatorLidar contains the following labels:

	car with 1 attributes and belongs to None group.	(info)
	bike with 0 attributes and belongs to None group.	(info)
	pole with 0 attributes and belongs to None group.	(info)
	vegetation with 0 attributes and belongs to None group.	(info)

For more details about attributes, use the info method.

Version History

Introduced in R2020b

R2026b: To be removed

The labelDefinitionCreatorLidar object will be removed in a future release. Use the labelDefinitionCreatorMultiSensor object instead. The Multi-Sensor Labeler app replaces the Lidar Labeler app and uses labelDefinitionCreatorMultiSensor for label definitions.