このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

removePointValue

点ラベルからの行の削除

構文

removePointValue(lss,midx,lblname)

removePointValue(lss,midx,lblname,'LabelRowIndex',ridx)

removePointValue(lss,midx,lblname,'SublabelRowIndex',sridx)

removePointValue(lss,midx,lblname,'LabelRowIndex',ridx,'SublabelRowIndex',sridx)

説明

removePointValue(lss,midx,lblname) は、midx によって指定されたメンバーの点ラベル lblname のすべての行を削除します。

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

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

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

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

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

removePointValue(lss,midx,lblname,'LabelRowIndex',ridx) は、ridx によって指定された、メンバー midx の点ラベル lblname の行を削除します。

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

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

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

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

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

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

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

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

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

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

例

点の値の削除

クジラの歌の録音を含むラベル付き信号セットを読み込みます。ラベルの名前とメンバー数を取得します。

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.

nm = lss.NumMembers;

信号の最大値に関連付けられた点ラベルを定義します。

themax = signalLabelDefinition('Maximum','LabelType','point', ...
    'LabelDataType','numeric')

themax = 
  signalLabelDefinition with properties:

                      Name: "Maximum"
                 LabelType: "point"
             LabelDataType: "numeric"
        ValidationFunction: []
    PointLocationsDataType: "double"
              DefaultValue: []
                 Sublabels: [0x0 signalLabelDefinition]
                       Tag: ""
               Description: ""

 Use labeledSignalSet to create a labeled signal set.

addLabelDefinitions(lss,themax)

信号の最大値を見つけて、その値をラベル付きセットに追加します。

figure
for idx = 1:nm
    sg = getSignal(lss,idx);
    [mx,ix] = max(sg);
    setLabelValue(lss,idx,'Maximum',ix,mx)
    
    subplot(nm,1,idx)
    plot((0:length(sg)-1)/lss.SampleRate,sg,ix/lss.SampleRate,mx,'*')
end

セットに新しい点ラベルが含まれていることを確認します。

getLabelValues(lss)

ans=2×4 table
                 WhaleType    MoanRegions    TrillRegions      Maximum  
                 _________    ___________    ____________    ___________

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

セットの最初のメンバーの 'Maximum' 値を削除します。最初のメンバーのラベルが空であることを確認します。

removePointValue(lss,1,'Maximum')

getLabelValues(lss,1)

ans=1×4 table
                 WhaleType    MoanRegions    TrillRegions      Maximum  
                 _________    ___________    ____________    ___________

    Member{1}      blue       {3x2 table}    {1x3 table}     {0x2 table}

入力引数

lss — ラベル付き信号セット

labeledSignalSet オブジェクト

ラベル付き信号セット。labeledSignalSet オブジェクトとして指定します。

例: labeledSignalSet({randn(100,1) randn(10,1)},signalLabelDefinition('female')) は、属性 'female' を含むランダム信号の 2 つのメンバーのセットを指定します。

midx — メンバーの行番号

正の整数

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

lblname — ラベルまたはサブラベル名

文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

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

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

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

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

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

ridx — ラベルの行インデックス

正の整数

ラベルの行インデックス。正の整数で指定します。この引数は、ROI と点のラベルにのみ適用されます。

sridx — サブラベルの行インデックス

正の整数

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

バージョン履歴

R2018b で導入

参考

信号ラベラー | labeledSignalSet | signalLabelDefinition