このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
setLabelValue
ラベル付き信号セットのラベル値の設定
構文
説明
例
ラベル値の設定
クジラの歌の録音を含むラベル付き信号セットを読み込みます。
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.
各メンバーの最大値に対応する新しいラベルを信号セットに追加します。
theMax = signalLabelDefinition('Maximum', ... 'LabelDataType','numeric', ... 'Description','Maximum value of the signal'); addLabelDefinitions(lss,theMax)
各ラベル付き信号について、新しいラベルの値を信号の最大値に設定します。信号とその最大値をプロットします。
fs = lss.SampleRate; for k = 1:lss.NumMembers sg = getSignal(lss,k); [mx,ix] = max(sg); setLabelValue(lss,k,'Maximum',mx) subplot(2,1,k) plot((0:length(sg)-1)/fs,sg,ix/fs,mx,'*') end
セット内のラベルの名前と値を表示します。
lbldefs = getLabelValues(lss)
lbldefs=2×4 table
WhaleType MoanRegions TrillRegions Maximum
_________ ___________ ____________ __________
Member{1} blue {3x2 table} {1x3 table} {[0.2850]}
Member{2} blue {3x2 table} {1x3 table} {[0.3791]}
信号の最大値は、属性として表すよりも点ラベルとして表す方が良いと判断します。数値の定義を削除し、最大値を再定義します。
removeLabelDefinition(lss,'Maximum') theMax = signalLabelDefinition('Maximum', ... 'LabelType','point','LabelDataType','numeric', ... 'Description','Maximum value of the signal'); addLabelDefinitions(lss,theMax)
各ラベル付き信号について、新しいラベルの値を信号の最大値に設定します。
for k = 1:lss.NumMembers sg = getSignal(lss,k); [mx,ix] = max(sg); setLabelValue(lss,k,'Maximum',ix/fs,mx) end
信号とその最大値をプロットします。
for k = 1:lss.NumMembers subplot(2,1,k) sg = getSignal(lss,k); peaks = getLabelValues(lss,k,'Maximum'); plot((0:length(sg)-1)/fs,sg, ... peaks.Location,cell2mat(peaks.Value),'*') end
入力引数
lss
— ラベル付き信号セット
labeledSignalSet
オブジェクト
ラベル付き信号セット。labeledSignalSet
オブジェクトとして指定します。
例:
は、属性 labeledSignalSet
({randn(100,1) randn(10,1)},signalLabelDefinition('female'))'female'
を含むランダム信号の 2 つのメンバーのセットを指定します。
midx
— メンバーの行番号
正の整数
メンバーの行番号。正の整数で指定します。midx
は、メンバーの行番号をラベル付き信号セットのLabelsテーブルに表示される行番号として指定します。
lblname
— ラベルまたはサブラベル名
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列
ラベル名。文字ベクトルまたは string スカラーとして指定します。
ラベルまたはサブラベル名。ラベルを指定するには、文字ベクトルまたは string スカラーを使用します。サブラベルを指定するには、文字ベクトルの 2 要素 cell 配列または 2 要素 string 配列を使用します。
最初の要素は親ラベルの名前です。
2 番目の要素はサブラベルの名前です。
ROI ラベルまたは点ラベルのサブラベルを対象にする場合は、ラベルを設定する親ラベルの 'LabelRowIndex'
も指定しなければなりません。サブラベル値を設定するには、親の行が既に存在していなければなりません。
例:
は、臨床試験中に患者が睡眠状態であった信号の領域用に、signalLabelDefinition
("Asleep",'LabelType','roi')"Asleep"
という名前のラベルを指定します。
例: {'Asleep' 'REM'}
または ["Asleep" "REM"]
は、患者がレム睡眠状態である信号の領域を指定します。
val
— ラベル値
数値または数値配列 | logical 値または logical 配列 | categorical 値または categorical 配列 | 文字ベクトルまたは文字ベクトルの cell 配列 | string または string 配列 | table または table 配列 | timetable または timetable 配列
ラベル値。数値、logical 値、categorical 値、string、table、または timetable として指定します。val
は、任意の前述の型の配列にすることもできます。val
は、lblname
に指定したデータ型でなければなりません。
locs
を指定する場合は、locs
と同じ数の要素をval
が持たなければなりません。limits
を指定する場合は、limits
の行数と同じ数の要素をval
が持たなければなりません。limits
に複数の行があり、lblname
の型が'numeric'
または'logical'
の場合、val
はベクトルまたは cell 配列でなければなりません。limits
に複数の行があり、lblname
の型が'string'
または'categorical'
の場合、val
は string 配列または文字ベクトルの cell 配列でなければなりません。limits
に複数の行があり、lblname
の型が'table'
または'timetable'
の場合、val
は table または timetable の cell 配列でなければなりません。
非スカラーのラベル値の代入
非スカラーのラベル値を複数の関心点または関心領域に割り当てるには、cell 配列を使用しなければなりません。たとえば、次のラベル付き信号セットが与えられたとします。
lss = labeledSignalSet(randn(10,1), [... signalLabelDefinition('pl','LabelType','point', ... 'LabelDataType','numeric') ... signalLabelDefinition('rl','LabelType','ROI', ... 'LabelDataType','numeric')]);
setLabelValue(lss,1,'pl',5,{[3 4]'}) setLabelValue(lss,1,'rl',[2 3; 8 9],{[2 1]' [6 7]})
5
に列ベクトル [3 4]'
、2
から 3
の範囲の領域に列ベクトル [2 1]'
、8
から 9
の範囲の領域に行ベクトル [6 7]
のラベルを付けます。
limits
— 領域の範囲
2 列の行列
領域の範囲。2 列の行列として指定します。
lss
に時間情報がない場合は、limits
が領域の定義に使用される最小インデックスと最大インデックスを定義します。lss
に時間情報がある場合は、limits
が領域の定義に使用される最小時点と最大時点を定義します。
limits
は、lblname
のラベル定義のROILimitsDataTypeプロパティによって指定されたデータ型でなければなりません。
例: seconds([0:3;1:4]')
例: [0:3;1:4]'
locs
— 点の位置
ベクトル
点の位置。ベクトルとして指定します。
lss
に時間情報がない場合は、locs
が点の位置に対応するインデックスを定義します。lss
に時間情報がある場合は、locs
が点の位置に対応する時点を定義します。
locs
は、lblname
のラベル定義のPointLocationsDataTypeプロパティによって指定されたデータ型でなければなりません。
ridx
— ラベルの行インデックス
正の整数
ラベルの行インデックス。正の整数で指定します。この引数は、ROI と点のラベルにのみ適用されます。
sridx
— サブラベルの行インデックス
正の整数
サブラベルの行インデックス。正の整数で指定します。この引数は、lblname
でラベルとサブラベルのペアが指定されていて、サブラベルのタイプが ROI または点である場合にのみ適用されます。
バージョン履歴
R2018b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)