getLabelValues

Получите значения метки от маркированного набора сигнала

Синтаксис

val = getLabelValues(lss)
val = getLabelValues(lss,midx)
[val,sublbltbl] = getLabelValues(lss,midx,lblname)
[___] = getLabelValues(___,'LabelRowIndex',ridx)
[___] = getLabelValues(___,'SublabelRowIndex',sridx)

Описание

пример

val = getLabelValues(lss) возвращается таблица, содержащая значения метки для всех членов маркированного сигнала, установила lss.

val = getLabelValues(lss,midx) возвращает таблицу, содержащую значения метки для участника, заданного midx.

[val,sublbltbl] = getLabelValues(lss,midx,lblname) возвращает значение метки под названием lblname. Если lblname имеет подметки, то таблица sublbltbl показывает структуру значения метки и его переменных подметки.

[___] = getLabelValues(___,'LabelRowIndex',ridx) задает индекс строки, ridx, ROI или метки точки, значение которой вы хотите получить.

[___] = getLabelValues(___,'SublabelRowIndex',sridx) задает индекс строки, sridx, ROI или подметки точки, значение которой вы хотите получить.

Примеры

свернуть все

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

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.

Получите значения меток.

lbls = getLabelValues(lss)
lbls=2×3 table
                 WhaleType    MoanRegions    TrillRegions
                 _________    ___________    ____________

    Member{1}      blue       [3x2 table]    [1x3 table] 
    Member{2}      blue       [3x2 table]    [1x3 table] 

Отобразите пределы ROI стона для второго сигнала набора.

lbb = getLabelValues(lss,2,'MoanRegions')
lbb=3×2 table
     ROILimits      Value
    ____________    _____

     2.5     3.5     [1] 
     5.8       8     [1] 
    15.4    16.7     [1] 

Постройте область трели сигнала между пределами ROI. Отобразите маркированный peaks трели.

tvals = getLabelValues(lss,2,'TrillRegions');
peaks = getLabelValues(lss,2,{'TrillRegions','TrillPeaks'});

sg = getSignal(lss,2);
plot((0:length(sg)-1)/lss.SampleRate,sg)
xlim(tvals.ROILimits)
hold on
plot(peaks.Location,cell2mat(peaks.Value),'v')
hold off

Отобразите координаты третьего пика трели.

pcoor = getLabelValues(lss,2,{'TrillRegions','TrillPeaks'}, ...
    'LabelRowIndex',1,'SublabelRowIndex',3)
pcoor=1×2 table
    Location     Value  
    ________    ________

     11.437     [0.1500]

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

свернуть все

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

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

Номер строки, заданный как положительное целое число. midx задает номер строки, как это появляется в таблице Labels маркированного набора сигнала.

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

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

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

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

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

Маркируйте индекс строки, заданный как положительное целое число. Этот аргумент применяется только для меток точки и ROI.

Подмаркируйте индекс строки, заданный как положительное целое число. Этот аргумент применяется только, когда пара метки и подметки была задана в lblname, и подметка имеет ROI типа или точку.

Выходные аргументы

свернуть все

Маркируйте значения, возвращенные как таблица.

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

  • Если lblname не имеет никаких подметок, то sublbltbl пуст.

  • Если вы задаете lblname как массив строк или массив ячеек, то sublbltbl пуст.

Введенный в R2018b

Для просмотра документации необходимо авторизоваться на сайте