2018.09.12追記：license.txtの扱いが少し変わったので、修正いたしました。また、High Sierraでもインストールを確認できています。
FreeSurferのMacへのインストールについては、本家のサイトにもstep-by-stepのわかりやすいインストラクションがありますが、ターミナルやFinderの設定も含めて示したいと思います。
- ターミナルの設定
- Spotlightでターミナルを見つける
- Dockに追加する
- Finderの設定
- パスバーの表示
- ホームフォルダを「よく使う項目」に追加
- XQuartzのインストール
- XQuartzの入手
- XQuartzのインストール
- ログアウト、再ログイン
- バージョンの確認
- FreeSurferのインストール
- ライセンスの要請
- ライセンスの準備
- FreeSurferインストーラーの入手
- インストーラーの実行
- データフォルダの準備
- ライセンスファイルの移動
- FreeSurferの起動
- サンプルデータを用いて解析
FreeSurferを使うには、ターミナルは必須となります。そこで、まず、ターミナルにすぐにアクセスできるように設定しましょう。
Finderから アプリケーション→ユーティリティ→ターミナル と見つけてもいいですが、MacにはSpotlightという優秀な検索エンジンがありますので、そちらで見つけるのが速いかと思います。
これでターミナルを起動してください。
シンプルな以下のようなものです。
次に、ターミナルをDockに追加しましょう。ターミナルが起動している時にDockのターミナルのところを右クリックして、 オプション→Dockに追加 を選択します。
このようにすれば、今後、Spotlightから探さなくても常にターミナルがDockにいますのですぐに立ち上げられます。
色々な方のMacを見てきて、Finderが人によって見かけが違うので、これを統一するのは難しいのですが、 パスバーの表示 と ホームディレクトリをお気に入りに追加 は絶対役立つと思いますので、その設定を紹介します。
Finderのメニューから、 表示→パスバーを表示 を選択してください。
そうすると、Finderの下に、パスが表示されるようになります。
これを表示しておくと、便利な裏技を使うことができます。私も今日気づいたのですが、パスで、右クリックして、 サービス→フォルダに新規ターミナル と選んでいただくと、そのフォルダに移動した状態でターミナルが立ち上がります。最初はこの便利さを感じれないかもしれませんが、ターミナルをよく使うようになると、どれだけ便利かわかると思います。
現在のMacでは、ホームフォルダ (/Users/foo) がFinderに表示されないようになっています。しかし、これはFreeSurferなどを使うときには非常に不便です。この設定をしましょう。
とても簡単です。先程のパスバーのところから、自分のユーザー名（私の場合はkiyotakaとなっています）のアイコンをドラッグ＆ドロップで、よく使う項目に持っていくだけです。これで、自分のホームフォルダ（ディレクトリ）に簡単にアクセスすることができるようになります。
FreeSurferを動かすためにはXQuartzというソフトをインストールする必要があります。FreeSurferの公式ページによると、MacOS 10.10以降では、Ver.2.7.6を入れることと書いてあります。FSLでも使うものなので、最新版をインストールします。2018年9月現在、2.7.11が最新バージョンです。
XQuartzのホームページにいきます。そこにあるXQuartz-2.7.11.dmgをクリックしてダウンロードします。
Macでの通常のアプリのインストールと同じです。ここで困る人はいないと思うので、最初のところだけスクリーンショットを載せます。
インストールが終わると下記のメッセージが出てきます。それにしたがって、ログアウトし、再度ログインします。
今はインストールしたばかりなので、バージョンはわかりますが、今後のことも考えておきます。Spotlightで検索すると、バージョンが表示されるので便利です。
ここまできて、ようやくFreeSurferのインストールが可能になります。
FreeSurferを使用するには、ライセンスを入手しなくてはなりません。
まず、FreeSurfer Download and Registrationのページにアクセスします。
必要事項を記載します。ライセンスはメールで送られてきますので、メールアドレスを間違えないように気をつけてください。
必要事項を記入すると、ほどなくして、自分のメールアドレスにライセンスが送られてきます。
私に送られてきたメールのスクリーンショットを以下に示します。
といった感じです。
ここに添付されている license.txt を、ダウンロードフォルダにダウンロードします。
これでライセンスの準備が完了しました。
FreeSurferのインストーラーを入手します。FreeSurferのダウンロードのページにアクセスし、Mac用のファイルをダウンロードします。ダウンロードに数時間かかるので辛抱強くダウンロードしてください。
ダウンロードしたFreeSurferのインストーラーはAppleの公式アプリではありませんので、そのままダブルクリックすると、エラーになってしまいます。
そのため、右クリックから 開く を選択します。
そうすると、freesurfer-Darwin-full.pkg ができます。
ダブルクリックするとインストールが始まろうとしますが、High Sierra以降では、警告画面が出ます。
ここで、一度、OKをクリックし、Macのメニューから「システム環境設定…」を選び、「セキュリティとプライバシー」を選択します。
そうすると、”freesurfer-Darwin-full.pkg”は開発元を確認できないため、開けませんでした。 という表示が出ますので、右側の「このまま開く」をクリックします。
さらに確認画面が出ますので、「開く」をクリックします。
これでようやくインストーラーが立ち上がります。
最初に以下の画面が出てきます。
具体的に下記のように書いてあります。
Do this now! Include the following in your .profile file in your home directory: export FREESURFER_HOME=/Applications/freesurfer source $FREESURFER_HOME/SetUpFreeSurfer.sh The environment variable FREESURFER_HOME is the installation path (default is /Applications/freesurfer).
.profileファイルに2行記載しろと書いてあります。
私はこのとおりにやってみたのですが、.bash_profileに入力しなければだめでした。
また、後ほど述べますが、画像データは保存場所を決めたほうがうまくいくので、その設定もしておくことにします。
FSLなどを使っている人はすでにこのファイルを使ったことがあるはずです。
ターミナルからテキストエディットを立ち上げてみます。
ターミナルを起動し、以下のようにタイプしてください。
open -a textedit .bash_profile
もし、
The file /Users/kiyotaka/.bash_profile does not exist.
のようなエラーが出たとしたら、それはファイルがまだないということなので、次のようにして作成します。
touch .bash_profile
そのうえで再度
open -a textedit .bash_profile
とタイプしてください。
そして、以下の4行をそのままコピペします。
#FreeSurfer
export SUBJECTS_DIR=~/freesurfer/subjects
export FREESURFER_HOME=/Applications/freesurfer
source $FREESURFER_HOME/SetUpFreeSurfer.sh
一番最初の
#FreeSurfer
は、コメント文で、ここからFreeSurferの設定だよという意味です。
次の
export SUBJECTS_DIR=~/freesurfer/subjects
は、FreeSurferが個々人の画像データがあると認識するフォルダがここですよと教えてあげています。
export FREESURFER_HOME=/Applications/freesurfer
は、コンピューターにFreeSurferのあり場所を教えています。
最後の
source $FREESURFER_HOME/SetUpFreeSurfer.sh
は、FreeSurferの設定ファイルを実行させています。
私の場合、色々なソフトの設定が書いてあるので、ごちゃごちゃしていますが、FreeSurferに必要なのは、上記だけです。
保存していただければ、準備ができたことになります。
さて、それではインストーラーに戻りましょう。通常のアプリケーションと同様に進めていきます。スクリーンショットだけ掲載します。
あともう一息です。
FreeSurferは、アプリケーションフォルダにインストールされています。そして、デフォルトでは、画像データも全部アプリケーションフォルダの中に保存されていくことになります。これはとても使い勝手がよくないので、自分のフォルダの中に準備するようにしましょう。
ターミナルを立ち上げてください。
以下のようにタイプしてください。（コピペで結構です）
mkdir freesurfer cp -r /Applications/freesurfer/subjects freesurfer
これは以下の意味になります。
・ホームフォルダの下に freesurfer という名前のフォルダを作成
・/Applications/freesurfer/subjectsを全部 ホームフォルダに作成した free surferフォルダにコピー
最後にライセンスファイルを/Applications/freesurferに移動します。
先程準備したダウンロードフォルダにあるlicense.txtをアプリケーションフォルダの中にあるfreesurferの下にいれてください。
そうすると、下図のように質問されますので、 認証 をクリックすれば移動できます。
ここまでできたら、一度ログアウトし、再度ログインします。
ターミナルを起動してください。以下のようにFreeSurferに関する記述が出てきたらうまくいっていることになります。
さらに以下をコピペしてみてください。
cd $SUBJECTS_DIR
freeview -v \
bert/mri/T1.mgz \
bert/mri/wm.mgz \
bert/mri/brainmask.mgz \
bert/mri/aseg.mgz:colormap=lut:opacity=0.2 \
-f \
bert/surf/lh.white:edgecolor=blue \
bert/surf/lh.pial:edgecolor=red \
bert/surf/rh.white:edgecolor=blue \
bert/surf/rh.pial:edgecolor=red
この結果、下図のようなものが出てくればバッチリです。
今、ホームディレクトリの下にあるfreesurfer/subjectsの中には、sample-001.mgzとsample-002.mgzと2つのファイルがあります。同一人物が2回撮影したファイルです。FreeSurferでは、これをbertというsubject IDで出力結果が入っていますが、一応、自分でもやってみましょう。subject IDをernieとしてみます。
ターミナルから以下のようにタイプしてください。
cd $SUBJECTS_DIR recon-all -s ernie -i sample-001.mgz -all
こうすると処理がはじまります。license.txtがきちんと配置されていないと、ここでエラーとなります。そして、この処理は、8時間程度かかりますので、じっと我慢してください。
以上、長くなりましたが、MacでのFreeSurferの設定でした。
ピングバック： FreeSurferのインストール方法 | HALnote