グラフ API
import先はnmrlink/graphsです。描画は生データ・解析結果を変更しません。
このページの内容
NMRGraphs
ブラウザ用の表示クラスです。fid・fftには描画先のDOM要素を必ず渡します。peak・statusは任意のテキスト表示先です。
| option | 既定値 | 意味 |
|---|---|---|
| fid / fft | 必須 | FID / FFTを入れるDOM要素 |
| peak / status | null | 最大ピーク / 解析条件のテキスト要素 |
| displayEndMs | 10 | FID表示の終了時刻 [ms] |
| frequencyLimitHz | 10000 | FFT表示の±範囲 [Hz]。軸はkHz |
| colors | {} | data1・data2・fftのCSS色 |
| locale / labels | ja / {} | 表示言語 / 文字列の部分上書き |
const graphs = new NMRGraphs({ fid: fidElement, fft: fftElement, locale: "ja" });
graphs.show(record, analyzeMeasurement(record));
// 画面を取り除くとき:graphs.dispose();show(record, analysis)はSVGを描画します。analysis省略時は既定のanalyzeMeasurementを使います。表示は高さ280 pxで横幅に追従し、再描画時に再測定・再解析しません。clear()は記録参照と表示を消し、dispose()は幅の監視も解除します。
解析引数の計算が失敗した場合は直前の表示を保持しますが、show内部の描画失敗は表示をclearして例外を投げます。入力の検証・解析を先に完了してからshowへ渡してください。
createRecordPlots(record, options)
DOMを使わず{ fid, fft, spectrum, peak }を返します。fid・fftはSVG文字列です。width=720(160以上)と、NMRGraphsと同じdisplayEndMs・frequencyLimitHz・colors・locale・labelsを受け取ります。analysisは既定解析、idPrefixは自動生成です。手動のidPrefixを同じページ内で重複させないでください。
走査曲線のSVG
| 関数 | 必要な点の値 | 追加optionと横軸 |
|---|---|---|
| createFrequencyPlot(points, options) | frequencyHz、非負のamplitude | 設定周波数 [kHz] |
| createPulsePlot(points, options) | length、amplitude(符号付き) | fit=null、mode=signed / magnitude。横軸はRF周期数 |
| createT1Plot(points, options) | tau、signal(符号付き) | fit=null、mode=signed / magnitude / quadrature。横軸τ [ms] |
| createT2Plot(points, options) | 正のtau、非負のsignal | fit=null。横軸2τ [ms] |
全関数がwidth=720・locale=ja・labels=を受け取り、SVG文字列を返します。高さ280 px、幅の下限160 pxです。magnitude・quadrature表示には同名の点フィールドが必要です。T1の近似はsigned表示だけに描きます。パルス・T1・T2の横軸は0始まりですが、0の測定点は追加しません。幅への追従は呼び出し元で行います。
fitにはfitPulseCalibration・fitT1 / fitT2の結果を渡します。パルスのmagnitude表示には絶対値用の近似を渡してください。曲線関数にはcolorsオプションはありません。
locale・labels・colors
localeはja(既定)またはen。NMRGraphs / createRecordPlotsのlabelsはfid・fftの下にtitle・xLabel・yLabelを指定します。曲線4関数はlabels直下に同じ3項目を指定します。省略した文字列は既定値、空文字列は表示なしです。titleはSVGのtitleとaria-labelに使います。
const graphs = new NMRGraphs({
fid: fidElement, fft: fftElement, locale: "en",
labels: { fid: { xLabel: "Time [ms]" }, fft: { yLabel: "Amplitude [a.u.]" } },
colors: { data1: "#176caa", data2: "#b34e25", fft: "#7c3aed" },
});NMRGraphsではfid.empty・fft.emptyと、peak.empty・peak.none・peak.outside・peak.value、statusも上書きできます。peak.valueの差し込み名はhz / outside、statusはtailPoints / displayEndMs / startMs / endMs / window / frequencyLimitKHzです。HTMLは解釈せずエスケープします。不明なキー・差し込み名・locale、文字列以外はTypeErrorです。言語変更時はビューを作り直します。
colorsの既定値はdata1とfftが#176caa、data2が#b34e25です。帯と軸の色は変更しません。ラベル変更だけでは単位換算は行いません。
表示例とコピー用コード · PNG保存 · API一覧