.. _sec-installation_win:
.. _sec-Win-install:

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

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

#. 古いバージョンのPHITSをインストールしている場合は、ご自身で編集したファイルのバックアップを取ってください(上書きインストールをします)。ただし、アドレスファイル(``xsdir.jnd``)のみ上書きの可否を選択可能で、上書きする場合は古いファイルのバックアップを自動で作成します。

#. PHITSパッケージの ``win`` フォルダにある ``phits_win_setup.exe`` をダブルクリック。

#. インストールフォルダを指定(``c:/phits`` を奨励します)

#. 必要なソフトウェアを選択。初めてPHITSをインストールするPCの場合は「新規インストール」、更新の場合は「バージョンアップ」を選択することを奨励します（:numref:`sec-Win-recomsoft` 参照）。

#. インストール完了

#. インストールが適切に完了したかどうかを確認するため、 ``phits/lecture/basic/lec01/lec01.inp`` のファイルを指定し、右クリックして ``送る`` → ``PHITS`` を選択

#. ``xz_track_all.eps`` が作成されたことを確認

 (注意) インストールフォルダやPHITSのインプットファイルがあるフォルダの名称にスペースや漢字があるとエラーになる場合がありますので、そのような文字が使われていないフォルダでご利用ください。

インストーラは、下記の内容を実施します。

#. エディタのインストールが選択された場合は、そのエディタをインストールして ``*.inp`` と ``*.out`` ファイルに関連付ける。また、そのエディタからPHITSやPHIG-3Dを直接実行できるように設定ファイルを修正する。
#. Ghostscriptが選択された場合は、Ghostscriptのインストーラを実行する。
#. SumatraPDFが選択された場合は、SumatraPDFのインストーラを実行する。
#. PHIG-3Dの実行に必要なVisual C++再頒布可能パッケージをインストールする。
#. phits.7zを指定したインストールフォルダに展開する。
#. PHITSの実行形式を含むフォルダ ``phits/bin`` にPATHを通す。
#. 環境変数 **PHITSPATH** を追加する(これによりインプットファイルで **file(1)** を指定する必要がなくなります)。
#. ``phits/bin`` フォルダにある ``phits.bat`` 、 ``angel.bat`` 、 ``phig3d.bat`` 、及び ``phits/dchain-sp/bin`` フォルダにある ``dchain.bat`` のショートカットを ``送る(sendto)`` フォルダに作成する。
#. JENDL-5インストール用に ``app/7za.exe`` を ``phits/bin`` フォルダにコピーする。


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

PHITSを実行する場合は、 ``送る`` による方法とコマンドプロンプトを用いる方法があります。

送るによる実行方法
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Windowsの ``送る`` 機能を用いてPHITSを実行できます。
PHITSの入力ファイルを指定して右クリックをすると、 ``送る`` → ``PHITS`` が表示されますので、これを選択することでPHITSが実行されます。
この方法では、 ``phits/bin`` フォルダにあるPHITS用のバッチファイル ``phits.bat`` のショートカットを ``送る`` に登録しています。
このため、 ``phits.bat`` を編集することで、その変更を ``送る`` によるPHITSの実行内容に反映させることができます。


.. _sec-cmd:

コマンドプロンプトからの実行方法
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WindowsのCUI (Character user interface)である ``コマンドプロンプト`` から、コマンド入力によりPHITSを実行できます。
Windowsの ``スタートボタン`` をクリックし、検索ボックスに ``cmd`` と入力して表示される ``cmd.exe`` を選択すると、:numref:`fig-cmd` に示すようなコマンドプロンプトのウインドウが立ち上がります。

.. figure:: cmd-Windows.png
   :width: 30em
   :alt: command prompt
   :name: fig-cmd

   コマンドプロンプトのウインドウ。

PHITSの実行方法は、 ``cd`` コマンドを使ってインプットファイルのあるフォルダに移動した後、コマンドプロンプト上で下記のように入力します。

.. code-block:: console
   :caption: コマンドプロンプトでのPHITS実行例

    phits.bat phits.inp

ここで、 ``phits.inp`` はPHITSのインプットファイル名です(例:  ``lec01.inp``)。
コマンドプロンプトにおいて↑キーを押すと、過去のコマンド履歴が出ますので、同じインプットファイルを何度も実行する場合に便利です。


.. _sec-Win-recomsoft:

推奨ソフトウェア
--------------------------------------------------

PHITSを実行するために必要なソフトウェアは特にありません。
ただし、PHITSの入力ファイルを作るためには、行番号を表示可能なテキストエディタがインストールされていることが望ましいです(エラーが生じたときに、原因となる入力ファイルの行番号が表示されるため)。
また、画像出力ファイル(EPS形式)を見るためには、Ghostscript及びSumatraPDFをインストールする必要があります。
Windows用のフリーのテキストエディタは、

- TeraPad (日本語)(https://tera-net.com/)
- Notepad++(英語)(https://notepad-plus-plus.org/)

などがあります。
Ghostscript及びSumatraPDFのインストールに関しては、下記のホームページを
ご参照ください。

- Ghostscript (https://www.ghostscript.com/releases/gsdnld.html)
- SumatraPDF(https://www.sumatrapdfreader.org/free-pdf-reader)

SumatraPDFはGhostscriptをインストールした後にインストールしてください。