Main Content

addLabel

Add label to label definition creator object for lidar workflow

    Description

    example

    addLabel(ldc,labelName,typeOfLabel) adds a label with the specified name and type to the labelDefinitionCreatorLidar object ldc.

    example

    addLabel(___,Name,Value) specifies options using one or more name-value pair arguments in addition to the input arguments in the previous syntax. For example, Group, truck sets the group of the added label to truck.

    Examples

    collapse all

    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    {0x0 char}    {'None'}       {' '}       {1x1 struct}
    
    

    Create an empty labelDefinitionCreatorLidar object.

    ldc = labelDefinitionCreatorLidar
    ldc = 
    labelDefinitionCreatorLidar
    

    Add a Cuboid label, Vehicle, to the label definition creator object. Include Group information for the label.

    addLabel(ldc,'Vehicle','Cuboid','Group','Transport');

    Add a Scene label, TrafficSign, to the object. Include Group information for the label.

    addLabel(ldc,'TrafficSign','Scene','Group','Data');

    Add a Color attribute to the Vehicle label as a string.

    addAttribute(ldc,'Vehicle','Color','String','Red');

    Display the details of the updated label definition creator object.

    ldc
    ldc = 
    labelDefinitionCreatorLidar contains the following labels:
    
    	Vehicle with 1 attributes and belongs to Transport group.	(info)
    	TrafficSign with 0 attributes and belongs to Data group.	(info)
    
    For more details about attributes, use the info method.
    

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

    info(ldc,'Vehicle')
               Name: "Vehicle"
               Type: Cuboid
         LabelColor: {''}
              Group: "Transport"
         Attributes: "Color"
        Description: ' '
    

    Display information about the Color attribute of the Vehicle label using the info object function.

    info(ldc,'Vehicle/Color')
                Name: "Color"
                Type: String
        DefaultValue: 'Red'
         Description: ' '
    

    Input Arguments

    collapse all

    Label definition creator for the lidar workflow, specified as a labelDefinitionCreatorLidar object.

    Label name, specified as a character vector or string scalar. This sets the name of the label in the label definition creator object.

    Type of label, specified using one of these options. For example, labelType.Cuboid specifies a Cuboid label type.

    • labelType enumeration — Specify the type of label as a Scene or Cuboid labelType enumerator.

    • Character vector or string scalar — Specify a value that partially or fully matches one of the labelType enumerators. For example, Cub specifies a Cuboid label type.

    Name-Value Arguments

    Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

    Example: Group, truck sets the group of the added label to truck.

    Group name, specified as a comma-separated pair consisting of 'Group' and the character vector or string scalar. Use this name-value pair arguments to specify a name for a group of labels.

    Label description, specified as a comma-separated pair consisting of 'Description' and the character vector or string scalar. Use this name-value pair arguments to describe the label.

    Introduced in R2020b