gtool4 netCDF データの入出力インターフェース

Interface of Input/Output of gtool4 netCDF data

gtool_history モジュールは, 数値モデルの結果を gtool4 netCDF 規約 に基づくデータ形式 (以降, gtool4 データと呼びます) で出力するためのインターフェースです. 主に時間積分の結果を等時間間隔で出力することを念頭においてます. このモジュールを用いれば, Fortran90 で書かれたプログラムの計算結果を gtool4 データで出力することが簡単に実現できます.

なお, Fortran77 用のインターフェースとして, HSPACK も用意しています.

Tutorial

• gtool5 オフィシャルチュートリアル:
  • データ出力のための最低限の設定
  • 使われているサブルーチンの説明
  • 属性(attribute)をつける
  • 複数のファイルに出力
  • ファイルから初期値を入力

Prepare

以下の use 文を Fortran 90 プログラムの先頭に書き込んでください. 本 gtool_history モジュール内の手続きと構造型変数が 利用できるようになります.

    use gtool_history

Procedures List

gtool_history_generic を参照ください.

See "gtool_history_generic".

Derived types

gtool_history_types を参照ください.

See "gtool_history_types".

gtool4 netCDF 規約との対応

バージョン gtool4_netCDF_version に対応しています。

生成系

出力するデータには以下の大域属性を必ず与えます。

netCDF属性:	与えられる値
Conventions :	ユーザによる指定が無い限り gtool_history_internal#gtool4_netCDF_Conventions が与えられます.
gt_version :	ユーザによる指定が無い限り gtool_history_internal#gtool4_netCDF_version が与えられます.
title :	ユーザによって指定されます.
source :	ユーザによって指定されます.
institution :	ユーザによって指定されます.
history :	"unknown 2005-08-05T21:48:37+09:00> gtool_history: HistoryCreate\n" といった値が与えられます. "unknown" の部分には, 環境変数 USER から取得される ユーザ名が与えられます. その後ろにはファイルの生成を 開始した時刻が与えられます.

出力するデータの変数には以下の属性を必ず与えます.

netCDF属性:	与えられる値
long_name :	ユーザによって指定されます.
units :	ユーザによって指定されます.

この他の属性に関して HistoryAddAttr などによって任意に与えることは 可能です. 禁止の属性に関しては警告を発するべきですが, 現在は チェックを行っていません.

解釈系

原則的に, 現在の gtool_history は全ての属性の解釈を行ないません. 本来ならば, HistoryGet は scale_factor, add_offset, valid_range などの属性を解釈すべきかも知れません. ただし, HistoryCopyVariable は変数コピーの際, 変数に属する全ての属性と その値を引き継ぎます.