labelDefinitionCreatorMultisignal

Object for storing, modifying, and creating label definitions table for multisignal workflow

Description

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

Creation

Syntax

ldc = labelDefinitionCreatorMultisignal

ldc = labelDefinitionCreatorMultisignal(labelDefs)

Description

ldc = labelDefinitionCreatorMultisignal creates an empty label definition creator object ldc for a multisignal workflow. Add label definitions to this object using Object Functions. Use the info function to inspect details of stored labels, sublabels, and attributes.

ldc = labelDefinitionCreatorMultisignal(labelDefs) creates a label definition creator object ldc for a multisignal workflow and stores definitions from the label definitions table labelDefs. Use Object Functions to add new label definitions or modify the existing label definitions. Use the info function to inspect details of stored labels, sublabels, and attributes.

Input Arguments

labelDefs — Label definitions

table

Label definitions, specified as a table with up to eight columns. The possible columns are Name, SignalType, LabelType, Group, Description, LabelColor, PixelLabelID, and Hierarchy. This table specifies the definitions of labels, sublabels, and attributes for labeling ground truth data. For more details, see LabelDefinitions property of groundTruthMultisignal object.

Output Arguments

ldc — Label definition creator for multisignal workflow

labelDefinitionCreatorMultisignal object

Label definition creator for the multisignal workflow, returned as a labelDefinitionCreatorMultisignal object that contains information about label definitions associated with ground truth data.

Object Functions

addLabel	Add label to label definition creator object for multisignal workflow
addSublabel	Add sublabel to label in label definition creator object for multisignal workflow
addAttribute	Add attributes to label or sublabel in label definition creator object for multisignal workflow

removeLabel	Remove label from label definition creator object for multisignal workflow
removeSublabel	Remove sublabel from label in label definition creator object for multisignal workflow
removeAttribute	Remove attribute from label or sublabel in label definition creator object for multisignal workflow

editLabelGroup	Modify label group name in label definition creator object for multisignal workflow
editGroupName	Change group name in label definition creator object for multisignal workflow
editLabelDescription	Modify label or sublabel description in label definition creator object for multisignal workflow
editAttributeDescription	Modify attribute description in label definition creator object for multisignal workflow

create

Create label definitions table from label definition creator object for multisignal workflow

info	Display label, sublabel, or attribute information stored in label definition creator object for multisignal workflow

Examples

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

Create an empty labelDefinitionCreatorMultisignal object.

ldc = labelDefinitionCreatorMultisignal

ldc = 
labelDefinitionCreatorMultisignal

Add a label with the name 'Vehicle'. Specify the type as 'Rectangle'. Adding a 'Rectangle' also adds a 'Cuboid' entry to the label definitions table.

addLabel(ldc,'Vehicle','Rectangle')

Add an attribute with the name 'Color' to the label 'Vehicle'. Specify the attribute type as a string with the value 'Red'.

addAttribute(ldc,'Vehicle','Color',attributeType.String,'Red')

Add a sublabel with the name 'Wheel' to the label 'Vehicle'. Specify the type of the sublabel as 'Rectangle'.

addSublabel(ldc,'Vehicle','Wheel','Rectangle')

Add an attribute called 'Diameter' to the sublabel 'Wheel'. Specify the attribute value as a 'Numeric' scalar.

addAttribute(ldc,'Vehicle/Wheel','Diameter','Numeric',14)

Display the details of the updated labelDefinitionCreatorMultisignal object.

ldc

ldc = 
labelDefinitionCreatorMultisignal contains the following labels:

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

For more details about attributes and sublabels, use the info method.

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

labelDefs = create(ldc)

labelDefs=2×7 table
       Name        SignalType    LabelType     Group      Description    LabelColor     Hierarchy  
    ___________    __________    _________    ________    ___________    __________    ____________

    {'Vehicle'}    Image         Rectangle    {'None'}       {' '}       {0×0 char}    {1×1 struct}
    {'Vehicle'}    PointCloud    Cuboid       {'None'}       {' '}       {0×0 char}    {1×1 struct}

Create Label Definition Creator Object for Multisignal Workflow from Existing Label Definitions Table

Load an existing multisignal label definitions table into the workspace.

labelDefFile = fullfile(toolboxdir('driving'),'core','drivingdata','labelDefsMultiSignal.mat');
ld = load(labelDefFile)

ld = struct with fields:
    labelDefs: [6×6 table]

Create a labelDefinitionCreatorMultisignal object from the label definitions table.

ldc = labelDefinitionCreatorMultisignal(ld.labelDefs)

ldc = 
labelDefinitionCreatorMultisignal contains the following labels:

	Car with 0 sublabels and 0 attributes and belongs to None group.	(info)
	LeftLane with 0 sublabels and 0 attributes and belongs to None group.	(info)
	Road with 0 sublabels and 0 attributes and belongs to None group.	(info)
	Sunny with 0 sublabels and 0 attributes and belongs to None group.	(info)
	Urban with 0 sublabels and 0 attributes and belongs to None group.	(info)

For more details about attributes and sublabels, use the info method.

Add a new attribute to the label 'Car'.

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

Display the details of the updated labelDefinitionCreatorMultisignal object.

ldc

ldc = 
labelDefinitionCreatorMultisignal contains the following labels:

	Car with 0 sublabels and 1 attributes and belongs to None group.	(info)
	LeftLane with 0 sublabels and 0 attributes and belongs to None group.	(info)
	Road with 0 sublabels and 0 attributes and belongs to None group.	(info)
	Sunny with 0 sublabels and 0 attributes and belongs to None group.	(info)
	Urban with 0 sublabels and 0 attributes and belongs to None group.	(info)

For more details about attributes and sublabels, use the info method.

Version History

Introduced in R2020a