editLabelDefinition

Отредактируйте свойства определения метки

Синтаксис

editLabelDefinition(lss,lblname,propname,val)

Описание

пример

editLabelDefinition(lss,lblname,propname,val) изменяет свойство propname определения метки или подметки lblname к val.

Функция может отредактировать только Имя, DefaultValue, Тег, Описание и свойства Categories. Чтобы изменить любое другое свойство определения метки, удалите определение с помощью removeLabelDefinition и добавьте определение с желаемыми значениями свойств с помощью addLabelDefinitions.

  • Если вы редактируете свойство DefaultValue, все существующие значения метки остаются неизменными. Новое значение по умолчанию применяется только к новым участникам, новым областям или новым точкам.

  • Можно отредактировать свойство Categories только, когда LabelDataType целевой метки или подмаркируют определение, 'Categorical'.

Новые заданные категории не заменяют существующих категорий. Они добавлены к существующим значениям.

Примеры

свернуть все

Загрузите маркированный набор сигнала, содержащий записи песен кита. Получите имена меток.

load whales
lss
lss = 
  labeledSignalSet with properties:

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

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

getLabelNames(lss)
ans = 3x1 string array
    "WhaleType"
    "MoanRegions"
    "TrillRegions"

Первая метка соответствует типу кита. Получите типы, доступные в наборе.

lbldefs = getLabelDefinitions(lss);
types = lbldefs(1)
types = 
  signalLabelDefinition with properties:

             Name: "WhaleType"
        LabelType: "attribute"
    LabelDataType: "categorical"
       Categories: [3x1 string]
     DefaultValue: []
        Sublabels: [0x0 signalLabelDefinition]
              Tag: ""
      Description: "Whale type"

 Use labeledSignalSet to create a labeled signal set.
types = types.Categories
types = 3x1 string array
    "blue"
    "humpback"
    "white"

Измените метку, чтобы включить кашалотов и косаток. Проверьте, что маркированный набор сигнала включает два новых типа кита.

editLabelDefinition(lss,'WhaleType', ...
    'Categories',{'sperm','killer'})

lbldefs = getLabelDefinitions(lss);
types = lbldefs(1).Categories
types = 5x1 string array
    "blue"
    "humpback"
    "white"
    "sperm"
    "killer"

Определение для областей трели имеет подметку, которая идентифицирует peaks.

lbldefs(3).Sublabels
ans = 
  signalLabelDefinition with properties:

                      Name: "TrillPeaks"
                 LabelType: "point"
             LabelDataType: "numeric"
        ValidationFunction: []
    PointLocationsDataType: "double"
              DefaultValue: []
                 Sublabels: [0x0 signalLabelDefinition]
                       Tag: ""
               Description: "Trill peaks"

 Use labeledSignalSet to create a labeled signal set.

Измените описание подметки.

editLabelDefinition(lss,["TrillRegions" "TrillPeaks"],'Description','Peaks of trill regions')

lbldefs = getLabelDefinitions(lss);
lbldefs(3).Sublabels
ans = 
  signalLabelDefinition with properties:

                      Name: "TrillPeaks"
                 LabelType: "point"
             LabelDataType: "numeric"
        ValidationFunction: []
    PointLocationsDataType: "double"
              DefaultValue: []
                 Sublabels: [0x0 signalLabelDefinition]
                       Tag: ""
               Description: "Peaks of trill regions"

 Use labeledSignalSet to create a labeled signal set.

Входные параметры

свернуть все

Маркированный набор сигнала, заданный как объект labeledSignalSet.

Пример: labeledSignalSet({randn(100,1) randn(10,1)},signalLabelDefinition('female')) задает 2D членский набор случайных сигналов, содержащих атрибут 'female'.

Маркируйте или подмаркируйте имя. Чтобы задать метку, используйте вектор символов или скаляр строки. Чтобы задать подметку, используйте двухэлементный массив ячеек из символьных векторов или двухэлементный массив строк:

  • Первый элемент является именем родительской метки.

  • Второй элемент является именем подметки.

Пример: signalLabelDefinition("Asleep",'LabelType','roi') задает метку имени "Asleep" для области сигнала, в котором пациент спит во время клинического испытания.

Пример: {'Asleep' 'REM'} или ["Asleep" "REM"] задают область сигнала, в котором пациент подвергается быстрому сну.

Имя свойства, заданное как 'Name', 'DefaultValue', 'Tag', 'Description' или 'Categories'.

Типы данных: char | string

Маркируйте значения, заданные как числовое или логическое значение, вектор символов или строка, вектор строк или массив ячеек из символьных векторов. val должен иметь тип данных, заданный для propname.

Введенный в R2018b