% 表題   らくらく DCPAM5  --- 出力設定を変更するには
%
% 履歴 
%\Drireki{2012/02/24 竹広真一}
%
\section{出力設定を変更するには}

解析用のヒストリデータの出力に関する設定は
{\bf \&gtool\_historyauto\_nml} を編集することで変更する.
例えば設定ファイルの例である  dcpam\_hs94\_T21L20.conf
\footnote{
  \url{http://www.gfd-dennou.org/www.gfd-dennou.org/library/dcpam/dcpam5/dcpam5_latest/exp_setup_files/dcpam_hs94_T21L20.conf}
}
には下のように設定されている. 
%
\begin{verbatim}
  ! ヒストリデータ出力の全体設定
  ! Global settings about history data output
  !
  &gtool_historyauto_nml
    IntValue = 1.0,
                                ! ヒストリデータの出力間隔の数値. 
                                ! 負の値を与えると, 出力を抑止します. 
                                !
                                ! Numerical value for interval of history data output
                                ! Negative values suppress output.
    IntUnit = 'day',
                                ! ヒストリデータの出力間隔の単位. 
                                ! Unit for interval of history data output
    Precision = 'float',     ! 単精度
                                ! ヒストリデータの精度. 
                                ! Precision of history data
    FilePrefix = '',
                                ! ヒストリデータのファイル名の接頭詞. 
                                ! Prefixes of history data filenames
  /
  !
  ! ヒストリデータ出力の個別設定
  ! Individual settings about history data output
  !
  &gtool_historyauto_nml
    Name = 'U, V, Temp, Ps, QVap, Vor, Div, SigDot, DPiDt'
  /
  &gtool_historyauto_nml
    Name = 'Mass, KinEngy, IntEngy, PotEngy, LatEngy, TotEngy, Enstro', 
    SpaceAverage = .true., .true., .true., .true., .true.
  /
\end{verbatim}

それぞれの設定項目について以下に記す.
%
\begin{description}
  \item {\bf IntValue}\\
    (実数型) 出力間隔の数値


  \item {\bf IntUnit} \\
    (文字型) 出力間隔の単位. 
    "sec", "min", "hour", "day", "month", "year" などが使用可能である.
    使用可能な単位の詳細については, 
    gtool5 ライブラリ: dc\_date\_types モジュール
    \url{http://www.gfd-dennou.org/library/gtool/gtool5/gtool5_current/doc/code_reference/classes/dc_date_types.html} の
    "Characters list for unit" を参照されたい. 

  \item {\bf Precision}\\
    (文字型) データの精度. "float" (単精度実数型), "double" (倍精度実数型), "int" (整数型) を指定可能
  

  \item {\bf SpaceAverage}\\
    (論理型配列) 空間平均のフラグ. 
    配列の 1 番目, 2 番目, 3 番目が, 経度, 緯度, 高度(σ) に対応する.

  \item {\bf TimeAverage}\\
    (論理型配列) 時間平均のフラグ. 
\end{description}
%
{\bf Name} を指定しない, もしくは空文字を与えた場合,
それは全ての変数に対するデフォルト設定となる.
その場合にのみ有効な項目として以下のものがある. 
%
\begin{description}
  \item {\bf FilePrefix}\\
    (文字型) データのファイル名の接頭詞.
    例えば "exp1-" と指定すれば, 変数 "U" の出力ファイル名は "exp1-U.nc" となる.
    また, "data01/" のようにスラッシュを含む文字列を指定することで,
    カレントディレクトリ以外の場所に出力するよう設定することも可能である. 
\end{description}
%
出力時間間隔などは, これらの値を編集することで変更することができる. 

より詳しい説明については,
gtool5 チュートリアル: 多数のファイル出力を行うモデルでのデータ出力 -- 設定可能な項目\url{http://www.gfd-dennou.org/library/gtool/gtool5/gtool5_current/doc/tutorial/gtauto_first.htm#label-7}
を参照されたい. 

また, さらに出力する変数を追加する場合には, 
%
\begin{verbatim}
  &gtool_historyauto_nml
    Name = 'U, V, Temp, Ps, QVap, Vor, Div, SigDot, DPiDt'
  /
\end{verbatim}
%
の {\bf Name} の行に変数名を追加すか, 新たに下のように行を追加する. 
%
\begin{verbatim}
  &gtool_historyauto_nml
    Name = 'XXX'
  /
\end{verbatim}


%%% Local Variables: 
%%% mode: japanese-latex
%%% TeX-master: "../rakuraku"
%%% End: 
