本文へ移動

信号解析 API

import先はnmrlinkです。すべて同期関数で、入力の生データを変更しません。計算の規約は解析の仕様を参照してください。

analyzeMeasurement(record, options)

ベースライン補正→複素FFT→全周波数の最大振幅ビンをまとめて計算します。record.rawとrecord.sampleIntervalMsを使います。

option既定値意味
startMs / endMs1 / 5FFT範囲 [ms]、開始を含み終了を含まない
tailPoints100ベースラインに使う末尾の点数
truncatetrue差し引き後の値を0方向へ整数化
windowhannhann / rect
js
const { data, baseline, spectrum, peak } = analyzeMeasurement(record, {
  startMs: 1, endMs: 5, tailPoints: 100, truncate: true, window: "hann",
});

dataは補正後の配列、baselineはcorrectBaselineの戻り値、spectrumはcomputeSpectrumの戻り値、peakは振幅最大のbinです。同振幅なら周波数の昇順で先のbinを選び、全ゼロでもamplitude:0のbinを返します。表示範囲でピーク探索を制限しません。

correctBaseline(raw, options)

rawは有限数値2つの配列の配列です。tailPoints=100・truncate=trueが既定です。tailPointsは1〜raw.lengthの整数、truncateはbooleanです。

戻り値は{ base, data, tailPoints, truncate }。baseは各チャンネルの末尾平均、dataは新しい補正後配列です。2048点に限定しません。不完全なチャンネル対、非有限数値、不正な点数、演算のオーバーフローは例外です。

computeSpectrum(data, options)

option既定値意味
sampleIntervalMs必須正の有限数値、サンプル間隔 [ms]
startMs0開始時刻 [ms]、開始を含む
endMsdata.length × sampleIntervalMs終了時刻 [ms]、終了を含まない
windowhannhann:対称Hann窓、rect:矩形窓

dataはベースライン補正済みの2チャンネル配列です。この関数自体は補正しません。範囲内の4点以上を使い、次の2のべき乗までゼロ埋めします。FFTサイズの上限は2202^{20}です。データ範囲外や不正な窓、非有限数値は例外です。

戻り値のフィールド内容
bins周波数昇順の全FFTビン。各binはhz・real・imaginary・amplitude・phaseRadians
startMs / endMs要求した範囲
first / lastサンプル添字の開始・終了(終了排他)
actualStartMs / actualEndExclusiveMs実際に使用した時刻範囲 [ms]
count / size選択した点数 / ゼロ埋め後のFFT点数
durationMscount × sampleIntervalMs
spacingHz / resolutionHzFFTビン間隔 / 観測時間による1/T1/Tの目安
window / convention窓名 / Data 1 + i Data 2

hzは受信基準からの差[Hz]、phaseRadiansは選択範囲の先頭を時間原点とする位相[rad]です。amplitudeは窓の重み合計で正規化した複素振幅の絶対値です。

使い方:信号を解析する · API一覧