exponenta event banner

editLabelDefinition

Изменение свойств определения метки

Описание

пример

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

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

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

  • Изменить свойство 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"

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

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"] задает область сигнала, в которой пациент подвергается REM-сну.

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

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

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

Представлен в R2018b