[English | Japanese] [GFD Dennou Club | DCPAM]

DCPAM インストールガイド

森川靖大 (morikawa), 石渡正樹 (momoko)
- $Id: INSTALL,v 1.8 2005/06/20 19:28:25 morikawa Exp $

動作環境

このプログラムは以下のコンパイラでの動作を確認しています。

Debian GNU/Linux 3.0, 3.1 + Fujitsu Fortran Version 5.0 (in JAPANESE)

コンパイルに必要なライブラリ

DCPAM2 のインストール・実行するためには以下のソフトウエアを事前にインストールしておく必要があります.

netCDF (バージョン 3.5.0, 3.6.0)
- 3.6.0 版 TGZ, deb パッケージ [Fujitsu ver5 | Intel ver8.1]
- インストールガイド
  - [Unidata 本家 NetCDFクイックインストールガイド (英語) | (日本語訳) ]
    - [Unidata 本家のインストールガイドの目次]
gt4f90io (バージョン 20050207 以上)
- 最新版 TGZ, deb パッケージ [Fujitsu ver5 | Intel ver8.1]
- インストールガイド
ISPACK (バージョン 0.61)
- 最新版 TGZ, deb パッケージ [Fujitsu ver5 | Intel ver8.1]
- インストールガイド
  - 上記 tar.gz を展開した際にできる README を参照してください.
spmodel (バージョン 0.3.0-9 以上)
- 最新版 TGZ, deb パッケージ [Fujitsu ver5, ssl2 | Intel ver8.1, lapack]
- インストールガイド

CVS から最新版を取得して, ドキュメントを生成するためには以下のソフトウェアを事前にインストールしておく必要があります. (tar.gz パッケージには既にドキュメントが同梱しています)

LaTeX
- スタイルファイル: Dennou6 style
latex2html に日本語パッチ, Dennou6 style パッチをあてたもの
ruby
rdtool
rd2latex-lib

コンパイルの手引き

TGZ パッケージの展開

適当な作業ディレクトリでソースアーカイブを展開します. ソースは dcpam2-バージョン というディレクトリに展開されます.

$ tar xvzf dcpam2-current.tgz

Fortran コンパイラの指定

環境変数 FC に使用する Fortran コンパイラを指定してください. 以下は, 利用するコンパイラが frt の場合です.

sh, bash の場合
```
$ export FC=frt
```
csh, tcsh の場合
```
$ setenv FC frt
```

最適化やデバッグのためのオプションは環境変数 FFLAGS または FCFLAGS に設定してください. 以下は frt の高速化と並列化のためのオプションです.

sh, bash の場合
```
$ export FCFLAGS="-Kfast,parallel"
```
csh, tcsh の場合
```
$ setenv FCFLAGS "-Kfast,parallel"
```

Config.mk の作成

展開されたディレクトリに移動し, ./configure を実行します. コンパイルに必要なライブラリでインストールした各ライブラリを以下のオプションに指定する必要があります.

--with-ispack=ARG: ispack ライブラリ (*.a) のファイル名
--with-netcdf=ARG: netcdf ライブラリ (*.a) のファイル名
--with-gt4f90io=ARG: gt4f90io ライブラリ (*.a) のファイル名
--with-spml=ARG: spmodel ライブラリ (*.a) のファイル名

例えば以下のように指定します. このコマンドによって Config.mk ファイルが生成されます.

$ ./configure --with-ispack=/usr/local/lib/libisp.a \
              --with-netcdf=/usr/local/lib/libnetcdf.a \
              --with-gt4f90io=/usr/local/lib/gt4f90io/lib/libgt4f90io.a \
              --with-spml=/usr/local/lib/spml/lib/libspml.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

主なオプションに関しての説明です.

--prefix=ARG: ARG にライブラリやモジュール, 実行ファイルのインストール先のディレクトリのプレフィックスを指定します. デフォルトは /usr/local/dcpam2 です.
--libdir=ARG: ARG にライブラリのインストール先のディレクトリを指定します. デフォルトは /usr/local/dcpam2/lib です.
--includedir=ARG: ARG にモジュール情報ファイルのインストール先のディレクトリを指定します. デフォルトは /usr/local/dcpam2/include です.
--bindir=ARG: ARG に実行ファイルのインストール先のディレクトリを指定します. デフォルトは /usr/local/dcpam2/bin です.
--with-docdir=ARG: ARG にドキュメントファイルのインストール先を指定します. デフォルトは /usr/local/dcpam2/doc です.
--with-fc=ARG: Fortran コンパイラを指定します. 環境変数 $FC よりも優先されます. config.cache に設定されたものを上書きする際に利用してください. (一度 config.cache に Fortran コンパイラが指定されると, 環境変数 $FC は無視されます).
--with-fflags=ARG: Fortran のデバッグや最適化のオプションを指定します. 環境変数 $FFLAGS や $FCFLAGS が指定される場合, このオプションで与えられるものも含め, 全てコンパイル時のオプションとして指定されます. (重複に注意してください).
--with-dcpam_lib_name=ARG: ARG に dcpam2 のライブラリ名を指定します. ライブラリ名は lib<ARG>.a となります. デフォルトは dcpam2 であり, その際のライブラリ名は libdcpam2.a となります.
--with-dcpam_suffix=ARG: ARG にはインストールディレクトリ, ライブラリ名, 実行ファイルの末尾につける接尾語を指定します. 例えば, 他が全てデフォルトの設定で ffc5 と指定すると, インストール先のディレクトリのプレフィックスが /usr/local/dcpam2-ffc5 , ライブラリ名が libdcpam2-ffc5.a 等のようになります.
--with-lang_conform_check=ARG: ARG に言語規格を指定することで, コンパイル時に言語規格のチェックを行うよう, オプションを追加します. 現在 "95" のみ指定可能です. コンパイラによっては指定できません.
--enable-debug: このオプションを指定することで, コンパイル時や実行時にデバッグメッセージを出力するオプションを追加します. コンパイラによっては指定できません.