信号解析 API
import先はnmrlinkです。すべて同期関数で、入力の生データを変更しません。計算の規約は解析の仕様を参照してください。
analyzeMeasurement(record, options)
ベースライン補正→複素FFT→全周波数の最大振幅ビンをまとめて計算します。record.rawとrecord.sampleIntervalMsを使います。
| option | 既定値 | 意味 |
|---|---|---|
| startMs / endMs | 1 / 5 | FFT範囲 [ms]、開始を含み終了を含まない |
| tailPoints | 100 | ベースラインに使う末尾の点数 |
| truncate | true | 差し引き後の値を0方向へ整数化 |
| window | hann | hann / 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] |
| startMs | 0 | 開始時刻 [ms]、開始を含む |
| endMs | data.length × sampleIntervalMs | 終了時刻 [ms]、終了を含まない |
| window | hann | hann:対称Hann窓、rect:矩形窓 |
dataはベースライン補正済みの2チャンネル配列です。この関数自体は補正しません。範囲内の4点以上を使い、次の2のべき乗までゼロ埋めします。FFTサイズの上限はです。データ範囲外や不正な窓、非有限数値は例外です。
| 戻り値のフィールド | 内容 |
|---|---|
| bins | 周波数昇順の全FFTビン。各binはhz・real・imaginary・amplitude・phaseRadians |
| startMs / endMs | 要求した範囲 |
| first / last | サンプル添字の開始・終了(終了排他) |
| actualStartMs / actualEndExclusiveMs | 実際に使用した時刻範囲 [ms] |
| count / size | 選択した点数 / ゼロ埋め後のFFT点数 |
| durationMs | count × sampleIntervalMs |
| spacingHz / resolutionHz | FFTビン間隔 / 観測時間によるの目安 |
| window / convention | 窓名 / Data 1 + i Data 2 |
hzは受信基準からの差[Hz]、phaseRadiansは選択範囲の先頭を時間原点とする位相[rad]です。amplitudeは窓の重み合計で正規化した複素振幅の絶対値です。