.. _sec-installation_mac:

Mac OSにおけるインストール及び実行方法
==================================================

インストールの前に
-----------------------------------

PHITSが作成するEPSファイルを表示するためにGhostscriptが必要です。Ghostscriptがインストールされていない場合、インターネットにアクセスできて、HomebrewまたはMacPortsパッケージマネージャーが使われているマシンでは、PHITSのインストーラが自動的にGhostscriptをインストールします。パッケージマネージャーが使われていないマシンではPHITSXXXフォルダの中に同梱されているGhostscriptのインストーラが起動しますので、画面の指示に従ってください。

PHITSのインストールには7zip系の :command:`7zz` または :command:`7z` コマンドがあるとインストールがより短時間で完了します。HomebrewまたはMacPortsパッケージマネージャーが使われているマシンでは、PHITSのインストーラが自動的に :program:`7zip` をインストールします。パッケージマネージャが使われていないマシンでは、macOSに入っている :command:`tar` コマンドが使用されます。

インストール方法
--------------------------------------------------

推奨方法
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. :program:`システム設定` の :guilabel:`プライバシーとセキュリティ` から :program:`ターミナル.app` にフルディスクアクセスの権限を付与して下さい。 :program:`ターミナル.app` は :file:`アプリケーション` フォルダ内の :file:`ユーティリティ` フォルダにあります。

   .. figure:: mac-full_disk_access.png
      :width: 40em
      :alt: full disk access on Mac
      :name: mac-full-disk-access

      フルディスクアクセスの付与

#. 事務局よりダウンロードしたzipファイルを展開してできた :file:`PHITSXXX` フォルダ内の :file:`mac` フォルダの中の :program:`PHITS_Installer.command` を右クリック (またはセカンダリクリック、トラックパッドで2本指タップ、またはcontrolクリック、以下右クリックと記述)してショートカットメニューの :guilabel:`開く` を選択します。

   .. figure:: mac-installer_command.png
      :width: 40em
      :alt: installer command on Mac
      :name: mac-installer-command

      :code:`PHITS_Installer.command` の起動

#. macOS 14 Sonoma 以前の場合、開発元が未検証なためこのアプリケーションを開くかどうか確認を求めるダイアログが現れるのことがありますので、 :guilabel:`開く` を押して下さい。

   .. figure:: mac-unknown_dev.png
      :width: 40em
      :alt: unknown developer on Mac
      :name: mac-unknown_dev

      開発元が未検証のため開くかどうか確認を求めるダイアログ

#. macOS 15 Sequoia 以降の場合、 :program:`PHITS_Installer.command` を右クリックしたときに、開いていません、というダイアログが現れることがありますので、 :guilabel:`完了` を押してください。

   .. figure:: mac-installer_not_opened.png
      :width: 40em
      :alt: installer not opened on Mac
      :name: mac-installer-not-opened

      :code:`PHITS_Installer.command` が開いていませんというダイアログ

#. :program:`システム設定`` の :guilabel:`プライバシーとセキュリティ`` の下の方に、 :code:`お使いのMacを保護するために "PHITS_Installer.command" がブロックされました。` という項目があるので、その右の :guilabel:`このまま開く` を押してください。

   .. figure:: mac-open_anyway.png
      :width: 40em
      :alt: installer not opened on Mac
      :name: mac-open-anyway

      :program:`PHITS_Installer.command` を開くためのダイアログ

#. 管理者のユーザ名とパスワードを入力を促すイアログが出る場合は、指示に従って下さい。

   .. figure:: mac-admin_dialog.png
      :width: 40em
      :alt: Administrator dialog on Mac
      :name: mac-admin-dialog

      管理者のユーザ名とパスワードを入力を促すダイアログ

#. :program:`PHITS_Installer.command` が起動できない場合は、ターミナルを起動して、 :program:`PHITS_Installer.command` があるディレクトリに移動して、以下のコマンドを実行してください。その後、 :program:`PHITS_Installer.command` を右クリックして、ショートカットメニューの :guilabel:`開く` を選択してください。

   .. code-block:: console

      $ chmod 755 PHITS_Installer.command

#. :program:`Ghostscript` がインストールされておらず、パッケージマネージャーが利用できない場合、 :program:`Ghostscript` のインストール画面が表示されます。画面の指示に従って下さい。 :program:`Ghostscript` がインストールされている場合やパッケージマネージャが利用できる場合にはこの画面は表示されません。

