addSublabel

R2026b

Add sublabel to label in multi-sensor label definition creator

Since R2026b

collapse all in page

Syntax

addSublabel(ldc,labelName,sublabelName,typeOfSublabel)
addSublabel(___,Name,Value)

Description

addSublabel(ldc,labelName,sublabelName,typeOfSublabel) adds a sublabel with the specified name and type to the indicated label. The sublabel is added under the hierarchy for the specified label in the labelDefinitionCreatorMultiSensor object ldc.

example

addSublabel(___,Name,Value) specifies options using one or more name-value pair arguments in addition to the input arguments in the previous syntax.

Examples

collapse all

Add sublabels to labels in a labelDefinitionCreatorMultiSensor object and inspect their details.

Create an empty labelDefinitionCreatorMultiSensor object.

ldc = labelDefinitionCreatorMultiSensor;

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 a sublabel with the name "Wheel" to the label "Vehicle". Specify the type of the sublabel as "Rectangle". Add a description to the sublabel.

addSublabel(ldc,"Vehicle","Wheel","rect",Description="Bounding boxes for wheel");

Display the details of the updated labelDefinitionCreatorMultiSensor object.

ldc
ldc =
labelDefinitionCreatorMultiSensor contains the following labels:

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

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

Display information about the label "Vehicle" using the object function info.

info(ldc,"Vehicle")
           Name: "Vehicle"
     SignalType: Image
      LabelType: Rectangle
          Group: "None"
     LabelColor: {''}
     Attributes: []
      Sublabels: "Wheel"
    Description: ' '

           Name: "Vehicle"
     SignalType: PointCloud
      LabelType: Cuboid
          Group: "None"
     LabelColor: {''}
     Attributes: []
      Sublabels: "Wheel"
    Description: ' '

Display information about the sublabel "Wheel" in the label "Vehicle" using the object function info.

info(ldc,"Vehicle/Wheel")
           Name: "Wheel"
           Type: Rectangle
     LabelColor: ''
     Attributes: []
      Sublabels: []
    Description: 'Bounding boxes for wheel'

Add another label with the name "TrafficLight". Specify the type as "Rectangle". Add a description to the label.

addLabel(ldc,"TrafficLight","Rectangle",Description="Bounding boxes for traffic light");

Add sublabels called "RedLight" and "GreenLight" to the label "TrafficLight". Specify the type of the sublabels as "Rectangle".

addSublabel(ldc,"TrafficLight","RedLight","Rectangle");
addSublabel(ldc,"TrafficLight","GreenLight","Rectangle");

Display the details of the updated labelDefinitionCreatorMultiSensor object.

ldc
ldc =
labelDefinitionCreatorMultiSensor contains the following labels:

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

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

Display information about the label "TrafficLight" using the object function info.

info(ldc,"TrafficLight")
           Name: "TrafficLight"
     SignalType: Image
      LabelType: Rectangle
          Group: "None"
     LabelColor: {''}
     Attributes: []
      Sublabels: ["RedLight"    "GreenLight"]
    Description: 'Bounding boxes for traffic light'

           Name: "TrafficLight"
     SignalType: PointCloud
      LabelType: Cuboid
          Group: "None"
     LabelColor: {''}
     Attributes: []
      Sublabels: ["RedLight"    "GreenLight"]
    Description: 'Bounding boxes for traffic light'

Input Arguments

collapse all

Label definition creator for the multi-sensor workflow, specified as a labelDefinitionCreatorMultiSensor object.

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

Sublabel name, specified as a character vector or string scalar that identifies the sublabel to be added.

Type of sublabel, specified as one of these values:

  • labelType enumeration — The type of the sublabel must be one of these labelType (Computer Vision Toolbox) enumerators: Rectangle, RotatedRectangle, Line, Point, Polygon, or ProjectedCuboid.

Example: addSublabel(ldc,"Car","Wheel",labelType.Rectangle);

  • Character vector or string scalar — This value must partially or fully match one of these labelType (Computer Vision Toolbox) enumerators: Rectangle, RotatedRectangle, Line, Point, Polygon, or ProjectedCuboid.

Example: addSublabel(ldc,"Car","Wheel","Rec");

Name-Value Arguments

collapse all

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: addSublabel(ldc,"Car","Wheel","Rec",Description="Bounding box for Wheel");

Sublabel description, specified as a character vector or string scalar. Use this name-value pair to describe the sublabel.

Sublabel color, specified as a 3-element row vector of RGB values in the range [0, 1]. By default, the sublabel color is the same as the parent label color. Yellow (RGB = [1 1 0]) is reserved for the color of selected labels.

Version History

Introduced in R2026b

See Also

Objects

Functions