#
# dcpam Installation Guide in RD (Ruby Document) format
#
#   For instruction of installing dcpam, 
#   see "INSTALL.htm.en" (English) or "INSTALL.htm" (Japanese)
#   included in "dcpam" 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
#   <http://raa.ruby-lang.org/project/rdtool/>.

=begin TOPLINK
[((<English|URL:INSTALL.htm.en>)) |
((<Japanese|URL:INSTALL.htm>))]
[((<GFD Dennou Club|URL:http://www.gfd-dennou.org>)) |
((<DCPAM Project|URL:http://www.gfd-dennou.org/library/dcpam>))]
=end TOPLINK

=begin JA

= dcpam 󥹥ȡ륬
#*   (morikawa),   (momoko)
#  * $Id: INSTALL,v 1.9 2006/10/09 07:35:54 morikawa Exp $
=end JA
=begin EN

= dcpam Installation Guide
#* Yasuhiro MORIKAWA (morikawa), Masaki ISHIWARARI (momoko)
#  * $Id: INSTALL,v 1.9 2006/10/09 07:35:54 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/      >)) +
    ((<Fujitsu Fortran 5.0 (in JAPANESE)|URL:http://www.fqs.co.jp/fort-c/>))

  * ((<"Debian GNU/Linux 3.1 "|URL:http://www.debian.org/      >)) +
    ((<Intel Fortran 9.0|URL:http://www.intel.com/software/products/compilers/flin/>))
=end

=begin JA
== ѥɬפʥ饤֥

dcpam3 Υ󥹥ȡ롦¹Ԥ뤿ˤϰʲΥեȥ
˥󥹥ȡ뤷Ƥɬפޤ.

: ((<netCDF|URL:http://www.gfd-dennou.org/library/netcdf>)) (С 3.5.0, 3.6.0)
  debian ѤƤƥ󥹥ȡѥåѤ
  
  * deb ѥå [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/spmodel/debian/netcdf/sarge/netcdf-ffc5_3.6.0-2_i386.deb>)) |
    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/spmodel/debian/netcdf/sarge/netcdf-ifc8.1_3.6.0-p1-1_i386.deb>))]

    嵭 deb ѥå¾ netCDF  Development kit ⥤󥹥ȡ뤹
    ɬפޤ (netcdfg-dev ѥå).

  饳ѥ뤹
  * ((<3.6.0  TGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/netcdf-3.6.0-p1.tar.gz>))

    [((<Unidata ܲ NetCDFå󥹥ȡ륬 (Ѹ) |URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/Quick-Instructions-for-Installing-NetCDF-on-Unix.html#Quick-Instructions-for-Installing-NetCDF-on-Unix>))
    |
    ((<(ܸ)|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io_current/INSTALL_netcdf.htm>)) ]

    [((<Unidata ܲȤΥ󥹥ȡ륬ɤܼ|URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/index.html>))]
  
: ((<gt4f90io|URL:http://www.gfd-dennou.org/library/gtool4>)) (С 20060827)
  
#  debian ѤƤƥ󥹥ȡѥåѤ
#  * deb ѥå [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/gtool4/debian/gt4f90io/gt4f90io-ffc5_current_i386.deb>)) |
#    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/gtool4/debian/gt4f90io/gt4f90io-ifc8.1_current_i386.deb>))]

  饳ѥ뤹
  * ((<С 20060725 TGZ|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io-20060725.tgz>))
   
    ((<󥹥ȡ륬|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io-20060725/INSTALL.htm>))

: ((<ISPACK|URL:http://www.gfd-dennou.org/library/ispack>)) (С 0.71)

  debian ѤƤƥ󥹥ȡѥåѤ

  * deb ѥå [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/spmodel/debian/ispack/sarge/ispack-ffc5_0.71-1_i386.deb>)) |
    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/spmodel/debian/ispack/sarge/ispack-fftw2-ifc8.1_0.71-1_i386.deb>))]

  饳ѥ뤹
  * ((<С 0.71 TGZ|URL:http://www.gfd-dennou.org/library/ispack/ispack-0.71.tar.gz>))

    󥹥ȡκݤ, 嵭 tar.gz Ÿ README 򻲾ȤƤ.

: ((<spmodel|URL:http://www.gfd-dennou.org/library/spmodel>)) (С 0.4.0-2)
  debian ѤƤƥ󥹥ȡѥåѤ
  * deb ѥå [((<Fujitsu ver5, ssl2|URL:http://www.gfd-dennou.org/library/spmodel/debian/spml/sarge/spml-ffc5_0.4.0-2_i386.deb>)) |
    ((<Intel ver8.1, lapack|URL:http://www.gfd-dennou.org/library/spmodel/debian/spml/sarge/spml-ifc8_0.4.0-2_i386.deb>))]

  饳ѥ뤹
  * ((<ǿ 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 ѥåˤϴ˥ɥȤƱƤޤ)

* ((<LaTeX|URL:http://www.latex-project.org/>))
  * ե: ((<Dennou6 style|URL:http://www.gfd-dennou.org/library/cc-env/TeXmacro/dennou/SIGEN.htm>))
* ((<latex2html ܸѥå, Dennou6 style ѥå򤢤Ƥ|URL:http://www.gfd-dennou.org/library/cc-env/latex2html/SIGEN.htm>))
* ((<ruby|URL:http://www.ruby-lang.org/>))
* ((<rdtool|URL:http://raa.ruby-lang.org/project/rdtool/>))
* ((<"RDoc Fortran90/95 ɲϵǽ"|URL:http://www.gfd-dennou.org/library/dcmodel>))

#* ((<rdoc|URL:http://rdoc.sourceforge.net/>))
#* ((<rd2latex-lib|URL:http://shugo.net/archive/rd2latex/>))


=end JA
=begin EN

== Libraries needed for compile

Following softwares should be installed for installing dcpam.

: ((<netCDF|URL:http://my.unidata.ucar.edu/content/software/netcdf/index.html>)) (version 3.5.0 or 3.6.0)

  For using debian package.

  * deb package [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/spmodel/debian/netcdf/sarge/netcdf-ffc5_3.6.0-2_i386.deb>)) |
    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/spmodel/debian/netcdf/sarge/netcdf-ifc8.1_3.6.0-p1-1_i386.deb>))]

  For compiling source code.
  * ((<Version 3.6.0 TGZ|URL:http://www.gfd-dennou.org/library/netcdf/unidata-mirror/netcdf-3.6.0-p1.tar.gz>))

    Installation Guide
    [((<Quick Instructions for Installing (Unidata)|URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/Quick-Instructions-for-Installing-NetCDF-on-Unix.html#Quick-Instructions-for-Installing-NetCDF-on-Unix>))]
    [((<NetCDF Installation and Porting Guide (Unidata)|URL:http://my.unidata.ucar.edu/content/software/netcdf/docs/netcdf-install/index.html>))]
  
: ((<gt4f90io|URL:http://www.gfd-dennou.org/library/gtool4>)) (version 20060827)
  
#  For using debian package.
#  * deb package [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/gtool4/debian/gt4f90io/gt4f90io-ffc5_current_i386.deb>)) |
#    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/gtool4/debian/gt4f90io/gt4f90io-ifc8.1_current_i386.deb>))]

  For compiling source code.
  * ((<Version 20060725 TGZ|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io-20060725.tgz>))

    ((<Installation Guide|URL:http://www.gfd-dennou.org/library/gtool4/gt4f90io/gt4f90io-20060725/INSTALL.htm>))

: ((<ISPACK (in JAPANESE)|URL:http://www.gfd-dennou.org/library/ispack>)) (version 0.71)
  
  For using debian package.
  * deb package [((<Fujitsu ver5|URL:http://www.gfd-dennou.org/library/spmodel/debian/ispack/sarge/ispack-ffc5_0.71-1_i386.deb>)) |
    ((<Intel ver8.1|URL:http://www.gfd-dennou.org/library/spmodel/debian/ispack/sarge/ispack-fftw2-ifc8.1_0.71-1_i386.deb>))]

  For compiling source code.
  * ((<Version 0.71 TGZ|URL:http://www.gfd-dennou.org/library/ispack/ispack-0.71.tar.gz>))
  
    See "README" file in above tar.gz file. (but that is wrote in JAPANESE)

: ((<spmodel|URL:http://www.gfd-dennou.org/library/spmodel>)) (version 0.4.0-2)
  
  For using debian package.
  * deb package [((<Fujitsu ver5, ssl2|URL:http://www.gfd-dennou.org/library/spmodel/debian/spml/sarge/spml-ffc5_0.4.0-2_i386.deb>)) |
    ((<Intel ver8.1, lapack|URL:http://www.gfd-dennou.org/library/spmodel/debian/spml/sarge/spml-ifc8_0.4.0-2_i386.deb>))]

  For compiling source code.
  * ((<Latest TGZ|URL:http://www.gfd-dennou.org/library/spmodel/spml.tar.gz>))

    ((<Installation Guide (in JAPANESE)|URL:http://www.gfd-dennou.org/library/spmodel/spml/INSTALL>))

If you get dcpam from CVS. Following softwares should be installed
for generating documentations.
(But if you get tar.gz package, documentations are already generated).

* ((<LaTeX|URL:http://www.latex-project.org/>))
  * Style file: ((<Dennou6 style (JAPANESE only)|URL:http://www.gfd-dennou.org/library/cc-env/TeXmacro/dennou/SIGEN.htm>))
* ((<latex2html_jp+dennou (JAPANESE only)|URL:http://www.gfd-dennou.org/library/cc-env/latex2html/SIGEN.htm>))
* ((<ruby|URL:http://www.ruby-lang.org/>))
* ((<rdtool|URL:http://raa.ruby-lang.org/project/rdtool/>))
* ((<"Enhanced version of RDoc Fortran90/95 parser"|URL:http://www.gfd-dennou.org/library/dcmodel>))
#* ((<rdoc|URL:http://rdoc.sourceforge.net/>))
#* ((<rd2latex-lib|URL:http://shugo.net/archive/rd2latex/>))

=end EN

=begin JA
== ѥμ
=end JA
=begin EN
== Compile source code
=end EN

=begin JA
=== TGZ ѥåŸ

Ŭʺȥǥ쥯ȥǰʲΤ褦˥֤Ÿޤ.
 dcpam3-((|С|)) Ȥǥ쥯ȥŸޤ.

	$ tar xvzf dcpam3-current.tgz

ޤ

	$ zcat dcpam3-current.tar.gz | tar -xvf -

=end JA
=begin EN
=== Extract TGZ Package

Make an empty directory, and extract archive as follows.
A directory `dcpam3-((|version|))'
created at the current working directory.

	$ tar xvzf dcpam3-current.tgz

or

	$ zcat dcpam3-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/dcpam3 })) Ǥ.

:(({--libdir=}))((|ARG|))
  ((|ARG|)) ˥饤֥Υ󥹥ȡΥǥ쥯ȥꤷޤ.
  ǥեȤ (({ /usr/local/dcpam3/lib })) Ǥ.

:(({--includedir=}))((|ARG|))
  ((|ARG|)) ˥⥸塼եΥ󥹥ȡΥǥ쥯ȥ
  ꤷޤ. ǥեȤ (({ /usr/local/dcpam3/include })) Ǥ.

:(({--bindir=}))((|ARG|))
  ((|ARG|)) ˼¹ԥեΥ󥹥ȡΥǥ쥯ȥꤷޤ.
  ǥեȤ (({ /usr/local/dcpam3/bin })) Ǥ.

:(({--with-docdir=}))((|ARG|))
  ((|ARG|)) ˥ɥȥեΥ󥹥ȡꤷޤ.
  ǥեȤ (({ /usr/local/dcpam3/doc })) Ǥ.

:(({--with-dcpam_lib_name=}))((|ARG|))
  ((|ARG|))  dcpam3 Υ饤֥̾ꤷޤ.
  饤֥̾ (({lib}))((|<ARG>|))(({.a})) Ȥʤޤ.
  ǥեȤ (({ dcpam3 })) Ǥ, κݤΥ饤֥̾
  (({ libdcpam3.a })) Ȥʤޤ.

:(({--with-dcpam_suffix=}))((|ARG|))
  ((|ARG|)) ˤϥ󥹥ȡǥ쥯ȥ, 饤֥̾,
  ¹ԥեˤĤꤷޤ.
  㤨, ¾ƥǥեȤ (({ ffc5 })) Ȼꤹ,
  󥹥ȡΥǥ쥯ȥΥץեå
  (({ /usr/local/dcpam3-ffc5 })), 饤֥̾
  (({ libdcpam3-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 ((<Libraries needed for compile>)) 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/dcpam3 })).

:(({--libdir=}))((|ARG|))
  Specify directory to which the library is installed to ((|ARG|)).
  Default value is (({ /usr/local/dcpam3/lib })).

:(({--includedir=}))((|ARG|))
  Specify directory to which the module is installed to ((|ARG|)).
  Default value is (({ /usr/local/dcpam3/include })).

:(({--bindir=}))((|ARG|))
  Specify directory to which the executable file is installed to ((|ARG|)).
  Default value is (({ /usr/local/dcpam3/bin })).

:(({--with-docdir=}))((|ARG|))
  Specify directory to which the documentation file is installed to ((|ARG|)).
  Default value is (({ /usr/local/dcpam3/doc })).

:(({--with-dcpam_lib_name=}))((|ARG|))
  Specify dcpam3 library name to ((|ARG|)).
  Library name becomes (({lib}))((|<ARG>|))(({.a})) .
  Default value is (({ dcpam3 })), so library name becomes
  (({ libdcpam3.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/dcpam3-ffc5 })),
  library name becomes (({ libdcpam3-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
  dcpam3 Υ饤֥, ⥸塼, ¹ԥե,
  ɥȤΥ󥹥ȡǥ쥯ȥ

:MODEXT
  ⥸塼եγĥ

:MODS
  make clean ˻Ѥ⥸塼ե

:AR
  ֥ޥ

=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 dcpam3 library, modules, executable files,
  and documentations are installed

:MODEXT
  Extensions of Module Files (".mod" or ".d" or ".f90")

:MODS
  Extensions of Module Files used when "make clean"

:AR
  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
=== ɥȤ

ޥ˥奢ȥɥե󥹤Υѥϥȥǥ쥯ȥ
ˤ, ʲΥޥɤ¹ԤƤ.
((<dcpam3  TGZ ѥå|URL:http://www.gfd-dennou.org/library/dcpam/dcpam3/dcpam3_current.tgz>))
ꤹˤϴѤߤǤ.

	$ make doc
=end JA
=begin EN
=== Generate documentations

To generate documentations, execute following command in current directory.
If you get from
((<dcpam3 TGZ package|URL:http://www.gfd-dennou.org/library/dcpam/dcpam3/dcpam3_current.tgz>)),
documentations are already generated.

	$ make doc
=end EN

=begin JA
== ƥȥץ¹Ԥμ

ǽ, Held and Suarez (1994) Υ٥ޡ¸
Ԥˡޤ.

practice ǥ쥯ȥ˰ưƤ.

        $ cd practice

ƤΥǥ쥯ȥ֤Ƥ init.nml ԽƤ.
Υե뤬Τ NAMELIST եǤ.
Խä, ʲΥޥɤǽͥǡ init.nc
Ƥ.

        $ make init

, dcpam.nml Խƥեνϴֳ֤Ϥ
ѿλԤäƤ.
Ǹ˰ʲΥޥɤǥץब¹Ԥޤ.

        $ make run

ʤ, 顼 dcpam.log ˽Ϥ, ̾ΥåɸϤ
Ϥޤ. ̾Υåե˽Ϥˤ

        $ make run > dcpam.msg

ȤƤ. ʤ, ߤǤϥǥХåѥå
 dcpam.log ˽Ϥ褦ˤʤäƤޤ. (礭
ΤդƤ).

̤ result ǥ쥯ȥʲ˽Ϥޤ.

, ñʪƳΥƥȼ¸ˡ
ޤ.

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 test program

Firstly, how to execute a benchmark experiment suggested 
by Held and Suarez (1994) is explained.

Move "practice" directory.

        $ mv practice

Edit "init.nml" if you nedd. This file is NAMELIST file for initial data.
After editting, execute following command to generate initial data file 
"init.nc". 

        $ make init

Next, edit "dcpam.nml", and specify time step interval, 
output variable, output file, and so on. Finally execute following command.

        $ make run

Error messages are printed in "dcpam.log", and normal messages
are printed standard output. If you want to write normal messages
to file, do as follow.

        $ make run > dcpam.msg

Now, debug messages are printed in "dcpam.log" too. So this file
become large.

Result data are located in "result" directory.

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


=end EN


=begin JA
== ƥإ󥹥ȡ뤹

⤷⥷ƥ dcpam3 Υ饤֥, ⥸塼, ¹ԥե
󥹥ȡ뤹, ȥǥ쥯ȥǰʲΥޥɤ
¹ԤƤ.
ƥΰ˥󥹥ȡ뤹ˤϴԸ¤
ɬפǤ.

	# make install

ɥȤ򥤥󥹥ȡ뤹ˤϰʲΥޥɤ¹Ԥޤ.

	# make install-doc

=end JA
=begin EN
== Installation to system

If you install dcpam3 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
<hr>
<small>$Id: INSTALL,v 1.9 2006/10/09 07:35:54 morikawa Exp $
</small>
=end HTML

#== Mode setting for Emacs
#Local Variables:
#mode: rd
#End:
#
