getLabelValues

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

Описание

пример

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

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

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

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

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

Примеры

свернуть все

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

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]}

Постройте график области сигнала между пределами информация только для чтения. Отображение маркированного 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

Figure contains an axes. The axes contains 2 objects of type line.

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

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

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

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

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

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

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

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

Пометьте индекс строки в виде положительного целого числа. Этот аргумент применяется только к информация только для чтения и меткам точек.

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

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

свернуть все

Пометьте значения, возвращенные как таблица.

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

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

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

Введенный в R2018b