getLabelValues

R2026b

ラベル付き信号セットからのラベル値の取得

ページ内をすべて折りたたむ

構文

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

説明

val = getLabelValues(lss) は、ラベル付き信号セット lss のすべてのメンバーのラベル値を含む table を返します。

例

val = getLabelValues(lss,midx) は、midx によって指定されたメンバーのラベル値を含む table を返します。

[val,sublbltbl] = getLabelValues(lss,midx,lblName) は、lblName という名前のラベルの値を返します。lblName にサブラベルがある場合は、table sublbltbl にラベル値とそのサブラベル変数の構造体が表示されます。

[___] = getLabelValues(___,'LabelRowIndex',ridx) は、値を取得する ROI ラベルまたは点ラベルの行インデックス (ridx) を指定します。

[___] = getLabelValues(___,'SublabelRowIndex',sridx) は、値を取得する ROI サブラベルまたは点サブラベルの行インデックス (sridx) を指定します。

例

すべて折りたたむ

ライブ スクリプトを開く

クジラの歌の録音を含むラベル付き信号セットを読み込みます。

load whales
lss
lss = 
  labeledSignalSet with properties:

             Source: {2×1 cell}
         NumMembers: 2
    TimeInformation: "sampleRate"
         SampleRate: 4000
             Labels: [2×3 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       {3×2 table}    {1×3 table} 
    Member{2}      blue       {3×2 table}    {1×3 table}

セットの 2 番目の信号の、うめき声の 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 範囲の間にプロットします。ラベル付きのふるえ声のピークを表示します。

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 object. The axes object contains 2 objects of type line. One or more of the lines displays its values using only markers

3 番目のふるえ声のピークの座標を表示します。

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" を含むランダム信号の 2 つのメンバーのセットを指定します。

メンバーの行番号。正の整数で指定します。midx は、メンバーの行番号をラベル付き信号セットのLabelsテーブルに表示される行番号として指定します。

ラベルまたはサブラベル名。ラベルを指定するには、文字ベクトルまたは string スカラーを使用します。サブラベルを指定するには、文字ベクトルの 2 要素 cell 配列または 2 要素 string 配列を使用します。

  • 最初の要素は親ラベルの名前です。

  • 2 番目の要素はサブラベルの名前です。

例: signalLabelDefinition("Asleep",'LabelType','roi') は、臨床試験中に患者が睡眠状態であった信号の領域用に、"Asleep" という名前のラベルを指定します。

例: {'Asleep' 'REM'} または ["Asleep" "REM"] は、患者がレム睡眠状態である信号の領域を指定します。

ラベルの行インデックス。正の整数で指定します。この引数は、点ラベル、ROI ラベル、および時間-周波数 ROI ラベルにのみ適用されます。

サブラベルの行インデックス。正の整数で指定します。この引数は、lblname でラベルとサブラベルのペアが指定されていて、サブラベルのタイプが ROI または点である場合にのみ適用されます。

出力引数

すべて折りたたむ

ラベル値。table として返されます。

サブラベル値。ラベル値とそのサブラベル変数の構造体を表示する table として返されます。

  • lblName にサブラベルがない場合、sublbltbl は空になります。

  • lblName を string または cell 配列として指定した場合、sublbltbl は空になります。

バージョン履歴

R2018b で導入

すべて展開する

参考

| |