Main Content

removeLabelDefinition

Remove label definition from labeled signal set

Description

removeLabelDefinition(lss,lblName) removes the label definition lblName from the labeled signal set lss. If you want to remove a sublabel, specify lblName as a two-element string array or two-element cell array of character vectors:

  • The first element is the name of the parent label.

  • The second element is the name of the sublabel.

example

Examples

collapse all

Load a labeled signal set containing recordings of whale songs.

load whales
lss
lss = 
  labeledSignalSet with properties:

             Source: {2×1 cell}
         NumMembers: 2
    TimeInformation: "sampleRate"
         SampleRate: 4000
             Labels: [2×3 table]
        Description: "Characterize wave song regions"

 Use labelDefinitionsHierarchy to see a list of labels and sublabels.
 Use setLabelValue to add data to the set.

Retrieve a hierarchical list of labels and sublabels.

labelDefinitionsHierarchy(lss)
ans = 
    'WhaleType
       Sublabels: []
     MoanRegions
       Sublabels: []
     TrillRegions
       Sublabels: TrillPeaks
     '

Remove the sublabel that labels peaks in the trill regions.

removeLabelDefinition(lss,{'TrillRegions' 'TrillPeaks'})

labelDefinitionsHierarchy(lss)
ans = 
    'WhaleType
       Sublabels: []
     MoanRegions
       Sublabels: []
     TrillRegions
       Sublabels: []
     '

Remove the label that specifies the whale type.

removeLabelDefinition(lss,"WhaleType")

getLabelNames(lss)
ans = 2×1 string
    "MoanRegions"
    "TrillRegions"

Input Arguments

collapse all

Labeled signal set, specified as a labeledSignalSet object.

Example: labeledSignalSet({randn(100,1) randn(10,1)},signalLabelDefinition("female")) specifies a two-member set of random signals containing the attribute "female".

Label or sublabel name. To specify a label, use a character vector or a string scalar. To specify a sublabel, use a two-element cell array of character vectors or a two-element string array:

  • The first element is the name of the parent label.

  • The second element is the name of the sublabel.

Example: signalLabelDefinition("Asleep",'LabelType','roi') specifies a label of name "Asleep" for a region of a signal in which a patient is asleep during a clinical trial.

Example: {'Asleep' 'REM'} or ["Asleep" "REM"] specifies a region of a signal in which a patient undergoes REM sleep.

Version History

Introduced in R2018b