% 表題   AGCM5 第4部 コードリファレンス NAMELIST 変数リスト(io)
%
% 履歴
\Drireki{92/01/13 沼口敦}
\Drireki{92/08/28 竹広真一}

\section{ヒストリー出力に関する NAMELIST 変数}

ヒストリー出力設定の流れはちょっと複雑で, 次のようになっている. 

\begin{enumerate}
  \item プログラム内の指定によって, 各変数({\tt ITEM})ごとにデフォルト
        が記憶される. これによって, 変数と{\tt ITEM}との結びつき,
        および説明文字列がセットされる.
        さらに, {\tt AVRTYP}および {\tt DMIN,DMAX}等のパラメタのデフォ
        ルト値も変数ごとにセットされる.

  \item 次に {\tt \&NMHISD} の設定が全ての変数に記憶される. 
        ここで指定されなかったものは第1段階の記憶のままである.
        {\tt \&NMHISD}は, 出力時間間隔等の設定が主な役割である.

  \item 最後に各{\tt ITEM}についての設定が{\tt \&NMHIST}によって
        おこなわれる. 
\end{enumerate}

通常, {\tt \&NMHIST}によって指定されなかった変数({\tt ITEM})は,ファイ
ルには出力されない. というのは, デフォルトのファイル指定は, {\tt
NMHISD}によって変更されないかぎり空白であるからである.  {\tt \&NMHIST}
の指定は, {\tt ITEM}とファイルとの結びつきを指定するのに通常用いられる
が,ある特定の変数のみ出力間隔や平均する時間を変更したい場合にも有用で
ある.\vspace{5mm}