#. インストールモードの選択において、 :guilabel:`Automatic` を選択します。 :guilabel:`Manual` は :guilabel:`Automatic` が上手く動作しない場合に選択してください。

   .. figure:: mac-mode.png
      :width: 40em
      :alt: installation mode on Mac
      :name: mac-mode

      インストールモードの選択

#. インストール先のフォルダを指定します。通常、アカウント名 (下のスクリーンショットでは **alex** ) と同名のフォルダが選択されるので、 :guilabel:`選択` を押します。

   .. figure:: mac-location.png
      :width: 40em
      :alt: installation location on Mac
      :name: mac-location

      インストール先のフォルダの選択

#. インストール完了後、システムを再起動してください。

#. インストール先に :file:`phits` という名前のフォルダが作られます。PHITS 本体とソース、講習会の資料、例題などが入っています。

.. tip::
   - インストール後に :file:`phits` フォルダを別のフォルダへ移動させるとPHITSは動作しなくなります。もう一度インストールしてください。
   - インストール先に :file:`phits` という名前のフォルダが存在する場合は、古いフォルダはphits[今日の日付].[現在の時刻] に名称が変更されます。
   - PHITSパッケージをコピーするフォルダやインストールフォルダの名称にスペースや漢字があるとエラーになる場合がありますので、
   - このような文字が使われていないフォルダにインストールしてください。

推奨方法で失敗した場合の手順
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- ホームディレクトリ (アカウント名が **alex** の場合は :file:`/Users/alex` ) に :file:`phits` フォルダを作成します。
- 事務局よりダウンロードしたzipファイルを展開してできた :file:`phitsXXX` フォルダ内の :file:`phits.7z` を :file:`phits` フォルダの中へコピーします。
- コピーした :file:`phits.7z` をダブルクリックして展開します。
- :file:`phitsXXX/mac` フォルダの中の :file:`PHITS.Router.app.zip` をダブルクリックして展開してできた :file:`PHITS.Router.app` を :file:`/Applications` フォルダの中に移動します。
- :file:`PHITSXXX/mac` フォルダの中の :program:`PHITS_Installer.command` を右クリックしてショートカットメニューの :guilabel:`開く` を選択します。
- インストールモードの選択において、 :guilabel:`Manual` を選択します。
- :file:`phits/bin` フォルダの中の :file:`phits252_mac.exe` を選択し、インストールを開始します。

この方法でPHITSをインストールできない場合、 :numref:`sec-mac-installation-exception` をご参照ください。

.. _sec-mac-installation-exception:

上記のいずれの方法も成功しない場合
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ターミナルからPHITSを実行できるようにします。ターミナルを使ってPHITSを初めて実行する場合は、PHITSの実行ファイルがあるフォルダに環境変数 :envvar:`PATH` を設定する必要があります。ターミナルで下記のコマンドを入力して下さい。

.. code-block:: console

   $ echo 'export PHITSPATH=/PATH-TO-PHITS/phits' >> .zshenv
   $ echo 'export PATH=$PHITSPATH/bin:$PHITSPATH/dchain-sp/bin:$PATH' >> .zshenv
   $ source .zshenv

ここで「/PATH-TO-PHITS」は各自のインストール先のフォルダ名 (アカウント名が **alex** の場合は :file:`/Users/alex` ) に変更してください。
PATH-TO-PHITSが分からない場合は、ターミナルを立ち上げた時点で、

.. code-block:: console

   $ find $HOME -name phits_mac

を入力してください。このコマンドの結果から :file:`/phits/bin` を削除したものがPATH-TO-PHITSに対応します。なお、このPATHの設定は、初めてPHITSを実行する時のみ必要となり、それ以降は不要です。

次に、実行ファイルに実行権限を付与します。ターミナルで下記のコマンドを実行して下さい。

