#= INSTALL guide of deepconv/arare # # Authors:: SUGIYAMA Ko-ichiro, ODAKA Masatsugu # Version:: $Id: INSTALL,v 1.4 2011-12-06 07:11:07 odakker Exp $ # Tag Name: $Name: arare5-20130125 $ # Copyright:: Copyright (C) GFD Dennou Club, 2006. All rights reserved. # License:: See COPYRIGHT[link:COPYRIGHT] # ######################################################################## # =begin JA = deepconv/arare インストール手引 #* 杉山 耕一朗, 小高 正嗣, 山下 達也 # * 2011/12/06 (小高正嗣) 最終更新 # * 2011/08/09 (小高正嗣) 最終更新 # * 2011/06/14 (杉山耕一朗) 最終更新 # * 2011/03/02 (山下 達也) 最終更新 # * 2009/03/06 (山下 達也) 最終更新 # * 2008/01/17 (小高 正嗣) 最終更新 # * 2007/10/19 (小高 正嗣) 最終更新 # * 2006/10/30 (小高 正嗣) 最終更新 # * 2006/09/29 (小高 正嗣) 最終更新 # * 2006/09/20 (小高 正嗣) 最終更新 # * 2006/09/12 (小高 正嗣) 最終更新 # * 2006/03/16 (杉山 耕一朗) 最終更新 # * 2005/04/26 (小高 正嗣) 最終更新 # * 2005/04/22 (杉山 耕一朗) 最終更新 # * 2005/04/19 (杉山 耕一朗) 更新 # * 2005/01/31 (小高 正嗣) 新規作成 (1) ((<動作環境>)) (2) ((<コンパイルに必要なソフトウェア>)) (3) ((<インストールの手順>)) (4) ((<ソースツリー以下の主要なファイルとディレクトリ>)) =end JA =begin EN = Deepconv/arare installation guide #* Ko-ichiro Sugiyama, Masatsugu Odaka, Tatsuya Yamashita # * 2011/12/06 (Masatsugu Odaka) Update # * 2011/08/09 (Masatsugu Odaka) Update # * 2011/06/14 (Ko-ichiro Sugiyama) Update # * 2011/03/02 (Tatsuya Yamashita) Update # * 2009/03/06 (Tatsuya Yamashita) Update # * 2007/10/19 (Masatsugu Odaka) Update # * 2006/10/30 (Masatsugu Odaka) Update # * 2006/09/29 (Masatsugu Odaka) Update # * 2006/09/20 (Masatsugu Odaka) Update # * 2006/09/12 (Masatsugu Odaka) Update # * 2006/03/16 (Ko-ichiro Sugiyama) Update # * 2005/04/26 (Masatsugu Odaka) Update # * 2005/04/22 (Ko-ichiro Sugiyama) Update # * 2005/04/19 (Ko-ichiro Sugiyama) Update # * 2005/01/31 (Masatsugu Odaka) Initial release (1) (()) (2) (()) (3) (()) (4) (()) =end EN =begin JA == 動作環境 2011 年 06 月 14 日現在, 以下の環境での動作が確認されています. === Linux on x86 * Debian GNU/Linux 6.0 (squuze) + gfortran + LAPACK * Debian GNU/Linux 5.0 (lenny) + PGI compiler + LAPACK + mpich2 * Debian GNU/Linux 5.0 (lenny) + g95 + LAPACK + mpich2 * Debian GNU/Linux 5.0 (lenny) + ifort (ver.11.0) + lapack + mpich2 * Debian GNU/Linux 5.0 (lenny) + (()) (64 ver.1) + LAPACK === Mac OS on Intel Mac * Mac OS 10.5 + g95 + LAPACK === 大型計算機 * CRAY XT4 + PGI compiler + LAPACK * 日立 SR11000 + 日立最適化 Fortran + LAPACK/MATRIX * NEC SX6 + sxf90 + LAPACK * NEC SX8 + sxf90 + LAPACK =end JA =begin EN == Supported system Deepconv can be compiled and run on following platforms (2009-03-06). === Linux on x86 * Debian GNU/Linux 6.0 (squuze) + gfortran + LAPACK * Debian GNU/Linux 5.0 (lenny) + PGI compiler + LAPACK + mpich2 * Debian GNU/Linux 5.0 (lenny) + g95 + LAPACK + mpich2 * Debian GNU/Linux 5.0 (lenny) + ifort (ver.11.0) + lapack + mpich2 * Debian GNU/Linux 5.0 (lenny) + (()) (64 ver.1) + LAPACK === Mac OS on Intel Mac * Mac OS 10.5 + g95 + LAPACK === Super Computer System * CRAY XT4 + PGI compiler + LAPACK * HITACHI SR11000 + HITACHI Optimized Fortran + LAPACK/MATRIX * NEC SX6 + sxf90 + LAPACK * NEC SX8 + sxf90 + LAPACK =end EN =begin JA == コンパイルに必要なソフトウェア deepconv/arare をインストールと実行には以下のソフトウェアを事前にインストール しておく必要があります. : (()) (バージョン 3.6.x) ソースからコンパイルする場合 * ((<ソースの TGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/>)) [(())] [(())] : (()) ソースからコンパイルする場合 * (()) [((<インストールガイドの目次|URL:http://www.gfd-dennou.org/library/gtool/gtool5/gtool5_current/INSTALL.htm>))] : LAPACK/BLAS ソースからコンパイルする場合 * (()) * (()) == ドキュメントのコンパイルに必要なソフトウェア deepconv/arare のドキュメントは, 数理モデルと離散モデル解説は LaTex, コードリファレンスは RD, RDOC (Ruby Document) を用いて記述されています. これらのドキュメントはソースツリー内ではコンパイル済となっていますが, ドキュメントの再コンパイルを行うためには, 以下のソフトウェアが必要です. * LaTeX とそのスタイルファイル * ASCII pTeX など * dennou-sty-6 ((<"http://www.gfd-dennou.org/library/cc-env/TeXmacro/dennou/"|URL:http://www.gfd-dennou.org/library/cc-env/TeXmacro/dennou/>)) * dennou-sty-6 対応 latex2html ((<"http://www.gfd-dennou.org/library/cc-env/latex2html/"|URL:http://www.gfd-dennou.org/library/cc-env/latex2html/>)) * ruby/rd * rdtool ((<"http://raa.ruby-lang.org/project/rdtool/"|URL:http://raa.ruby-lang.org/project/rdtool/>)) * rd2html-ext ((<"http://raa.ruby-lang.org/project/rd2html-ext/"|URL:http://raa.ruby-lang.org/project/rd2html-ext/>)) * ((<"RDOC Fortran90/95 ソースコード解析機能強化版"|URL:http://www.gfd-dennou.org/library/dcmodel/rdoc-f95/>)) * rd2 用パッチファイル ((<"http://www.gfd-dennou.org/library/dcmodel/doc/rd2-filter.patch"|URL:http://www.gfd-dennou.org/library/dcmodel/doc/rd2-filter.patch>)) Debian GNU/Linux を使用する場合, 以下のバイナリパッケージが必要となります. * librd-html-ext-ruby1.8 * rdtool * rdoc * (()) * (()) =end JA =begin EN == Required softwares : (()) (version 3.6.x) For user who builds binary from source archive * (()) [(())] [(())] : (()) For user who builds binary from source archive * (()) [(())] : LAPACK/BLAS For user who builds binary from source archive * (()) * (()) == Required softwares to build documentation Documentations of deepconv/arare are written by using LaTex, RD, and RDOC (Ruby Document). All documentations in source tree are already compiled. If you recompile documentations, following softwares are requaired. * LaTeX and style files * ASCII pTeX * dennou-sty-6 ((<"http://www.gfd-dennou.org/library/cc-env/TeXmacro/dennou/"|URL:http://www.gfd-dennou.org/library/cc-env/TeXmacro/dennou/>)) * latex2html with dennou-sty-6 style((<"http://www.gfd-dennou.org/library/cc-env/latex2html/"|URL:http://www.gfd-dennou.org/library/cc-env/latex2html/>)) * ruby/rd * rdtool ((<"http://raa.ruby-lang.org/project/rdtool/"|URL:http://raa.ruby-lang.org/project/rdtool/>)) * rd2html-ext ((<"http://raa.ruby-lang.org/project/rd2html-ext/"|URL:http://raa.ruby-lang.org/project/rd2html-ext/>)) * ((<"Enhanced version of RDoc Fortran 90/95 parser"|URL:http://www.gfd-dennou.org/library/dcmodel/rdoc-f95/>)) * rd2 patch file ((<"http://www.gfd-dennou.org/library/dcmodel/doc/rd2-filter.patch"|URL:http://www.gfd-dennou.org/library/dcmodel/doc/rd2-filter.patch>)) If you use Debian GNU/Linux on x86, followng packages are required: * librd-html-ext-ruby1.8 * rdtool * rdoc * (()) * (()) =end EN =begin JA == インストールの手順 === ソースの入手 wget などでソースを入手 $ wget http://www.gfd-dennou.org/library/deepconv/arare/arare5_current.tgz === tgz ファイルの展開, ソースディレクトリへの移動 $ tar -xzvf arare5_current.tgz $ cd arare5-YYYYMMDD === 環境変数の設定 コンパイラを指定する. $ export FC=(コンパイラ名) 例えば g95 の場合, $ export FC=g95 とする. 並列計算を行いたい場合には $ export FC=mpif90 とする. === Mkinclude の作成 ソースを展開後, configure を実行して Mkinclude ファイルを作成する. $ ./configure \ --with-netcdf=(netCDF ライブラリファイルの絶対パス) \ --with-gtool5=(gtool5 ライブラリファイルの絶対パス) \ --with-lapack=(LAPACK ライブラリファイルの絶対パス) \ --with-blas=(BLAS ライブラリファイルの絶対パス) 例えば Debian パッケージを利用している場合, $ ./configure \ --with-netcdf=/usr/lib/libnetcdf-g95.a \ --with-gtool5=/usr/lib/gtool5-g95/lib/libgtool5.a \ --with-lapack=/usr/lib/liblapack-g95.a \ --with-blas=/usr/lib/libblas-g95.a とすれば良い. 並列計算を行う場合には, gtool5 を mpif90 でコンパイルしておく. 作成した Mkinclude の各マクロを確認し, インストール先の環境にあわせて 適宜編集する. mpi を利用する場合は, CPPFLAGS=LIB_MPI とすること. === ソースのコンパイル コンパイルは GNU make を用いて行う. ==== 2 次元計算を行なう場合 ソースツリー直下で $ make を実行するとソース直下の以下のディレクトリに実行ファイルとライブラリ, モジュールファイルが展開される. ./lib ライブラリ libarare.a が格納される ./bin 実行ファイルが格納される ./include 各種 *.mod ファイルが格納される bin 以下には次の実行ファイルが格納される. arare 3 次元雲対流モデル arare_init-data 初期値ファイル作成用実行ファイル === ドキュメントのコンパイル ==== インストールの手引, 利用の手引とコードリファレンス $ make doc =end JA =begin EN == Installation === Download source code. Download source code by using wget command, and so on. $ wget http://www.gfd-dennou.org/library/deepconv/arare/arare5_current.tgz === Unpack tgz file and go to source tree directory. $ tar -xzvf arare5_current.tgz $ cd arare5-YYYYMMDD === Setting of environment variable Set an environment variable of a compiler. $ export FC=(compiler name) === Make Mkinclude file Execute configure script at the top directory of source tree. $ ./configure \ --with-netcdf=(netCDF library file) \ --with-gtool5=(gtool5 library file) \ --with-lapack=(LAPACK library file) \ --with-blas=(BLAS library file) If you use MPI, please edit Mkinclude; CPPFLAGS = LIB_MPI === Compile Execute "make" command at the top directory of source tree. $ make === Compile documentation file Execute "make doc" at the top directory of source tree to build installation guide, code reference and tutorial. $ make doc =end EN =begin JA == アンインストールの手順 src ディレクトリ以下のオブジェクトファイル, 実行ファイルの消去は $ make clean とする. 数理モデル解説と離散モデル解説, インストールの手引, 利用の手引とコードリファレンスの消去は $ make clean.doc とする. $ make clean.all とすると, 上記のすべてと Mkinclude ファイルが消去される. =end JA =begin EN == Uninstall Execute "make clean" to remove binary files. $ make clean Execute "make doc" at the top directory of source tree to remove installation guide, code reference and tutorial. $ make clean.doc All of them and Mkinclude are removed by "make clean.all". $ make clean.all =end EN =begin JA == ソースツリー以下の主要なファイルとディレクトリ COPYRIGHT ライセンス INSTALL インストール手引き Makefile Makefile Mkinclude Makefile 用 include ファイル (configure から生成) bin/ 実行ファイル格納ディレクトリ (コンパイル時に作成) css/ スタイルシート格納ディレクトリ doc/ ドキュメント格納ディレクトリ dai1bu/ 数理モデル解説格納ディレクトリ dai2bu/ 離散モデル解説格納ディレクトリ code_reference/ コードリファレンス格納ディレクトリ tutorial/ チュートリアル include/ モジュール格納ディレクトリ (コンパイル時に作成) lib/ ライブラリ格納ディレクトリ (コンパイル時に作成) src/ ソースコード格納ディレクトリ Makefile Makefile chemdat/ 化学種の指定および物性値の設定と計算 dynamics/ 力学過程 env/ 基本場と擾乱場の初期条件を設定 io/ 入出力 main/ 主プログラム, 乱数生成, 診断量の計算 physics/ 物理過程 setup/ 初期化 util/ 平均微分演算, 境界条件等を計算する下請け計算 sample_nml/ 設定ファイルのサンプル scripts/ 解析や絵を描くのに使うツール群 =end JA =begin EN == Major files and directories in source tree COPYRIGHT Licence file INSTALL.rd This file Makefile Makefile Mkinclude Include file for Makefile (made by configure script) bin/ Binary file directory css/ CSS file directory doc/ Documentation directory dai1bu/ Documentation of physical model dai2bu/ Documentation of method of discritization code_reference/ Code reference tutorial/ Tutorial include/ Mod file directory lib/ Library file directory src/ Source code directory Makefile Makefile chemdat/ Setup for chemical data dynamics/ Dynamical process env/ Setup for initial condition io/ Input/Output main/ Main program physics/ Physical processes setup/ Initial setup util/ Low level routines sample_nml sample of namelist file scripts/ Tools for drawing figure and analysis =end EN