ヒストリー出力関係のパラメータはほとんど全て大きさ 2 の配列である.  1 
番目の要素を通常ファイル出力に用いる.  2 番目の要素は通常プリンタ出力
(標準出力)に用いられ,東西平均が出る様に{\tt AVRTYP}が第1段階でセットさ
れている.  {\tt FILE(2)=`CON'}がデフォルトとなっているため,プ
リンタ出力は{\tt \&NMHIST}で指定されない量に関しても行われる.  もちろ
ん, 2番目をプリンタでなくファイルに出すことも可能である.

\subsection{NMHISD}
\label{namelist.nmhisd}
\begin{enumerate}
  \item 設定機能
    \begin{quote}
      ヒストリー出力のデフォルト設定を変更する({\tt HQDEFP}).
      各変数の詳細な説明は {\tt NMHIST} の項を参照せよ. 
    \end{quote}
  \item 設定方法
    \begin{quote}
    \begin{verbatim}
    &NMHISD  FILE   = ' '    'CON', 
             TUNIT  = 'HOUR' 'DAY', 
             INTOUT =   1      60, 
             INTSUM =   1       1, 
             AVRTYP = ' '     'X', 
             DFORM  = 'UR4'  '(1PE12.4)',
             INTEND =  0       0           &END
    \end{verbatim}
    \end{quote}
  \item NAMELIST 変数の説明
    \begin{quote}
    \begin{tabular}{llp{10cm}}
      {\tt FILE} & {\tt (C)} & ファイル名. \\
      {\tt TUNIT} & {\tt (C)}& 時間単位. \\ 
      {\tt INTOUT}& {\tt (I)} & 出力間隔. \\
      {\tt INTSUM} & {\tt (I)} & 積算間隔. \\
      {\tt AVRTYP} & {\tt (C)} & 平均種類. \\
      {\tt DFORM} & {\tt (C)} & 出力フォーマット. \\
      {\tt INTEND} & {\tt (I)} & ENDFILE 処理間隔. \\
    \end{tabular}
    \end{quote}
\end{enumerate}

\subsection{NMHIST}
\label{namelist.nmhist}
\begin{enumerate}
  \item 設定機能
    \begin{quote}
      ヒストリー出力に関する設定. 複数回設定することができる. 
      識別子{\tt ITEM}の出力に関する情報を設定する({\tt HISTOU}). 
    \end{quote}
  \item 設定方法
    \begin{quote}
      \begin{verbatim}
      &NMHIST  ITEM   = ' ',
               FILE   = ' '    'CON', 
               TUNIT  = 'HOUR' 'DAY', 
               INTOUT =  1      60, 
               INTSUM =  1      1, 
               AVRTYP = ' '    'X', 
               DFORM  = 'UR4'  '(1PE12.3)',
               INTEND =  0      0 ,
               VMISS =   -999., 
               DMIN  =   -999.,   DMAX=   -999.00000000000 ,
               DIVS  =   -999.,   DIVL=   -999.00000000000, 
               ISTYP =  1                                    &END
      \end{verbatim}
    \end{quote}
  \item NAMELIST 変数の説明
    \begin{quote}
    \begin{tabular}{llp{10cm}}
      {\tt ITEM}  & {\tt (C)} & データ識別子. \\
      {\tt FILE}  & {\tt (C)} & ファイル指定. \\
      {\tt TUNIT} & {\tt (C)} & 時間単位.\\
      {\tt INTOUT}& {\tt (I)} & 出力間隔.\\
      {\tt INTSUM}& {\tt (I)} & データの積算時間.{\tt INTSUM=0}なら瞬
                                間値であり, {\tt INTSUM=INTOUT}なら
                                前の出力からの積算値(または平均値)となる. \\
      {\tt AVRTYP}& {\tt (C)} & 空間平均のとりかた. 
                                {\tt ' '}(3次元そのままの値), 
                                {\tt 'X-AVG'}(東西平均) , 
                                {\tt 'XZ-AVG'}(東西鉛直平均), 
                                {\tt 'XYZ-AVG'}(全球平均)などが指定で
                                きる. \\
      {\tt DFORM} & {\tt (C)} & データの形式. 通常{\tt 'UR4'}. \\
      {\tt INTEND}& {\tt (I)} & 幾つデータを書いたら{\tt ENDFILE}処理
                               をするかを指定する. 
                               通常は0としてこの機能を使わない. \\
      {\tt VMISS} & {\tt (R)} & 欠損値 \\
      {\tt DMIN}  & {\tt (R)} & データ値の範囲(下限) \\
      {\tt DMAX}  & {\tt (R)} & データ値の範囲(上限) \\
      {\tt DIVS}  & {\tt (R)} & 作図用のパラメター. 
                                目盛の間隔(小) \\
      {\tt DIVL}  & {\tt (R)} & 作図用のパラメター. 
                                目盛の間隔(大) \\
      {\tt ISTYP} & {\tt (I)} & 作図用のパラメター. 軸の種類 \\
    \end{tabular}
  \end{quote}
  \item 備考. 
  \begin{quote}
     GTOOL3 のパラメータの多くは
     プログラム内で適当にセットされる. 
  \end{quote}
\end{enumerate}


\subsection{NMMONI}
\label{namelist.nmmoni}
\begin{enumerate}
  \item 設定機能
    \begin{quote}
      モニター出力の設定({\tt HMONIT}).
      これらは, {\tt FILE(2)}の指定によって標準出力に出す場合の
      出力する点を指定するものである. \\
      {\tt (((DATA(I,J,K),I=ISTR,IEND,IINT),J=JSTR,JEND,JINT),K=KSTR,KEND,KINT)}
      という点でフォーマット({\tt DFORM(2)}にしたがう)付きで出力される.
    \end{quote}
  \item 設定方法(デフォルト値\footnotemark)
            \footnotetext[1]{
                  {\tt IEND, JEND, KEND} のデフォルトはモデル解像度 
                  {\tt zcdim.F} で設定されるパラメター 
                  {\tt IMAX, JMAX, KMAXP1} で与えられる. }
    \begin{quote}
    \begin{verbatim}
     &NMMONI  ISTR=  1, IEND=  1, IINT=  10, 
              JSTR=  1, JEND=  1, JINT=  10, 
              KSTR=  1, KEND=  46, KINT=  1, 
              FILE='CON', 
              NCOLS=133                         &END
    \end{verbatim}
    \end{quote}
  \item NAMELIST 変数の説明
    \begin{quote}
    \begin{tabular}{llp{10cm}}
      {\tt ISTR, IEND, IINT} & {\tt (I)} & 第 1 座標(経度)の設定\\
      {\tt JSTR, JEND, JINT} & {\tt (I)} & 第 2 座標(緯度)の設定\\
      {\tt KSTR, KEND, KINT} & {\tt (I)} & 第 3 座標(鉛直)の設定\\
      {\tt FILE}  & {\tt (C*NFILN)} & 出力ファイル名\\
      {\tt NCOLS} & {\tt (I)}       & 出力の一行の長さ\\
    \end{tabular}
    \end{quote}
\end{enumerate}

\section{診断出力に関する NAMELIST 変数}

\subsection{NMDIAG}
\label{namelist.nmdiag}
\begin{enumerate}
  \item 設定機能
    \begin{quote}
       診断出力に関する設定({\tt QDIAGP}). 
    \end{quote}
  \item 設定方法(デフォルト値)
    \begin{quote}
    \begin{verbatim}
    &NMDIAG  FILE='CON', 
             UNIT='DAY ', 
             INTDIA= 10, 
             IDIAG=   1, JDIAG=  1, KDIAG=  -1, 
             NCOLS=  132                          &END
    \end{verbatim}
    \end{quote}
  \item NAMELIST 変数の説明
    \begin{quote}
    \begin{tabular}{llp{10cm}}
      {\tt FILE}   & {\tt (C*38)} & {\tt 'CON'}とすると標準出力に出力される. \\
      {\tt UNIT}   & {\tt (C*4)} & 時間単位\\
      {\tt INTDIA} & {\tt (I)} & 時間間隔.\\
      {\tt IDIAG}  & {\tt (I)} & モニターする点の指定. 
                                 経度座標をグリッド番号で指定する. 
                                 負にすると 1 から指定値の絶対値の間隔
                                 で複数の点について出力される.  \\
      {\tt JDIAG}  & {\tt (I)} & 経度座標であることを除いて
                                 {\tt IDIAG} と同様. \\
      {\tt KDIAG}  & {\tt (I)} & 鉛直座標であることを除いて
                                 {\tt IDIAG} と同様. \\
      {\tt NCOLS}  & {\tt (I)} & 出力の一行の行数. 
    \end{tabular}
  \end{quote}
\end{enumerate}

