グラフを表示する
FID・FFTはNMRGraphs、周波数調整・パルス校正・T1・T2はSVGを返す関数で表示します。このページの表示例はすべて模擬データで、実機には接続しません。
Storybookで表示を試す ↗:実機なしで言語・幅・信号の状態・FIDとFFTの線色を変更できます。Storybookのコード例は表示確認専用のReactアダプターを使っています。自作UIには、このページのコードを使ってください。
このページの内容
FIDとFFT
プレビューを準備しています…
FID・時間波形
FFT・振幅スペクトル
上の表示例も、下のコードと同じライブラリを使っています。最初のWeb UIのグラフ作成部分を、次で置き換えてください。importと結果を受け取る処理はそのまま使います。
// 最初のWeb UIのNMRGraphs作成部分を、次で置き換えます。
const graphs = new NMRGraphs({
fid: document.getElementById("fid"),
fft: document.getElementById("fft"),
displayEndMs: 10,
frequencyLimitHz: 10000,
locale: "ja",
colors: { data1: "#176caa", data2: "#b34e25", fft: "#7c3aed" },
});npmではimport先をnmrlinkとnmrlink/graphsにします。HTML例ではライブラリのソース一式を./nmrlink/に配置します。
displayEndMs:FIDの表示終了時刻[ms]。既定値10。frequencyLimitHz:FFTの表示範囲[±Hz]。既定値10000。横軸の表記はkHz。colors:data1・data2・fftのCSS色。省略した色は既定値を使います。
表示範囲を変えてもFFTの解析範囲は変わりません。FIDの薄い帯が解析範囲です。FIDの縦軸は解析範囲内の信号に合わせ、先頭などの大きな信号はクリップします。横幅はコンテナに追従し、高さは280 pxを保ちます。
graphs.show(record, analysis)に既存の解析結果を渡せば再利用できます。任意のpeak・status要素を指定すると最大ピークと解析条件も表示します。
// When replacing the displayed result:
graphs.show(record, analysis);
// To clear the graphs:
graphs.clear();
// When removing the view:
graphs.dispose();言語とラベルを変える
localeで英語のen・日本語のja(既定)を選びます。labelsは指定した文字列だけを上書きし、残りは選んだ言語の既定値を使います。titleはSVGの読み上げ用の名前にもなります。空文字列ならその文字を表示しません。単位の換算や解析条件の変更は行いません。
const graphs = new NMRGraphs({
fid: fidElement,
fft: fftElement,
locale: "en",
labels: {
fid: { title: "My FID", xLabel: "Time [ms]", yLabel: "Signal [a.u.]" },
fft: { xLabel: "Frequency offset [kHz]" },
},
});
const svg = createT1Plot(points, {
fit,
locale: "en",
labels: { title: "Inversion recovery", xLabel: "Delay τ [ms]" },
});NMRGraphsとcreateRecordPlotsでは、labels.fid・labels.fftのそれぞれにtitle・xLabel・yLabelを指定します。4種類の曲線関数はlabels直下に同じ3項目を指定します。NMRGraphsではclear()時の文言もfid.empty・fft.emptyで変えられます。
任意のpeak・status要素の文章は、次の文字列テンプレートで変えられます。省略すれば標準の翻訳を使います。HTMLは使わず、通常のテキストとして表示します。不明なキー・未対応のlocale・文字列以外の値はエラーになります。
// Pass this object as the labels option when creating NMRGraphs.
const labels = {
peak: {
empty: "No measurement",
none: "No signal",
outside: " (outside range)",
value: "Peak: {hz} Hz{outside}",
},
status: "FFT: {startMs}–{endMs} ms; {window}; baseline: {tailPoints} samples",
};peak.valueでは{hz}と{outside}を使えます。statusでは{tailPoints}・{displayEndMs}・{startMs}・{endMs}・{window}・{frequencyLimitKHz}を使えます。不明な差し込み名はエラーになります。言語はビュー作成時に指定し、切り替える場合はビューを作り直します。PNG・SVGの保存にも表示中のラベルを使います。
走査・緩和測定のグラフ
以下はそれぞれ別のHTMLファイルに貼って使える例です。同じページに並べる場合は、表示先のIDとそのセレクターを重複しない名前に変えてください。青の点は模擬データ、橙の線は近似です。実際に使うときはpointsを測定・解析結果に置き換えます。近似値は推定であり、実験の妥当性を保証するものではありません。
周波数応答
frequencyHzはHz単位、amplitudeは非負の振幅です。横軸はkHzで表示します。
<div id="curve"></div>
<script type="module">
import { createFrequencyPlot } from "./nmrlink/graphs.js";
const points = Array.from({ length: 9 }, (_, i) => {
const frequencyHz = 398000 + i * 1000;
return { frequencyHz, amplitude: 1000 * Math.exp(-(((frequencyHz - 402000) / 1800) ** 2)) };
});
const options = {};
const element = document.querySelector("#curve");
function draw() {
const width = Math.max(160, Math.floor(element.clientWidth));
element.innerHTML = createFrequencyPlot(points, { ...options, width, locale: "ja" });
}
const observer = new ResizeObserver(draw);
observer.observe(element);
draw();
// Call observer.disconnect() when removing this view.
</script>パルス応答
lengthはRFの周期数、amplitudeは符号付き信号です。任意のサイン近似を重ね、90°・180°のパルス候補を調べます。
<div id="curve"></div>
<script type="module">
import { createPulsePlot } from "./nmrlink/graphs.js";
import { fitPulseCalibration } from "./nmrlink/index.js";
const points = Array.from({ length: 16 }, (_, i) => {
const length = 5 + i * 5;
return { length, amplitude: 1000 * Math.sin(Math.PI * length / (2 * 21)) };
});
const options = { fit: fitPulseCalibration(points) };
const element = document.querySelector("#curve");
function draw() {
const width = Math.max(160, Math.floor(element.clientWidth));
element.innerHTML = createPulsePlot(points, { ...options, width, locale: "ja" });
}
const observer = new ResizeObserver(draw);
observer.observe(element);
draw();
// Call observer.disconnect() when removing this view.
</script>T1回復曲線
tauは待ち時間[ms]、signalは符号付き信号です。近似式はA − B exp(−τ/T1)です。
<div id="curve"></div>
<script type="module">
import { createT1Plot } from "./nmrlink/graphs.js";
import { fitT1 } from "./nmrlink/index.js";
const points = Array.from({ length: 20 }, (_, i) => {
const tau = 5 + i * 5;
return { tau, signal: 1000 * (1 - 2 * Math.exp(-tau / 20)) };
});
const options = { fit: fitT1(points, { fromMs: 5, toMs: 100 }) };
const element = document.querySelector("#curve");
function draw() {
const width = Math.max(160, Math.floor(element.clientWidth));
element.innerHTML = createT1Plot(points, { ...options, width, locale: "ja" });
}
const observer = new ResizeObserver(draw);
observer.observe(element);
draw();
// Call observer.disconnect() when removing this view.
</script>T2減衰曲線
tauはパルス間隔[ms]、signalは非負の信号です。横軸は2τで、近似範囲の指定も2τ[ms]です。
<div id="curve"></div>
<script type="module">
import { createT2Plot } from "./nmrlink/graphs.js";
import { fitT2 } from "./nmrlink/index.js";
const points = Array.from({ length: 16 }, (_, i) => {
const tau = 5 + i * 2;
return { tau, signal: 1000 * Math.exp(-2 * tau / 22) };
});
const options = { fit: fitT2(points, { fromMs: 10, toMs: 70 }) };
const element = document.querySelector("#curve");
function draw() {
const width = Math.max(160, Math.floor(element.clientWidth));
element.innerHTML = createT2Plot(points, { ...options, width, locale: "ja" });
}
const observer = new ResizeObserver(draw);
observer.observe(element);
draw();
// Call observer.disconnect() when removing this view.
</script>fitを省略すると測定点だけを表示します。パルスとT1はmode: "magnitude"で各点のmagnitudeを表示でき、T1は"quadrature"にも対応します。T1の近似線は符号付き表示だけに描きます。上の色指定はNMRGraphs用で、この4つの曲線関数には適用されません。
パルス・T1・T2の横軸は0から始まりますが、0の測定点を補ってはいません。SVG曲線はResizeObserverで幅に合わせて再描画し、画面を取り除くときに監視を解除します。NMRGraphsは内部で幅の変化を監視します。