gt4f90ioリファレンスマニュアル

gtool4 netCDF 規約への対応

2004年08月12日 森川靖大


概要

gt4f90io は gtool4 netCDF 規約 に従うデータのI/Oライブラリです。 以下に、gt4f90io によるデータの入出力時に生成および解釈される属性を一覧します。

バージョン

現在、gtool4 netCDF 規約のバージョン 4.2 (2004-07-20T02:44:58+09:00) に対応しています。

生成属性

大域属性

netCDF属性 解説 関係するサブルーチン
Conventions 必ず生成します。属性値は、明示的に指定しない限り、 http://www.gfd-dennou.org/arch/gtool4/conventions/ が与えられます。 HistoryCreate
gt_version 必ず生成します。属性値は、明示的に指定しない限り、 gtool4 netCDF 規約の最新バージョンが与えられます。 現在は 4.2 が属性値として与えられます。 HistoryCreate
title 必ず生成します。属性値はユーザが指定します。 HistoryCreate
source 必ず生成します。属性値はユーザが指定します。 HistoryCreate
institution 必ず生成します。属性値はユーザが指定します。 HistoryCreate
history 必ず生成します。現在は属性値として unknown unknown> gt4_history: HistoryCreate\n が与えられます。 (本当は実行した時間やユーザをちゃんと書き出すべきです)。 HistoryCreate

変数属性

netCDF属性 解説 関係するサブルーチン
long_name 必ず生成します。属性値はユーザが指定します。 ただし例外として、HistoryCopyVariable で変数をコピーする場合、元の変数に long_name が無い時は生成されません。 (本当は強制的にでも生成すべきかも知れません)。 HistoryAddVariable
HistoryCopyVariable
units 必ず生成します。属性値はユーザが指定します。 ただし例外として、HistoryCopyVariable で変数をコピーする場合、元の変数に units が無い時は生成されません。 (本当は強制的にでも生成すべきかも知れません)。 HistoryAddVariable
HistoryCopyVariable

その他の属性

その他に大域属性や変数属性を付加する場合は HistoryAddAttr を用いて下さい。 なお、HistoryAddAttr を用いて属性を付加する場合、 現在の版はその属性や属性値に対して一切のチェックを行ないません。 (本来は行なうべきでしょう)。

解釈属性

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