本文へ移動

保存・読み込み API

生データを残すJSONと、見た目を残す画像を使い分けます。保存・読み込みガイドに操作例があります。

このページの内容

saveMeasurement(record)

import先はnmrlink/browser。測定記録を改行・インデント付きJSONとしてダウンロードし、戻り値はありません。元の記録は変更しません。利用者のクリックから呼んでください。

ファイル名はnmrlink-取得日時_JST.jsonで、時刻は日本時間です。記録内のacquiredAtは変更しません。表示範囲で生データを切り詰めず、渡した記録全体を保存します。

parseMeasurement(text)・readMeasurement(file)

parseMeasurementはnmrlinkの同期関数、readMeasurementはnmrlink/browserの非同期関数です。文字列 / Fileを読み、検証済みの測定記録を返します。通信・装置操作は行いません。

検証項目条件
容量UTF-8で2 MiB以下
source / modeinstrumentまたはdemo / singleまたはdouble
points / sampleIntervalMs2048 / 0.02
raw2048組の有限数値2つ。数値文字列は拒否
acquiredAt / parameters有効な取得日時 / 測定条件。demoのみparameters:nullを許可

未知のフィールドや保存された解析結果は戻り値に含めません。parseMeasurementは例外を投げ、readMeasurementは読み込み・検証失敗でrejectします。解析も成功した後に、現在の記録・表示を置き換えてください。

js
const file = fileInput.files[0];
if (file) {
  try {
    const record = await readMeasurement(file);
    const analysis = analyzeMeasurement(record);
    graphs.show(record, analysis);
  } catch (error) {
    status.textContent = error.message;
  }
}

saveGraphPng(svg, options)

import先はnmrlink/browser。SVG要素を白背景のPNGにしてダウンロードするPromiseです。filenameはnmrlink-graph.png、scaleは2が既定です。scaleは0より大きく4以下。各辺8192 px以下、合計16メガピクセル以下の出力に限ります。

表示中の軸・ラベル・波形・色・解析範囲を保存します。元のSVGや測定記録は変更しません。SVG以外、不正なscale、画像変換の失敗は例外またはrejectです。自作UIから渡すSVGはNMRLinkで生成したものを使ってください。

formatFileTimestamp(acquiredAt)

import先はnmrlink/browser。端末のタイムゾーンに依存せず、日時文字列からファイル名用の日本時間を返します。不正な日時はTypeErrorです。

js
const name = formatFileTimestamp("2026-10-21T06:00:00.000Z");
// "2026-10-21_15-00-00-000_JST"

走査全体のJSONを復元する

import先はnmrlink。以下は同期関数で、各Web UIの「全データJSON」の文字列を受け取ります。保存済みの振幅・近似値は使わず、生データから再計算します。

関数主な戻り値
parseFrequencySweep(text)source、acquiredAt、settings、points
parsePulseCalibration(text)上記+calibration、referenceIndex、phaseDegrees
parseT1Measurement(text)基本4項目+result、referenceIndex、phaseDegrees、fromMs、toMs
parseT2Measurement(text)基本4項目+result、referenceIndex、fromMs、toMs

上限は32 MiB、1〜201点。途中停止した走査の記録にも対応します。条件・測定点・基準点・近似範囲の不整合は例外です。有効な無信号のパルス・T1・T2走査は波形確認用に開けますが、calibrationまたはresultがnullになります。

MAX_FREQUENCY_JSON_BYTES・MAX_PULSE_JSON_BYTES・MAX_T1_JSON_BYTES・MAX_T2_JSON_BYTESは、それぞれ32 × 1024 × 1024です。走査全体の保存専用関数はなく、Web UIが各形式のJSONを組み立てています。

API一覧