# # dcpam4 Installation Guide in RD (Ruby Document) format # # For instruction of installing dcpam, # see "INSTALL.htm.en" (English) or "INSTALL.htm" (Japanese) # included in "dcpam4" tar.gz package # available from http://www.gfd-dennou.org/library/dcpam. # Otherwise, see this file directly, or generate # above mentioned html files with "make guide" # in current directory after installing rdtool # . =begin JA = dcpam4 インストールガイド #* 森川 靖大 (morikawa), 石渡 正樹 (momoko) # * $Id: INSTALL,v 1.6 2007/07/30 10:29:24 morikawa Exp $ =end JA =begin EN = dcpam4 Installation Guide #* Yasuhiro MORIKAWA (morikawa), Masaki ISHIWARARI (momoko) # * $Id: INSTALL,v 1.6 2007/07/30 10:29:24 morikawa Exp $ =end EN =begin JA == 動作環境 このプログラムは以下のコンパイラでの動作を確認しています。 =end JA =begin EN == Operation Environment This program is operated by following compilers. =end EN =begin * ((<"Debian GNU/Linux 3.1"|URL:http://www.debian.org/>)) + (()) * ((<"Debian GNU/Linux 3.1 "|URL:http://www.debian.org/ >)) + (()) * ((<"Debian GNU/Linux 3.1 "|URL:http://www.debian.org/ >)) + (()) =end #=begin JA #過去には以下の環境でも動作したことが確認されています. #確認はしていませんが, 現在のバージョンでもおそらく動作すると期待されます. #=end JA #=begin EN #dcpam4 was operated by following environments in the past. #Latest version may be operated (unconfirmed). #=end EN # #=begin # * Windows Vista + G95 Fortran # * Windows Vista + Intel Visual Fortran 9.1.032 # * Windows Vista + Compaq Visual Fortran 6.6 # * HITACHI SR11000 + IBM XL Fortran Enterprise Edition for AIX5L # * HITACHI SR11000 + Optimizing FORTRAN90 Compiler # * NEC SX-6 + FORTRAN90/SX # * FUJITSU VPP-5000 + VPP Fortran #=end #=begin JA #== インストールの流れ # #dcpam4 のインストールは以下のように行います. #詳しくは各項目を参照してください. # # (1) ((<必要なソフトウェア>)) をインストールします. # (2) ((<ビルドの手引き>)) に従い, ソースからライブラリをビルドします. # (3) ((<サンプルプログラム実行の手順>)) に従い, インストールされた # ライブラリが正常に機能するかどうか確認してください. # #=== インストールの例 # #(()) #の「チュートリアル」では, インストールの実例も紹介されています. #インストールがうまくいかない場合は参照してください. # # #=== Debian GNU/Linux ユーザのみなさまへ # #Debian GNU/Linux を使用している場合は, #(()) #にて配布しているバイナリパッケージも利用できます. # #=end JA # #=begin EN #== General outline # #Install dcpam4 as follows. Refer each items for details. # # (1) Satisfy (()). # (2) Build the library following (()). # (3) Check whether the installed library functions normally # following (()). # #=== Install example # #There are examples of installation in "Tutorial" on #(()). #Refer them if the installation is not successful. # #=== For Debian GNU/Linux users # #When you are using Debian GNU/Linux, binary packages distributed with #(()) #can be used. # #=end EN =begin JA == 必要なソフトウェア dcpam4 を利用するためには以下のソフトウエアを 事前にインストールしておく必要があります. : (()) (バージョン 3.6.2 以上) Debian GNU/Linux を使用しており, バイナリパッケージを利用する場合 * debian パッケージ [(()) | (()) | (())] 上記 deb パッケージの他に netCDF の Development kit (((*netcdf-bin*)) パッケージ) もインストールする必要があります . ソースからビルドする場合 * ((<3.6.2 版 ソースのTGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/netcdf-3.6.2.tar.gz>)) [(()) | ((<(日本語訳)|URL:INSTALL_netcdf.htm>)) ] [(())] : (()) (バージョン 20070729 以上) Debian GNU/Linux を使用しており, バイナリパッケージを利用する場合 * debian パッケージ [(()) | (()) | (())] ソースからビルドする場合 * ((<最新バージョン TGZ|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io_current.tgz>)) ((<インストールガイド|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io_current/INSTALL.htm>)) : (()) (バージョン 0.71) Debian GNU/Linux を使用しており, バイナリパッケージを利用する場合 * debian パッケージ [(()) | (()) | (())] ソースからビルドする場合 * ((<バージョン 0.71 TGZ|URL:http://www.gfd-dennou.org/library/ispack/ispack-0.71.tar.gz>)) インストールの際は, 上記 tar.gz を展開して README を参照してください. : (()) (バージョン 0.4.1) Debian GNU/Linux を使用しており, バイナリパッケージを利用する場合 * debian パッケージ [(()) | (()) | (())] ソースからビルドする場合 * ((<最新版 TGZ|URL:http://www.gfd-dennou.org/library/spmodel/spml.tar.gz>)) ((<インストールガイド|URL:http://www.gfd-dennou.org/library/spmodel/spml/INSTALL>)) === 開発者にとって必要なソフトウェア CVS から最新版を取得して, ソースコードを改変したり, ドキュメントを生成するためには以下の ソフトウェアを事前にインストールしておく必要があります. (tar.gz パッケージには既にドキュメントが同梱しています) * (()) * スタイルファイル: (()) * (()) * (()) * (()) * ((<"RDoc Fortran90/95 ソースコード解析機能強化版"|URL:http://www.gfd-dennou.org/library/dcmodel>)) #* (()) #* (()) =end JA =begin EN == Software Requirements Following softwares should be installed for installing dcpam. : (()) (version 3.6.2 or more) Debian GNU/Linux (use binary packages) * debian packages [(()) | (()) | (())] If you use above Debian package to install netCDF, you need ((* "netcdf-bin" *)) package too. (Parhaps you can get by "apt-get"). Build from source codes * (()), [(())] * [(())] : (()) (version 20070729 or more) Debian GNU/Linux (use binary packages) * debian packages [(()) | (()) | (())] Build from source codes * (()) (()) : (()) (version 0.71) Debian GNU/Linux (use binary packages) * debian packages [(()) | (()) | (())] Build from source codes * (()) See "README" file in above tar.gz file. (but that is wrote in JAPANESE) : (()) (version 0.4.1) Debian GNU/Linux (use binary packages) * debian packages [(()) | (()) | (())] Build from source codes * (()) (()) === Software Requirements for developers If you get dcpam from CVS. Following softwares should be installed for modification of source code and generation of documentations. (But if you get tar.gz package, documentations are already generated). * (()) * Style file: (()) * (()) * (()) * (()) * ((<"Enhanced version of RDoc Fortran90/95 parser"|URL:http://www.gfd-dennou.org/library/dcmodel>)) #* (()) #* (()) =end EN =begin JA == ビルドの手引き =end JA =begin EN == How to build =end EN =begin JA === TGZ パッケージの展開 適当な作業ディレクトリで以下のようにソースアーカイブを展開します. ソースは dcpam4-((|バージョン|)) というディレクトリに展開されます. $ tar xvzf dcpam4_current.tgz または $ zcat dcpam4_current.tar.gz | tar -xvf - =end JA =begin EN === Extract TGZ Package Make an empty directory, and extract archive as follows. A directory `dcpam4-((|version|))' created at the current working directory. $ tar xvzf dcpam4_current.tgz or $ zcat dcpam4_current.tar.gz | tar -xvf - =end EN =begin JA === Fortran コンパイラの指定 環境変数 ((* FC *)) に使用する Fortran コンパイラを指定してください. 以下は, 利用するコンパイラが frt の場合です. * sh, bash の場合 $ FC=frt ; export FC * csh, tcsh の場合 $ setenv FC frt 最適化やデバッグのためのオプションは環境変数 ((* FFLAGS *)) に設定してください. 以下は frt の高速化と 並列化のためのオプションです. * sh, bash の場合 $ FFLAGS="-Kfast,parallel" ; export FFLAGS * csh, tcsh の場合 $ setenv FFLAGS "-Kfast,parallel" =end JA =begin EN === Specify Fortran Compiler Specify Fortran compiler to environmental variable ((* FC *)). For example, if you use "frt", * sh, bash $ FC=frt ; export FC * csh, tcsh $ setenv FC frt Specify Fortran compiler options for optimization and debug to environmental variable ((* FFLAGS *)). For example, if you set options for automatic optimization and automatic parallelization to "frt", * sh, bash $ FFLAGS="-Kfast,parallel" ; export FFLAGS * csh, tcsh $ setenv FFLAGS "-Kfast,parallel" =end EN =begin JA === 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 \ ビルドには GNU make が必要となるため, configure は PATH 内から 自動で GNU make を探査しようとしますが, もし見つからない場合, エラーを返します. その場合には環境変数 ((* MAKE *)) に GNU make コマンドを指定して再度 configure を実行してください. インストール先などを変更したい場合は, 以下のように (({ --help })) オプ ションをつけることで, 指定可能なオプションリストが表示されます. $ ./configure --help 主なオプションに関しての説明です. :(({--prefix=}))((|ARG|)) ((|ARG|)) にライブラリやモジュール, 実行ファイルのインストール先の ディレクトリのプレフィックスを指定します. デフォルトは (({ /usr/local/dcpam4 })) です. :(({--libdir=}))((|ARG|)) ((|ARG|)) にライブラリのインストール先のディレクトリを指定します. デフォルトは (({ /usr/local/dcpam4/lib })) です. :(({--includedir=}))((|ARG|)) ((|ARG|)) にモジュール情報ファイルのインストール先のディレクトリ を指定します. デフォルトは (({ /usr/local/dcpam4/include })) です. :(({--bindir=}))((|ARG|)) ((|ARG|)) に実行ファイルのインストール先のディレクトリを指定します. デフォルトは (({ /usr/local/dcpam4/bin })) です. :(({--with-docdir=}))((|ARG|)) ((|ARG|)) にドキュメントファイルのインストール先を指定します. デフォルトは (({ /usr/local/dcpam4/doc })) です. :(({--with-dcpam_lib_name=}))((|ARG|)) ((|ARG|)) に dcpam4 のライブラリ名を指定します. ライブラリ名は (({lib}))((||))(({.a})) となります. デフォルトは (({ dcpam4 })) であり, その際のライブラリ名は (({ libdcpam4.a })) となります. :(({--with-dcpam_suffix=}))((|ARG|)) ((|ARG|)) にはインストールディレクトリ, ライブラリ名, 実行ファイルの末尾につける接尾語を指定します. 例えば, 他が全てデフォルトの設定で (({ ffc5 })) と指定すると, インストール先のディレクトリのプレフィックスが (({ /usr/local/dcpam4-ffc5 })), ライブラリ名が (({ libdcpam4-ffc5.a }))等のようになります. :(({--with-lang_conform_check=}))((|ARG|)) ((|ARG|)) に言語規格を指定することで, コンパイル時に言語規格の チェックを行うよう, オプションを追加します. 現在 "(({95}))" のみ指定可能です. コンパイラによっては指定できません. :(({--enable-debug})) このオプションを指定することで, コンパイル時や実行時にデバッグメッセージ を出力するオプションを追加します. コンパイラによっては指定できません. :(({--config-cache})) または (({-C})) (({ Config.mk })) ファイルが生成されると同時に, (({config.cache})) ファイルが作成され, (({ ./configure })) の引数に指定された netCDF ライブラリの位置などの情報が保持されます. 再度 (({ ./configure })) を実行する際にもこのオプションを指定することで, (({config.cache})) が読み込まれ, 前回指定したオプション等が引き継がれます. 既に存在する (({config.cache})) を無視する場合はこのオプションを 指定せずに (({ ./configure })) を実行してください. 例えば下記のように (({ ./configure })) を実行するとします. $ ./configure -C --enable-debug \ --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 \ すると次回以降, 下記のように (({ ./configure })) を実行することで netCDF ライブラリ等の位置や, デバッグオプションを付加する情報が 引き継がれます. $ ./configure -C Debian GNU/Linux で Fujitsu Fortran を利用している場合には, Config.cache.debian-ffc* を (({config.cache})) に移動して (({ ./configure })) コマンドを実行するだけで自動的に ライブラリの位置が設定されます. $ cp Config.cache.debian-ffc5 config.cache $ ./configure -C =end JA =begin EN === Create `Config.mk' Move created directroy, and excute `(({ ./configure }))'. Specify library files in (()) to following options. :(({--with-ispack=}))((|ARG|)) ispack library filename (*.a) :(({--with-netcdf=}))((|ARG|)) netcdf library filename (*.a) :(({--with-gt4f90io=}))((|ARG|)) gt4f90io library filename (*.a) :(({--with-spml=}))((|ARG|)) spmodel library filename (*.a) For exapmle, specify as follow. This command will generate (({ 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 \ GNU make is needed to build, so configure automatically inquires into GNU make in PATH. However, it returns error when GNU make is not found. In that case, please set the GNU make command for environment variable ((* MAKE *)). And rerun execute `(({ ./configure }))'. If you want to change directory to which the library and the module, etc. are installed, please set (({ --help })) option as follow. Available options are showed. $ ./configure --help Descriptions about principal options are listed below. :(({--prefix=}))((|ARG|)) Specify prefix to ((|ARG|)). Default value is (({ /usr/local/dcpam4 })). :(({--libdir=}))((|ARG|)) Specify directory to which the library is installed to ((|ARG|)). Default value is (({ /usr/local/dcpam4/lib })). :(({--includedir=}))((|ARG|)) Specify directory to which the module is installed to ((|ARG|)). Default value is (({ /usr/local/dcpam4/include })). :(({--bindir=}))((|ARG|)) Specify directory to which the executable file is installed to ((|ARG|)). Default value is (({ /usr/local/dcpam4/bin })). :(({--with-docdir=}))((|ARG|)) Specify directory to which the documentation file is installed to ((|ARG|)). Default value is (({ /usr/local/dcpam4/doc })). :(({--with-dcpam_lib_name=}))((|ARG|)) Specify dcpam4 library name to ((|ARG|)). Library name becomes (({lib}))((||))(({.a})) . Default value is (({ dcpam4 })), so library name becomes (({ libdcpam4.a })) . :(({--with-dcpam_suffix=}))((|ARG|)) Specify suffix of installdir, library name, executable files to((|ARG|)). For example, you specify (({ ffc5 })) when others are default, prefix of installdir becomes (({ /usr/local/dcpam4-ffc5 })), library name becomes (({ libdcpam4-ffc5.a })), executable files become (({ gt4frt.ffc5 })), (({ gt4config.ffc5 })). :(({--with-lang_conform_check=}))((|ARG|)) Specify language standard to ((|ARG|)). And when you compile source code, check the language standard conformance. Now, "(({95}))" is valid. The compiler that can be used is limited. :(({--enable-debug})) When you compile source code and execute binary file, output debug messages. The compiler that can be used is limited. :(({--config-cache or -C})) (({ config.cache })) is created at the same time as (({ Config.mk }))'s being generated. (({ config.cache })) stores information investigated with (({ ./configure })). If you set this option, when you execute (({ ./configure })) again, (({config.cache})) is loaded. If you want to ignore (({config.cache})), don't set this option For example, execute (({ ./configure })) as follows. $ ./configure -C --enable-debug \ --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 \ Then, information such as the locations of the netCDF library etc. is succeeded by executing (({ ./configure })) as follows after next time. $ ./configure -C If you use Fujitsu Fortran compiler in Debian GNU/Linux, copy "Config.cache.debian-ffc*" to (({config.cache})) and execute (({ ./configure })). So, locations of libraries are specified automatically. $ cp Config.cache.debian-ffc5 config.cache $ ./configure =end EN =begin JA === Config.mk の編集 上記の ./configure だけで設定できなかった部分に関しては, (({ Config.mk })) を手動で編集して設定して下さい. 以下に主要な設定項目を挙げます. 詳しくは (({ Config.mk })) を見てください. :FC Fortran コンパイラ :SYSFFLAGS コンパイル時・リンク時に必要なフラグ (Fortran コンパイラ実行時に必要なオプション) :SYSLDFLAGS リンク時に必要なフラグ :SYSLDLIBS リンク時に必要なライブラリ :DCPAMDIR (({Config.mk})) が置いてあるディレクトリ :prefix dcpam4 のライブラリ, モジュール, 実行ファイル, ドキュメントのインストールディレクトリ :MODEXT モジュール情報ファイルの拡張子 :CLEAN_MODS make clean 時に使用するモジュール情報ファイル指定 :MAKE GNU make コマンド :AR アーカイブコマンド :ARFLAGS アーカイブ時に必要なフラグ :RANLIB アーカイブのインデックスを作成するコマンド =end JA =begin EN === Edit `Config.mk' Edit unspecified item in `(({Config.mk}))' manually. Followings are main items. :FC Fortran compiler :SYSFFLAGS Flags needed when compiled and linked :SYSLDFLAGS Flags needed when linked :SYSLDLIBS Libraries needed when linked :DCPAMDIR Specify location where (({Config.mk})) is. :prefix Directory where dcpam4 library, modules, executable files, and documentations are installed :MODEXT Extensions of Module Files (".mod" or ".d" or ".f90") :CLEAN_MODS Extensions of Module Files used when "make clean" :MAKE GNU make command :AR Archive command :ARFLAGS Flag of Archive command :RANLIB Generate index to archive command =end EN =begin JA === ソースコードのコンパイル ビルドには必ず GNU make を使用してください. 他の "make" プログラムを使 用すると, 正しくビルドが行われません. 以降 GNU make のコマンド名を "make" と表記しますが, これらはシステムの GNU make コマンドの名前に置き換えてください. ./configure を実行すると, 以下のように GNU make のコマンド名が 表示されます. このメッセージに従って GNU make を実行してください. Execute GNU make in the current directory, as follows. /usr/bin/make =end JA =begin EN === Compile source code You must use GNU make to build. No other "make" program is acceptable. "make" tentatively means GNU make at the following. Replace them with GNU make of your system. When ./configure is executed, the command name of GNU make is displayed as follows. Execute GNU make according to this message. Execute GNU make in the current directory, as follows. /usr/bin/make =end EN =begin JA === ドキュメントの生成 マニュアルとコードリファレンスのコンパイルはカレントディレクトリ において, 以下のコマンドを実行してください. (()) から入手する場合には既に生成済みです. $ make doc =end JA =begin EN === Generate documentations To generate documentations, execute following command in current directory. If you get from (()), documentations are already generated. $ make doc =end EN =begin JA == サンプルプログラム実行の手順 ((*※ 書きかけです. 以下は, 「dcpam4 ごくらくチュートリアル」へと移動される予定です.*)) === Held and Suarez (1994) のベンチマーク実験 サンプルとして Held and Suarez (1994) のベンチマーク実験を 行う方法を説明します. practice ディレクトリに移動してください. $ cd practice そのディレクトリ内で, make コマンドを実行してください. いくつか質問がありますが, とりあえずそのまま Enter キーを入力してください. $ make ****** Setup a directory for a experiment ****** Enter directory name [testXX]: Directory in which executable files are prepared [/home/dcpam/work/dcpam4/src/main]: Directory in which NAMELIST files are prepared [/home/dcpam/work/dcpam4/src/main]: Save F90/95 source code files? [Y/n]: Directory in which source code files are prepared [/home/dcpam/work/dcpam4/src]: : *** Setup of "testXX" is complete *** testXX というディレクトリが作成され, その中に 実行ファイルや NAMELIST ファイル, ソースコードがコピーされます. testXX ディレクトリ内に移動してください. $ cd testXX 実行ファイルとして dcpam_hs94, init_sample などが用意されている はずです. 以下のように dcpam_hs94 を実行してください. $ ./dcpam_hs94 *** MESSAGE [dcpam_hs94] *** History files are created. *** MESSAGE [dcpam_hs94] *** Restart file "dcpam_hs94_restart.nc" is created. *** MESSAGE [dcpam_hs94] *** History data (time=0.125 days) is output. *** MESSAGE [dcpam_hs94] *** Restart data (time=1440. minute - 20. minute, and 1440. minute) is output to "dcpam_hs94_restart.nc" ########## PREDICTION OF CALCULATION ########### Start Date 2007-07-30T17:25:25+09:00 Current Date 2007-07-30T17:25:35+09:00 Progress 14.29% [*** ] Remaining CPU TIME 0.580000E+02 Completion Date 2007-07-30T17:26:33+09:00 : ############## CPU TIME SUMMARY ################ Setup 0.223517E-09 HistoryGet 0.223517E-09 HistoryPut 0.679995E+00 Dynamics 0.133000E+02 Phyisics 0.342000E+01 TimeFilter 0.209997E+00 ------------------------------------------------ TOTAL TIME = 0.176100E+02 とりあえず 7 日分の計算が行われ, 結果が U.nc や Temp.nc として 出力されます. また, リスタートファイルが dcpam_hs94_restart.nc として出力されます. これらは (()) に基づく NetCDF ファイルです. 可視化や解析には ((<電脳 Ruby プロジェクト|URL:http://ruby.gfd-dennou.org/>)) において開発されているツールを使用してください. 計算設定を変更するには NAMELIST ファイルを使用してください. サンプルとして dcpam_hs94_T10L12.nml や dcpam_hs94_T21L12.nml を用意しています. これらのファイルの中身を変更し, 以下のように実行 ファイルのオプション -N (または --namelist) において指定してください. $ ./dcpam_hs94 -N=dcpam_hs94_T10L12.nml *** MESSAGE [dcpam_hs94] *** NAMELIST group "dcpam_hs94_grid_nml" is loaded from "dcpam_hs94_T10L12.nml". &DCPAM_HS94_GRID_NML NMAX = 10, IMAX = 32, JMAX = 16, KMAX = 12 / *** MESSAGE [dcpam_hs94] *** NAMELIST group "dcpam_hs94_time_nml" is loaded from "dcpam_hs94_T10L12.nml". &DCPAM_HS94_TIME_NML START_TIME_VALUE = 0.000000000000000E+000, START_TIME_UNIT = sec , DELTA_TIME_VALUE = 20.0000000000000 , DELTA_TIME_UNIT = minute , TOTAL_TIME_VALUE = 7.00000000000000 , TOTAL_TIME_UNIT = day , PREDICT_SHOW_INTERVAL_VALUE = 1.00000000000000 , PREDICT_SHOW_INTERVAL_UNIT = days / : NAMELIST ファイルを読み込む場合, 上記のように NAMELIST 変数群の読み込み に関する情報が出力されます. # #=== 簡単水惑星実験 # # #次に, 簡単な物理過程を導入した場合のテスト実験の方法を #説明します. # #practice ディレクトリに移動してください. # # $ cd practice # #そしてそのディレクトリに置いてある init_ape_T21L16.nml #を init.nml にコピーします. # # $ cd init_ape_T21L16.nml init.nml # #init.nml を必要に応じて編集します. その後, 以下のコマンドで #初期値データ init.nc を生成してください. # # $ make init # #次に, dcpam_ape.nml を編集してファイルの出力間隔や出力する #変数の指定を行ってください. #最後に以下のコマンドでプログラムが実行されます. # # $ make ape-run # #=== リスタートファイルを用いるには # =end JA =begin EN == Execute a sample program ((*Following documents are under construction. From now, they will be moved to "dcpam4 Gokuraku (easiest) Tutorial".*)) === A benchmark experiment suggested by Held and Suarez (1994) Firstly, how to execute a benchmark experiment suggested by Held and Suarez (1994) is explained. Move "practice" directory. $ cd practice In the directory, execute 'make' command. There are some questions, then input 'Enter' key. $ make ****** Setup a directory for a experiment ****** Enter directory name [testXX]: Directory in which executable files are prepared [/home/dcpam/work/dcpam4/src/main]: Directory in which NAMELIST files are prepared [/home/dcpam/work/dcpam4/src/main]: Save F90/95 source code files? [Y/n]: Directory in which source code files are prepared [/home/dcpam/work/dcpam4/src]: : *** Setup of "testXX" is complete *** Then a directory 'testXX' is created, and executable files, NAMELIST files, and source code files are copied to the directory. Move the 'textXX'. $ cd testXX Executable files 'dcpam_hs94', 'init_sample' etc. will be prepared. Execute 'dcpam_hs94' as follows. $ ./dcpam_hs94 *** MESSAGE [dcpam_hs94] *** History files are created. *** MESSAGE [dcpam_hs94] *** Restart file "dcpam_hs94_restart.nc" is created. *** MESSAGE [dcpam_hs94] *** History data (time=0.125 days) is output. *** MESSAGE [dcpam_hs94] *** Restart data (time=1440. minute - 20. minute, and 1440. minute) is output to "dcpam_hs94_restart.nc" ########## PREDICTION OF CALCULATION ########### Start Date 2007-07-30T17:25:25+09:00 Current Date 2007-07-30T17:25:35+09:00 Progress 14.29% [*** ] Remaining CPU TIME 0.580000E+02 Completion Date 2007-07-30T17:26:33+09:00 : ############## CPU TIME SUMMARY ################ Setup 0.223517E-09 HistoryGet 0.223517E-09 HistoryPut 0.679995E+00 Dynamics 0.133000E+02 Phyisics 0.342000E+01 TimeFilter 0.209997E+00 ------------------------------------------------ TOTAL TIME = 0.176100E+02 In this case, 7 days calculation is performed, and history data are output to 'U.nc' and 'Temp.nc' etc., and a restart data is output to 'dcpam_hs94_restart.nc'. They are netCDF data with (()). In order to visualize or analyze, use tools developed by (()). In order to configure the settings of calculation, use NAMELIST file. As samples, 'dcpam_hs94_T10L12.nml' and 'dcpam_hs94_T21L12.nml' are prepared. Edit these files and execute with '-N' (or '--namelist') option as follows. $ ./dcpam_hs94 -N=dcpam_hs94_T10L12.nml *** MESSAGE [dcpam_hs94] *** NAMELIST group "dcpam_hs94_grid_nml" is loaded from "dcpam_hs94_T10L12.nml". &DCPAM_HS94_GRID_NML NMAX = 10, IMAX = 32, JMAX = 16, KMAX = 12 / *** MESSAGE [dcpam_hs94] *** NAMELIST group "dcpam_hs94_time_nml" is loaded from "dcpam_hs94_T10L12.nml". &DCPAM_HS94_TIME_NML START_TIME_VALUE = 0.000000000000000E+000, START_TIME_UNIT = sec , DELTA_TIME_VALUE = 20.0000000000000 , DELTA_TIME_UNIT = minute , TOTAL_TIME_VALUE = 7.00000000000000 , TOTAL_TIME_UNIT = day , PREDICT_SHOW_INTERVAL_VALUE = 1.00000000000000 , PREDICT_SHOW_INTERVAL_UNIT = days / : When a NAMELIST file is loaded, information about loading of NAMELIST group name is output. # #=== Simple aqua planet experiment # #Secondly, how to execute a test run with simple physical prcesses. # #Move "practice" directory: # # $ cd practice # #Copy init_ape_T21L16.nml to init.nml: # # $ cd init_ape_T21L16.nml init.nml # #Edit init.nml if you nedd. Execute following command #to generate initial data file "init.nc". # # $ make init # #Next, edit dcpam_ape.nml, and specify time step interval, #output variable, output file, and so on. Finally execute following command. # # $ make ape-run # #=== How to use a restart file # =end EN #=begin JA #== システムへインストールする場合 # #もしもシステムに dcpam4 のライブラリ, モジュール, 実行ファイルを #インストールする場合は, カレントディレクトリで以下のコマンドを #実行してください. #システム領域にインストールする場合には管理者権限が #必要です. # # # make install # #ドキュメントをインストールする場合には以下のコマンドを実行します. # # # make install-doc # #=end JA #=begin EN #== Installation to system # #If you install dcpam4 libraries, modules, executable files to #system, in current directory, execute following command. #You need to be administrator. # # # make install # #If you want to install documentation files, execute following command. # # # make install-doc # #=end EN =begin HTML
$Id: INSTALL,v 1.6 2007/07/30 10:29:24 morikawa Exp $ =end HTML #== Mode setting for Emacs #Local Variables: #mode: rd #End: #