[English | Japanese] [GFD Dennou Club | Gtool4 Project] [Gt4f90io Reference Manual]
このプログラムは以下の環境での動作を確認しています.
gt4f90io は以下のファイル形式をサポートします.
また, 今後以下のファイル形式がサポートされるといいなと考えています.
gt4f90io を利用するためには, 以下のソフトウェアを 事前にインストールしておく必要があります.
debian を使用していてインストールパッケージを利用する場合
deb パッケージ [Fujitsu ver5 | Intel ver8.1]
上記 deb パッケージの他に netCDF の Development kit もインストールする 必要があります (netcdfg-dev パッケージ).
ソースからコンパイルする場合
ドキュメントを生成するためには以下のソフトウェアを 事前にインストールしておく必要があります. ただし, gt4f90io の TGZ パッケージ から入手する場合には既に生成済みです.
適当な作業ディレクトリでソースアーカイブを展開します. ソースは gt4f90io-バージョン というディレクトリに展開されます.
$ tar xvzf gt4f90io-current.tgz
環境変数 FC に使用する Fortran コンパイラを指定してください. 以下は, 利用するコンパイラが frt の場合です.
sh, bash の場合
$ export FC=frt
csh, tcsh の場合
$ setenv FC frt
最適化やデバッグのためのオプションは環境変数 FFLAGS に設定してください. 以下は frt の高速化と 並列化のためのオプションです.
sh, bash の場合
$ export FFLAGS="-Kfast,parallel"
csh, tcsh の場合
$ setenv FFLAGS "-Kfast,parallel"
展開されたディレクトリに移動し, ./configure を実行します.
--with-netcdf= には netcdf ライブラリのパスを指定します.
(以下の例は /usr/local/netcdf/lib/libnetcdf.a にライブラリがある
場合のものです).
このコマンドによって Config.mk ファイルが生成されます.
$ ./configure --with-netcdf=/usr/local/netcdf/lib/libnetcdf.a
Config.mk ファイルが生成されると同時に, config.cache
ファイルが作成され, オプションの情報が保持されます.
自動的に config.cache が読み込まれるため, 再度 ./configure
する際は前回のオプションが引き継がれます. もしも前回以前のオプション設定を
破棄したい場合には以下のコマンドを用いてください.
$ make distclean
Debian GNU/Linux で Fujitsu Fortran を利用している場合には,
Config.cache.debian-ffc* を config.cache に移動して
./configure コマンドを実行するだけで自動的に
ライブラリの位置が設定されます.
$ cp Config.cache.debian-ffc5 config.cache $ ./configure
なお, インストール先やコンパイルのオプションを変更したい場合は,
以下のように --help オプションをつけることで,
指定可能なオプションリストが表示されます.
$ ./configure --help
主なオプションに関しての説明です.
--with-netcdf=ARG--prefix=ARG /usr/local/gt4f90io です.
--libdir=ARG /usr/local/gt4f90io/lib です.
--includedir=ARG /usr/local/gt4f90io/include です.
--bindir=ARG /usr/local/gt4f90io/bin です.
--with-docdir=ARG /usr/local/gt4f90io/doc です.
--with-fc=ARGconfig.cache に設定されたものを上書きする際に利用してください.
(一度 config.cache に Fortran コンパイラが指定されると,
環境変数 $FC は無視されます).
--with-fflags=ARG--with-gt4libname=ARGlib<ARG>.a となります.
デフォルトは gt4f90io であり, その際のライブラリ名は
libgt4f90io.a となります.
--with-gt4suffix=ARG ffc5 と指定すると,
インストール先のディレクトリのプレフィックスが
/usr/local/gt4f90io-ffc5 , ライブラリ名が
libgt4f90io-ffc5.a , インストールする実行ファイル名は
gt4frt.ffc5 , gt4config.ffc5 等のように
なります.
--with-lang_conform_check=ARG95"
のみ指定可能です. コンパイラによっては指定できません.
--enable-debug--with-abort=ARGabort, errtra-setrcd, exit, setrcd, stop のいずれか
を指定することで, 終了時に用いる Fortran の内部関数を変更することが
可能です. デフォルトは abort です.
環境に合わせ Config.mk を手動で編集してください.
FC : Fortran コンパイラ
SYSFFLAGS : コンパイル時・リンク時に必要なフラグ
(Fortran コンパイラ実行時に必要なオプション)
SYSLDFLAGS : リンク時に必要なフラグ
SYSLDLIBS : リンク時に必要なライブラリ
F90MODTYPE : モジュール情報の渡し方
DEST_LIB : gt4f90io ライブラリインストールディレクトリ
DEST_INC : gt4f90io モジュールインストールディレクトリ
DEST_BIN : gt4f90io 実行ファイルインストールディレクトリ
DEST_DOC : gt4f90io ドキュメントファイルインストールディレクトリ
MODS : モジュールファイル拡張子
AR : アーカイブコマンド
カレントディレクトリで以下のコマンドを実行してください.
$ make
マニュアルとコードリファレンスのコンパイルはカレントディレクトリ において, 以下のコマンドを実行してください. gt4f90io の TGZ パッケージ から入手する場合には既に生成済みです.
$ make doc
カレントディレクトリで以下のコマンドを実行してください. システム領域にインストールする場合には管理者権限が 必要です. (デフォルトの場合はシステム領域にインストールします).
# make install
ドキュメントをインストールする場合には以下のコマンドを実行します.
# make install-doc
カレントディレクトリにおいて, 以下のコマンドを実行してください.
エラーが生じずに
" *** Compilation and installation are succeeded !! *** "
というメッセージが表示されればインストールは完了です.
$ make test-installed
上記のように正しくインストールが行われたら,
gt4frt というシェルスクリプトが --prefix=ARG
で指定されたディレクトリ以下の bin ディレクトリ ARG/bin
に作成されているはずです.
( --prefix= を指定しなかった場合は
/usr/local/gt4f90io/bin/ 以下).
このディレクトリへのパスを通してください.
以下は /usr/local/gt4f90io/bin/ 以下に gt4frt
がインストールされた場合の例です.
sh, bash
$ export PATH=$PATH:/usr/local/gt4f90io/bin
csh, tcsh
$ setenv PATH $PATH:/usr/local/gt4f90io/bin
gt4frt は Fortran コンパイラのラッパーのようなコマンドで, 自動的に gt4f90io ライブラリへリンクをはってコンパイルを行って くれます.
$ gt4frt test.f90
/usr/bin/frt -I/usr/lib/gtool4-ffc4/include -w -Am test.f90 \
-L/usr/lib/gtool4-ffc4/lib -lgtool4 -L/usr/lib -lnetcdf-ffc4