removeSublabel

Remove sublabel from label in label definition creator object

Description

example

removeSublabel(ldc,labelName,sublabelName) removes the specified sublabel from the indicated label. This label must be in the label definition creator object ldc.

Note

Removing a sublabel also removes any attributes associated with that sublabel.

Examples

collapse all

Load an existing label definitions table into the workspace.

labelDefFile = fullfile(toolboxdir('vision'), 'visiondata', 'labelDefsWithAttributes.mat');
ld = load(labelDefFile)
ld = struct with fields:
    labelDefs: [4×4 table]

Create a label definition creator object from the label definitions table.

ldc = labelDefinitionCreator(ld.labelDefs)
ldc = 
labelDefinitionCreator contains the following labels:

	Vehicle with 0 sublabels and 3 attributes.	(info)
	Pedestrian with 0 sublabels and 0 attributes.	(info)
	LaneMarker with 0 sublabels and 2 attributes.	(info)
	TrafficLight with 1 sublabels and 0 attributes.	(info)

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

Display information about the label "TrafficLight" defined in the label definition creator object.

info(ldc,'TrafficLight')
           Name: "TrafficLight"
           Type: Rectangle
     Attributes: []
      Sublabels: "Light"
    Description: 'Mark a tight bounding box around the traffic light. Use the sublabels to mark each individual light'

Remove the sublabel "Light" from the label "TrafficLight".

removeSublabel(ldc,'TrafficLight','Light')

Display the details of the label definition creator object to confirm that a sublabel is removed from the label "TrafficLight".

ldc
ldc = 
labelDefinitionCreator contains the following labels:

	Vehicle with 0 sublabels and 3 attributes.	(info)
	Pedestrian with 0 sublabels and 0 attributes.	(info)
	LaneMarker with 0 sublabels and 2 attributes.	(info)
	TrafficLight with 0 sublabels and 0 attributes.	(info)

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

Display information about the label "TrafficLight". Confirm that the sublabel "Light" is removed.

info(ldc,'TrafficLight')
           Name: "TrafficLight"
           Type: Rectangle
     Attributes: []
      Sublabels: []
    Description: 'Mark a tight bounding box around the traffic light. Use the sublabels to mark each individual light'

Input Arguments

collapse all

Label definition creator, specified as a labelDefinitionCreator object.

Label name, specified as a character vector or string scalar that uniquely identifies the label to which the sublabel is associated.

Sublabel name, specified as a character vector or string scalar that identifies the sublabel to be removed from the indicated label labelName.

Introduced in R2018b