removeRegionValue

ROI ラベルまたは時間-周波数 ROI ラベルからの行の削除

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

構文

removeRegionValue(lss,midx,lblName)
removeRegionValue(lss,midx,lblName,LabelRowIndex=ridx)
removeRegionValue(lss,midx,lblName,SublabelRowIndex=sridx)
removeRegionValue(lss,midx,lblName,LabelRowIndex=ridx,SublabelRowIndex=sridx)

説明

removeRegionValue(lss,midx,lblName) は、midx によって指定されたメンバーの ROI ラベルまたは時間-周波数 ROI ラベル lblName のすべての行を削除します。

  • lblName が文字ベクトルまたは string スカラーの場合、この関数は親ラベルを対象にします。

  • lblName が 2 要素 string 配列または文字ベクトルの 2 要素 cell 配列の場合、この関数は次のように機能します。

    • 最初の要素を親ラベルの名前として解釈します。

    • 2 番目の要素を ROI ラベルのサブラベル名として解釈します。

    • サブラベルのすべての領域を削除します。

removeRegionValue(lss,midx,lblName,LabelRowIndex=ridx) は、ridx によって指定された、メンバー midx の ROI ラベルまたは時間-周波数 ROI ラベル lblName の行を削除します。

lblName が 2 要素 string 配列または文字ベクトルの 2 要素 cell 配列の場合、この関数は次のように機能します。

  • 最初の要素を親ラベルの名前として解釈します。

  • 2 番目の要素を ROI ラベルのサブラベル名として解釈します。

  • 行 ridx に含まれる、サブラベルのすべての領域を削除します。

例

removeRegionValue(lss,midx,lblName,SublabelRowIndex=sridx) は、sridx によって指定されたサブラベルの行を削除します。この場合、lblName は 2 要素 string 配列または文字ベクトルの 2 要素 cell 配列にしなければなりません。

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

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

removeRegionValue(lss,midx,lblName,LabelRowIndex=ridx,SublabelRowIndex=sridx) は、ridx によって指定された ROI ラベルまたは点ラベルの行の、sridx によって指定されたサブラベルの行を削除します。この場合、lblName は 2 要素 string 配列または文字ベクトルの 2 要素 cell 配列にしなければなりません。

  • 最初の要素は、親の ROI ラベルまたは点ラベルの名前です。

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

例

すべて折りたたむ

ライブ スクリプトを開く

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

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.

セット内のラベルの名前と値を取得します。次の例では、セットの 2 番目のメンバーに焦点を当てます。

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

    Member{1}      blue       {3×2 table}    {1×3 table} 
    Member{2}      blue       {3×2 table}    {1×3 table} 


idx = 2;

うめき声とふるえ声の領域を取得します。signalMask (Signal Processing Toolbox)オブジェクトを使用して信号をプロットし、うめき声とふるえ声を強調表示します。

mvals = getLabelValues(lss,idx,"MoanRegions");
tvals = getLabelValues(lss,idx,"TrillRegions");

tb = [mvals;tvals];
tb.Value = categorical( ...
    [repmat("moan",height(mvals),1); ...
    repmat("trill",height(tvals),1)], ...
    ["moan" "trill"]);

sm = signalMask(tb,SampleRate=lss.SampleRate);

plotsigroi(sm,getSignal(lss,idx))

Figure contains an axes object. The axes object with xlabel Seconds contains 3 objects of type line.

ラベルから 2 番目のうめき声を削除します。信号を再度プロットします。うめき声とふるえ声を強調表示します。

removeRegionValue(lss,idx,"MoanRegions",LabelRowIndex=2)

mvals = getLabelValues(lss,idx,"MoanRegions");

tb = [mvals;tvals];
tb.Value = categorical([repmat("moan",height(mvals),1); ...
    repmat("trill",height(tvals),1)],["moan" "trill"]);

sm = signalMask(tb,SampleRate=lss.SampleRate);

plotsigroi(sm,getSignal(lss,idx))

Figure contains an axes object. The axes object with xlabel Seconds contains 3 objects of type line.

入力引数

すべて折りたたむ

ラベル付き信号セット。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 または点である場合にのみ適用されます。

バージョン履歴

R2018b で導入

すべて展開する

参考

|