第0章: MNELABとは何か¶
これは本リポジトリのMNE-Pythonトラックに付属する、短いガイド形式のコンパニオンです — BrainstormやEEGLAB & ERPLABと並ぶ4本目の独立したトラックではありません。MNELAB はMNE-Python自体の上に直接構築されたグラフィカルインターフェースなので、別のツールを教えるのではなく、メイン トラックがすでに教えている「読み込み → 前処理 → ICA → イベント/エポック化 → ERP」というワークフローを、コードを書く代わりにメニューをクリックして辿ります。メイン トラックのEEGの基礎とMNEのコア概念の章を読んでいることを前提とします。
ひとことで言うMNELAB¶
MNELABは、Clemens Brunnerによって作られ、2022年に Journal of Open Source Software で発表された、無料でオープンソースの、クロスプラットフォームなMNE-Python用グラフィカルユーザーインターフェースです。メイン ウィンドウに記録データをドラッグするとファイルが読み込まれ、チャンネル数、記録時間、サンプリング周波数が表示され、フィルタリング、再基準化、ICAの実行、イベント/アノテーションの編集、エポック化、誘発反応のプロットまで、すべてメニューから、コードを一行も書かずに行えます。これらのメニュー項目はどれも、普通のMNE-Python関数やメソッド呼び出しへの薄いラッパーです。
なぜ4本目のトラックではなくコンパニオンなのか¶
BrainstormとEEGLAB & ERPLABは独自のファイル形式を持つ別のアプリケーションです — MNE-Pythonと併用するには、実際のフォーマットの境界を越えてファイルをエクスポート・インポートする必要があり、それぞれのトラックが専用の「MNE-Pythonへの橋渡し」の章で締めくくられているのはそのためです。MNELABには越えるべきそのような境界がありません。すでにMNE-Pythonが読み書きしているのと同じファイル形式を開いて保存するだけであり、内部的には MNE-Python そのもの です — メイン トラックの第2〜7章に出てくるのと同じ Raw、Epochs、Evoked、ICA オブジェクトを、タイプする代わりにクリックして操作しているだけです。だからこそ、この内容はMNE-Pythonトラックの隣ではなく内側に置かれています。
BrainstormおよびEEGLAB & ERPLABとの位置づけ¶
| MNE-Python | MNELAB | Brainstorm | EEGLAB + ERPLAB | |
|---|---|---|---|---|
| インターフェース | Pythonコード | GUI(MNE-Python上に構築) | GUI | GUI |
| 必要なもの | Python | Python(小さなアプリとしてインストール) | 不要(スタンドアロン)またはMATLAB | MATLAB、またはEEGLABのスタンドアロン ランタイム |
| 内部のデータ | — | MNE-Pythonとまったく同じオブジェクト | 独自のデータベース形式 | .set/.fdt、.erp |
| 向いている用途 | 再現可能なスクリプト、最大の柔軟性 | 新しい記録データをすばやく一目見る、あるいはMNE-PythonのAPIが生成される様子を見ながら学ぶ | 3Dソース推定 | 大規模なERP測定、豊富なプラグイン群 |
MNELABはMNE-Pythonコードを書くことを置き換えようとしているわけではありません — 作者自身、その目標を「補完すること」だと述べています。新しい記録データを手早く探索的に眺めるとき、あるいはマウスですでにできる操作がどのMNE-Python関数に対応するかを発見する手段として、特に役立ちます。
このコンパニオン ガイドの内容¶
メインのMNE-Pythonトラックと同じワークフロー・用語をそのまま使う、8つの短い章です:
| # | 章 |
|---|---|
| 0 | MNELABとは何か |
| 1 | インストールと初回起動 |
| 2 | データの読み込みと確認 |
| 3 | 前処理 — フィルタリングと再基準化 |
| 4 | ICAによるアーティファクト除去 |
| 5 | イベントとエポック化 |
| 6 | ERP解析 |
| 7 | メニューからスクリプトへ:履歴パネル |
BrainstormおよびEEGLAB & ERPLABトラックと同様、これらの章はMarkdownによる説明のみを含みます — MNELABはライブラリではなくGUIアプリケーションなので、ここに実行すべきコードはありません。