editLabelDefinition

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

Описание

пример

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

Функция может редактировать только имена, DefaultValue, Tag, Description и 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
    "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
    "blue"
    "humpback"
    "white"

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

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

lbldefs = getLabelDefinitions(lss);
types = lbldefs(1).Categories
types = 5x1 string
    "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')) задает набор случайных сигналов с двумя членами, содержащий атрибут 'female'.

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

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

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

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

Пример: {'Asleep' 'REM'} или ["Asleep" "REM"] задает область сигнала, в которой пациент проходит РЕМ сон.

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

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

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

Введенный в R2018b