流れ

• What — このツールでできること
• Setup — インストール（1回だけ）
• Run — 対話モードとコマンド
• More — 一括変換・中身の確認
• Help — エラー別の対処

できること

.hed / .bio は サイズが大きく 持ち運びが大変。
mea2npz がこれを 軽い .npz に変換します。

3つの強み

• Python 不要
  実行ファイル1つを置くだけで動く
• マルチOS対応
  Windows / Mac / Linux で同じ操作
• 完全に同じ数値
  変換した .npz は pyMEA でそのまま読める

用語ガイド

.hed と .bio はセットで1計測。.hed を渡せば .bio は自動で探します。

インストール

最初の 1回だけ。ターミナルに貼り付けて Enter。

curl -fsSL https://raw.githubusercontent.com/kkito0726/MEA_modules/main/tools/mea2npz/install.sh | bash

• Windows — スタートメニューで git bash を開いて実行
• Mac / Linux — ターミナルを開いて実行
• 完了後、ターミナルを 開き直す

mea2npz -version   # 文字が出れば成功

Mac で開けない時 → xattr -d com.apple.quarantine ~/bin/mea2npz

いちばん簡単

対話モード — 質問に答えるだけで変換できます。

mea2npz

入力パス (.hed ファイル or ディレクトリ): sample.hed
保存dtype (int16/float32) [int16]:        ← Enter でOK
読み込み時間を指定する [Y/n]: n            ← 全部なら n
電極間距離 (μm) [450]:                     ← 450 なら空欄のまま Enter
変換完了: sample.npz

電極間距離はたいてい 450 → 何も入れず Enter（空欄）でOK。
ファイルは ドラッグ＆ドロップ で入力できます。

質問の意味

コマンドで使う

慣れたら、質問なしで一発変換。

# いちばん基本（全部を int16 で変換）
mea2npz sample.hed

# 30秒〜60秒だけ切り出す
mea2npz sample.hed -start 30 -end 60

# float32 で保存する
mea2npz sample.hed -dtype float32

ヘルプは mea2npz -h で表示されます。

主なオプション

まとめて変換

フォルダを渡すと 中身を全部 変換します。

mea2npz ./measurements          # サブフォルダも → -recursive

• 結果はフォルダ内の output/ にまとめて保存
• 変換できないファイルは 止まらず飛ばす
• 最後に 成功 / スキップ / 失敗 の件数を表示

中身の確認

「この .npz どんな設定だっけ？」は .npz を渡すだけ。

mea2npz sample.npz

このとき 変換はされません。中身を見るだけなので安全です。

Python で読む

pyMEA では .hed とほぼ同じように読めます。

from pyMEA import read_MEA_npz

mea = read_MEA_npz("sample.npz")
print(mea.data.array.shape)
# (65, データ数) … 1行目は時刻、2行目以降が各電極

• mea2npz の .npz は pyMEA 製と 数値が完全に一致
• これまでの 解析コードがそのまま使える

処理の流れ

変換ボタンを押すと、中ではこう動いています。

中身確認のときは、重い電位データは読まず 設定部分だけを読みます。

困ったとき

エラーは赤い画面ではなく ふつうの文字。落ち着いて読めば原因が書いてあります。