% 表題   AGCM5 guide インストール
%
% 履歴 
\Drireki{94/01/13  保坂征宏}
%
\Dchapterhead

\section{インストールの前に}

\subsection{ありか}

現在の AGCM5 は,
\begin{verbatim}
    dennou:/usr/local/src/ftp/saloon/dennou_develop/model/agcm/agcm5
\end{verbatim}
以下に格納されている. 
\vspace{1em}

なお, agcm5 をインストール・実行するためには, 
dcl, gtool3, sysmake が必要である. 
これらの資源のありかは, 
\begin{verbatim}
    dennou:/usr/local/src/ftp/saloon/dennou/util/dcl
    dennou:/usr/local/src/ftp/saloon/dennou_develop/util/gtool
    dennou:/usr/local/src/ftp/saloon/dennou_develop/util/sysmake
\end{verbatim}
である. これらをインストールしていない場合は適宜インストールすること. 

\subsection{注意: 標準使用ルール}

agcm5 を使用するにあたり, 態度を
\begin{itemize}
  \item 他の使用者の使用法との対応を付けながら, 
        目的の一つとして共有財産を増やすことを念頭において使用する. 
  \item あくまで個人的に使用する. このような使用法をするのは例えば,  
   \begin{itemize}
     \item 元のモデルを大きく変形するために対応付けが困難な場合. \\
           この場合は自力でモデルを構成し直す根性が必要である. 
     \item 作業において失敗する可能性が高く, 既存の財産を破壊する可能
           性がある場合. 
   \end{itemize}
        である. 
\end{itemize}
のいずれかに決める必要がある. 
この節では前者の態度をとる場合の, 実験の仕方での基本的なルールを書くことにする. 
\vspace{1em}

\begin{itemize}
\item make の使用. \\
      unix を使う人が多いので, コンパイル, リンク, 実行ファイル作成に
      は make を使うのが標準的である. 当然スーパーコンピュータの多くは
      make でコンパイルすることなどはできないが, その場合でも unix か
      らスーパーコンピュータへの資源の転送のために make を使うことが奨
      励されている. 
      \vspace{1em}

      make は \verb!src! 直下で行なうが, 
      基本的にユーザは \verb!src/Makefile! を編集しない. 
      機種に依存する環境変数の設定は sysmake で行なう. 
      実験の設定は Mkinclude で行なう. 

\item モデルの変更.\\
      GCM を用いて実験するに当たり, パラメタのちょっとした変更, ソース
      の変更をすることがあろう. 
  \begin{itemize}
  \item パラメタの変更. \\
        agcm5 ではパラメタの変更は 
        \verb!NAMELIST! を使って行なうのが標準的である. 
  \item ソースの変更. \\
        ソースを変更する場合は変更したファイルを \verb!src/usr/! 
        下におき, \verb!Mkinclude! で指定するのが標準的である. 例えば, 
        ユーザー pochaka が \verb!src/util/uspst.F! を自作の 
        \verb!puspst.F! に差し替えたい場合は, \verb!puspst.F! を 
        \verb!src/usr/pochaka/util/puspst.F! におき, \verb!Mkinclude! で
        しかるべく差し替えるように設定することになる\footnotemark. \\
         \footnotetext{
              詳細になるが, 
              ライブラリは標準ファイルをコンパイルしたものから構成され, 
              自作の実行ファイルは実行ファイルを作成する際にはじめてリ
              ンクされる.}
        \verb!include, prep! を除く他のディレクトリのファイルを直接変
  \item 標準的に良く用いられるファイルへの差し替え.\\
        良く使われる差し替え用ファイルは \verb!src/nonstd/! ディ
        レクトリに格納されている. これらを使いたい場合もやはり 
        \verb!Mkinclude! で指定して使用する.
  \end{itemize}
\item 資源の置き場. \\
  dcl, gtool3 といった資源の他, agcm5 のライブラリ, 実行ファイル,
  sysmake の置き場はサイト毎に決めておく. 
\end{itemize}

