setLabelValue
ラベル付き信号セットのラベル値の設定
構文
説明
setLabelValue(___,'LabelRowIndex', は、ROI ラベルまたは点ラベルの行インデックス (ridx)ridx) を指定します。指定された値により、その行の現在の値が置き換えられます。この引数を省略した場合、この関数は既存のラベル値に ROI または点の値を追加します。
setLabelValue(___,'SublabelRowIndex', は、ROI サブラベルまたは点サブラベルの行インデックス (sridx)sridx) を指定します。指定された値により、そのサブラベルの行の現在の値が置き換えられます。
例
クジラの歌の録音を含むラベル付き信号セットを読み込みます。
load whales
lsslss =
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.
各メンバーの最大値に対応する新しいラベルを信号セットに追加します。
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 {3×2 table} {1×3 table} {[0.2850]}
Member{2} blue {3×2 table} {1×3 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
R2025a 以降
時間-周波数関心領域 (ROI) ラベルの定義、およびスペクトログラム オプションを使用して、時間-周波数領域でガウス原子にラベルを付けます。
信号の生成とスペクトログラムの可視化
電圧制御発振器と 4 つのガウス原子で構成される信号を生成します。この信号は 14 kHz で 2 秒間サンプリングされます。信号のスペクトログラムをプロットします。
Fs = 14000; t = (0:1/Fs:2)'; st = 0.01; gaussFun = @(A,x,mu,f) exp(-(x-mu).^2/(2*st^2)).*sin(2*pi*f.*x)*A'; atomTimeCenters = [0.2 0.5 1 1.75]; atomFreqCenters = [2 6 2 5]*1000; s = gaussFun([1 1 1 1]/10,t,atomTimeCenters,atomFreqCenters); x = vco(chirp(t+.1,0,t(end),3).*exp(-2*(t-1).^2),[0.1 0.4]*Fs,Fs); s = s/10+x; bt = 0.2; tr = 0.05; op = 99; pspectrum(s,Fs,"spectrogram", ... Leakage=bt,TimeResolution=tr,OverlapPercent=op)
このスペクトログラムには、ガウス原子に対応する時間-周波数領域の 4 つのパッチが表示されます。すべての原子の時間と周波数を定義します。
atomTimes = atomTimeCenters'+[-st st]*5.5; atomFreqs = atomFreqCenters'+[-1 1]*200;
時間-周波数領域における信号へのラベル付け
ガウス原子にラベルを付けるため、logical の時間-周波数 ROI ラベルの定義を作成します。漏れ特性をもつスペクトログラム オプションを指定します。
opts = labelSpectrogramOptions("leakage", ... Leakage=40*(1-bt),Overlap=op, ... TimeResolutionMode="specify",TimeResolution=tr); lblDef = signalLabelDefinition("Atom", ... LabelDataType="logical", ... LabelType="roiTimeFrequency",TimeFrequencyOptions=opts);
信号と時間-周波数 ROI ラベルの定義からラベル付き信号セットを作成します。
lss = labeledSignalSet(s,lblDef,SampleRate=Fs);
時間-周波数領域で 4 つの原子にラベルを付けます。ラベルの値を true に設定します。
setLabelValue(lss,1,"Atom",atomTimes,atomFreqs,true(1,4))時間-周波数イメージとラベル マスクの可視化
時間-周波数 ROI ラベルのラベル付き信号セットからデータストアを作成します。
imSize = [512 768]; [sds,ads] = createDatastores(lss,"Atom", ... TimeFrequencyMapFormat="image", ... TimeFrequencyImageSize=imSize, ... TimeFrequencyLabelFormat="mask", ... TimeFrequencyMaskPriority=true);
時間-周波数イメージを読み取って表示します。
imagesc(read(sds))
ラベル マスクを読み取り、時間-周波数イメージの上に表示します。
lbl = read(ads);
im = zeros([imSize 3]);
im(:,:,1) = lbl{1};
hold on
imagesc(im,AlphaData=0.5*lbl{1})
hold off
