[ English | Japanese ] [ GFD Dennou Club / deepconv / deepconv Reference Manual ]

Deepconv/arare installation guide

  1. Supported system
  2. Required softwares
  3. Installation
  4. Major files and directories in source tree

Supported system

Deepconv can be compiled and run on following platforms (2009-03-06).

Linux on x86

Mac OS on Intel Mac

Super Computer System

Required softwares

netCDF (version 3.6.x)

For user who builds binary from source archive

For Debian GNU/Linux users

gt4f90io

For user who builds binary from source archive

For Debian GNU/Linux 3.1 (sarge) users

LAPACK/BLAS

For user who builds binary from source archive

For Debian GNU/Linux 3.1 (sarge) users

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.

If you use Debian GNU/Linux on x86, followng packages are required:

Installation

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 want to use other library of linear algebra, specify the library name to LINSOLV and execute configure script as follows.

$ LINSOLV=(Name of the linear algebra library) ./configure \
  --with-netcdf=(netCDF library file) \	
  --with-gtool5=(gtool5 library file) \
  --with-library=(Linear algebra library file) 

And the confirm Mkinclude and modify suitable for your platform.

Note) Supported linear algebra library except for LAPACK/BLAS is 
only MATRIX on HITACHI SR11000. In this case, specify LINSOLV="matrix". 

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  

Execute "make latex2html" at the top directory of source tree to build html documentation file of physical model and discritization method.

$ make latex2html

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

Execute "make latex2html" at the top directory of source tree to remove html documentation file of physical model and discritization method.

$ make clean.latex2html

All of them and Mkinclude are removed by "make clean.all".

$ make clean.all

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)

arare-earth.conf	Sample of NAMELIST file (for the Earth)
arare-jupiter.conf	Sample of NAMELIST file (for Jupiter, Version 1)
arare-jupiter2.conf	Sample of NAMELIST file (for Jupiter, Version 2)
arare-mmc.conf	Sample of NAMELIST file (for the Martian Moist Convection)
arare_3d.conf	Sample of NAMELIST file (for 3D)

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
doc-mmc/		 Documentation directory for calculation of Martian Moist Convection
   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
    dynamic/  Dynamical process
    env/      Setup for initial condition
    io/       Input/Output
    main/     Main program
    moist/    Moist process
    physics/  Physical processes
    setup/    Initial setup
    util/     Low level routines

src-mmc/		 Source code directory for calculation of Martian Moist Convection
    Makefile  Makefile
    chemdat/  Setup for chemical data
    dynamic/  Dynamical process
    env/      Setup for initial condition
    io/       Input/Output
    main/     Main program
    moist/    Moist process
    physics/  Physical processes
    setup/    Initial setup
    util/     Low level routines

sysmake/      Mkinclude template-file directory (obsolete)
    Mkinclude.ffc  for FQS Fortran90 compiler on Linux
    Mkinclude.g95  for g95

tools/	 Tools for drawing figure and analysis

Deepconv Development Group / GFD Dennou Staff dcstaff@gfd-dennou.org
Last Updated: 2011/03/02, Since: 2005/01/31