.. code-block:: console

   $ chmod 755 $PHITSPATH/bin/* $PHITSPATH/dchain-sp/bin/*
   $ chmod 755 $PHITSPATH/phig3d/macos-universal/phig3d.app/Contents/MacOS/phig3d
   $ chmod 755 $PHITSPATH/phitspad/macos/PhitsPad.app/Contents/MacOS/phitspad
   $ xattr -d -r com.apple.quarantine $PHITSPATH/bin/* $PHITSPATH/dchain-sp/bin/*
   $ xattr -d -r com.apple.quarantine $PHITSPATH/phitspad/macos-universal/phig3d.app/Contents/MacOS/phig3d
   $ xattr -d -r com.apple.quarantine $PHITSPATH//phitspad/macos/PhitsPad.app/Contents/MacOS/phitspad



実行方法
--------------------------------------------------

PHITSのインストールが完了すると、ドックに :program:`PHITS Router` のアイコンが追加されます。

.. figure:: mac-dock_icon.png
   :width: 40em
   :alt: Dock icon on Mac
   :name: mac-dock_icon

   ドックに追加された :program:`PHITS Router` のアイコン

ファイルの関連付け
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

PHITSの入力ファイルである :file:`phits/lecture/basic/lec01/lec01.inp` を右クリックして、 :guilabel:`このアプリケーションで開く` を選択し、 :guilabel:`その他` を選択します。

.. figure:: mac-file_association0.png
   :width: 40em
   :alt: file association on Mac
   :name: mac-file_association0

   入力ファイルの関連付け

ファイル選択ダイアログで、 :program:`PHITS Router.app` を選択し、 :guilabel:`開く` を押します。

.. figure:: mac-file_association1.png
   :width: 40em
   :alt: file association on Mac
   :name: mac-file_association1

   入力ファイルの関連付け

PHITSの実行
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. rubric:: ドラッグ & ドロップによる実行方法

:file:`lec01.inp` のようなPHITSの入力ファイルをドックの :program:`PHITS Router` にドラッグ & ドロップして下さい。

.. figure:: mac-phits.png
   :width: 40em
   :alt: launch PHITS on Mac
   :name: mac-phits

   PHITSの選択

初めて起動する際には :program:`PHITS Router.app` が :program:`ターミナル.app` を制御する許可を求められますので、許可して下さい。

.. figure:: mac-phits_1st.png
   :width: 40em
   :alt: 1st launch PHITS on Mac
   :name: mac-phits_1st

   :program:`ターミナル.app` を制御する許可を求めるダイアログ

この画面が出るので、 :guilabel:`PHITS` を選択して、 :guilabel:`OK` を押してください。

:kbd:`⌘ Command` キーを押しながら、入力ファイルを :program:`PHITS Router` にドラッグ & ドロップすると、この画面が表示されずに直接 :program:`PHITS` が実行されます。

新規ターミナルが開き、計算状況が表示されます。計算結果の出力ファイルは入力ファイルと同じフォルダに作られます。再度同じ名前のインプットで計算を実行したい場合は、計算状況が出力されたターミナルで :kbd:`↑ 上向き矢印` キーを押してからリターンキーを押せば実行できます。

.. rubric:: ターミナルでの実行方法

ターミナルで入力ファイルがあるディレクトリに移動して次のコマンドを実行して下さい。

.. code-block:: console

   $ phits.sh 入力ファイル名

例

.. code-block:: console

   $ phits.sh lec01.inp

PHITSPADの実行
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. rubric:: ドラッグ & ドロップによる実行方法

:file:`lec01.inp` のようなPHITSの入力ファイルをドックの :program:`PHITS Router` にドラッグ & ドロップして下さい。

.. figure:: mac-phitspad.png
   :width: 40em
   :alt: PHITSPAD on Mac
   :name: mac-phitspad

   PHITSPADの選択

この画面が出るので、 :guilabel:`PHITS-Pad` を選択して、 :guilabel:`OK` を押してください。

:kbd:`⇧ Shift` キーを押しながら、入力ファイルを :program:`PHITS Router` にドラッグ & ドロップすると、この画面が表示されずに直接 :program:`PHITS-Pad` が起動します。

.. rubric:: ターミナルでの実行方法

ターミナルで入力ファイルがあるディレクトリに移動して次のコマンドを実行して下さい。

.. code-block:: console

   $ phitspad.sh 入力ファイル名

例

.. code-block:: console

   $ phitpad.sh lec01.inp

PHIG-3Dの実行
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. rubric:: ドラッグ & ドロップによる実行方法

:file:`lec01.inp` のようなPHITSの入力ファイルをドックの :program:`PHITS Router` にドラッグ & ドロップして下さい。

.. figure:: mac-phig3d.png
   :width: 40em
   :alt: PHIG3D on Mac
   :name: mac-phig3d

   PHIG3Dの選択

この画面が出るので、 :guilabel:`PHIG-3D` を選択して、 :guilabel:`OK` を押してください。

:kbd:`⌥ Option` キーを押しながら、入力ファイルを :program:`PHITS Router` にドラッグ & ドロップすると、この画面が表示されずに直接 :program:`PHIG-3D` が起動します。

.. rubric:: ターミナルでの実行方法

ターミナルで入力ファイルがあるディレクトリに移動して次のコマンドを実行して下さい。

.. code-block:: console

   $ phig3d.sh 入力ファイル名

例

.. code-block:: console

   $ phig3d.sh lec01.inp

ANGELの実行
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. rubric:: ドラッグ & ドロップによる実行方法

:code:`track_xz.out` のようなPHITSが生成した出力ファイルをドックの :program:`PHITS Router` にドラッグ & ドロップして下さい。

.. figure:: mac-angel.png
   :width: 40em
   :alt: ANGEL on Mac
   :name: mac-angel

   ANGELの選択

この画面が出るので、 :guilabel:`ANGEL` を選択して、 :guilabel:`OK` を押してください。

:kbd:`⌥ Option` キーを押しながら、入力ファイルを :program:`PHITS Router` にドラッグ & ドロップすると、この画面が表示されずに直接 :program:`ANGEL` が起動します。

.. rubric:: ターミナルでの実行方法

ターミナルで入力ファイルがあるディレクトリに移動して次のコマンドを実行して下さい。

.. code-block:: console

   $ angel.sh 入力ファイル名

例

.. code-block:: console

   $ angel.sh track_xz.out

DCHAINの実行
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. rubric:: ドラッグ & ドロップによる実行方法

:file:`tdchain.out` のようなPHITSが生成した出力ファイルをドックの :program:`PHITS Router` にドラッグ & ドロップして下さい。

.. figure:: mac-dchain.png
   :width: 40em
   :alt: DCHAIN on Mac
   :name: mac-dchain

   DCHAINの選択

この画面が出るので、 :guilabel:`DCHAIN` を選択して、 :guilabel:`OK` を押してください。

:kbd:`⌘ Command` キーを押しながら、入力ファイルを :program:`PHITS Router` にドラッグ & ドロップすると、この画面が表示されずに直接 :program:`DCHAIN` が起動します。

.. rubric:: ターミナルでの実行方法

ターミナルで入力ファイルがあるディレクトリに移動して次のコマンドを実行して下さい。

.. code-block:: console

   $ dchain.sh 入力ファイル名

例

.. code-block:: console

   $ dchain.sh tdchain.out

PHITS Routerの詳しい使い方
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

PHITS Routerでは好みのテキストエディタで開くように設定できます。
詳しくは、 `<https://github.com/Lindt8/phits-router-macos>`_ をご参照ください。


EPSファイルの表示
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. rubric:: 推奨方法

- EPSファイルをダブルクリックしてください。
- 複数のEPSファイルを同時にダブルクリックした場合は、それぞれのファイルをPDFに変換して表示します。


.. rubric:: ダブルクリックで開けない場合

EPSファイルをダブルクリックした時に、以下のような画面が出る場合には次の手順に従ってください。

.. figure:: mac-no_eps_app.png
   :width: 40em
   :alt: no eps app on Mac
   :name: mac-no-eps-app

   EPSファイルを開くアプリケーションがないというダイアログ

上の画面で、:guilabel:`アプリケーションを選択` を押す。 ファイル選択ダイアログで :file:`phits/bin/EPSPDF.app` を選択する。

.. figure:: mac-epspdf_location.png
   :width: 40em
   :alt: epspdf location on Mac
   :name: mac-epspdf_location

   EPSPDF.appを選択するダイアログ

次回以降はEPSファイルをダブルクリックしてください。

.. tip::
   - PHITSまたはANGELが作成したEPSファイルだけではなく、全てのEPSファイルでダブルクリックするとこのアプリケーションを経由してプレビューで開きます。
   - EPSファイルを別のアプリケーションで開きたい場合は、そのファイルを右クリックして :guilabel:`このアプリケーションで開く` で使用したいアプリケーションを選択してください。