1. ホーム
  2. データの保存と書き出し

機構のデータを保存する方法:共有リンク・JSON・CSV・図(SVG/PNG)

このサイトの実験は、4つの方法で持ち帰れます。共有リンクは同じ状態のページをもう一度開くため、JSONは機構そのもの(寸法と動かす範囲)を保存して読み込み直すため、 CSVは計算した数値を表計算ソフトやプログラムで使うため、SVG/PNGは図を資料に貼るためのものです。

どれもブラウザの中で作られ、サーバーには何も送られません。アカウントも要りません。

どのページで何が使えるか

ページ共有リンクJSON の保存・読み込みCSVSVG/PNG
4節リンク機構○○○○
スライダクランク機構○○○○
軌跡の逆設計○(軌跡と選んだ候補)保存のみ—○

ほかのページの実験は、いまは画面で見るだけです。数値を持ち帰りたいときは、同じ寸法を4節リンクやスライダクランクのページに入れてください。

共有リンク

「この値のリンクをコピー」を押すと、いまの寸法と角度が入ったアドレスがコピーされます。値はアドレスの # より後ろに入るので、ページを開いたときにサーバーへは送られません。 開いただけではアドレスは変わらず、値を変えたときに書き換わります。授業の資料や問い合わせに、同じ状態を再現する手段として使えます。

JSON(機構のファイル)

「モデルを保存(JSON)」で、機構の種類・寸法・単位・動かす範囲を1つのファイルに保存します。「モデルを読み込む」で同じページに戻せます。中身は次のような文字だけのファイルで、読み込むときにプログラムとして実行されることはありません。 下は初期値の4節リンクを実際に保存したときの中身です。

{
  "format": "motionlinklab.mechanism",
  "schemaVersion": 1,
  "name": "four-bar linkage",
  "units": {
    "length": "mm",
    "angle": "deg"
  },
  "mechanism": {
    "kind": "fourbar",
    "o2": {
      "x": 0,
      "y": 0
    },
    "o4": {
      "x": 100,
      "y": 0
    },
    "a": 40,
    "b": 120,
    "c": 80,
    "mode": 1,
    "couplerPoint": {
      "u": 60,
      "v": 40
    }
  },
  "input": {
    "from": 0,
    "to": 360,
    "steps": 360
  }
}

同じ機構からはいつも同じ文字列が作られ、その SHA-256 ハッシュ(初期値では bbbec6d86ff7e82b…)が機構の目印になります。保存したファイルを読み込み直すと、文字列もハッシュも完全に一致することを、ページを作るときに確かめています。

CSV(計算した数値)

「CSV をダウンロード」で、動かす範囲の各姿勢の位置・角度・伝達角・速度と加速度(クランクの角度 1 rad あたり)を書き出します。初期値の4節リンクでは 360 等分の 361 行 × 18 列です。 先頭の # の行には、モデルのハッシュ・計算エンジンの版・単位・前提(平面・剛体・運動学のみ)・計算の残差が入るので、あとからどの条件の数値かを確かめられます。下はその先頭部分です。

# Motion Link Lab analysis
# model_hash: bbbec6d86ff7e82bf2a1d4656e4080fef666e00f5468f98a01921eb977b1a688
# solver_version: 0.1.0
# mechanism: fourbar
# length_unit: mm
# angle_unit: deg
# decimal_separator: . (in every locale)
# d1_* and d2_* are first and second derivatives with respect to the input angle in radians
# assumptions: planar; rigid-links; ideal-joints; kinematics-only (no forces, friction, inertia, collisions or strength)
# max_residual_relative: 1.7763568394002506e-16
# completed: true
# events: none
# empty cell = the quantity is not defined at that pose (singular)
input_deg,A_x_mm,A_y_mm,B_x_mm,B_y_mm,P_x_mm,P_y_mm,coupler_angle_deg,output_angle_deg,transmission_angle_deg,d1_P_x_mm_per_rad,d1_P_y_mm_per_rad,d2_P_x_mm_per_rad2,d2_P_y_mm_per_rad2,d1_output_angle_rad_per_rad,d2_output_angle_rad_per_rad2,residual_relative,singular_0_or_1
0,40,0,136.66666666666669,71.1024300256718,64.63252332477607,67.77343723505813,36.336057514613934,62.72038726402189,26.38432974940796,45.18229149003876,23.578317783482614,-89.78106057266349,-16.00742148668384,-0.6666666666666665,1.510601077468486,0,0
1,39.99390780625565,0.6980962574913405,137.47506180181227,70.67969823754453,65.40728414401623,68.1826152460368,35.674520311302736,62.06703090542122,26.392510594118495,43.59070917696525,23.31559258781653,-92.54814196698052,-14.095005178497802,-0.6399220475919539,1.5532273459062,1.7763568394002506e-16,0
2,39.97563308076383,1.3959798681000388,138.24535220080094,70.26587390075422,66.15386129656432,68.5874999244395,35.02373916654574,61.44077569501787,26.417036528472146,41.95361009528696,23.08636702202029,-94.99595133558873,-12.172634565134405,-0.6124799305311115,1.5905053847089368,5.921189464667501e-17,0

図(SVG/PNG)

「図を保存」で、いま表示している姿勢の図を書き出します。SVG は拡大しても線がぼやけない形式で、資料の作成ソフトで編集もできます。PNG は普通の画像です。つかんで動かすための印は書き出しません。

このページで分からないこと

見本の出し方

このページの JSON と CSV の見本は、ダウンロードの各ボタンが使うのと同じ関数で、ページを作るときに実際に作った文字列です(計算エンジンの版 0.1.0)。CSV の行数と、モデルのハッシュ・前提が入っていることも、そのときに確かめています。