editLabelDefinition

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

Описание

пример

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
    "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 ('розетка')) задает набор 2D члена случайных сигналов, содержащих атрибут 'female'.

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

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

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

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

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

Имя свойства в виде 'Name', 'DefaultValue'ТегОписание, или 'Categories'.

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

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

Введенный в R2018b