IGMBaseLib Installation Guide

Supported system

This library can be compiled and run on following platforms(2011-09-12).

• Ubuntu 11.04 + gfortran 4.5.2
• Ubuntu 11.04 + Intel Fortran 12.0

Required softwares

netCDF (version 3.6.x)

For user who builds binary from source archive

• TGZ file of netCDF

  [NetCDF quick installation guide]

  [Index of installation guide]

gtool5

For user who builds binary from source archive

• TGZ file of gtool5 [Index of installation guide]

How to install

Getting source code

To download the source code of IGMBaseLib

$ wget http://www.gfd-dennou.org/ftp/member/ykawai/work/IGMBaseLib/product/igmbaselib-1.x.x.tar.gz

Expand tar.tgz file and move to project directory

$ tar -xzvf igmbaselib-1.x.x.tar.gz
$ cd igmbaselib-1.x.x.tar.gz

Setting of envrinment variables

Specify an environment variable of a compiler.

$ export FC=(compiler name)

If you want to set the compiler options,

$ export FCFLAGS=(compiler options) 

For example, in the case of using gfortran as a Fortran compiler,

$ export FC=gfortran
$ export FCFLAGS=-O2

Generate Makefile

Execute the configure scipt at the top directory, and automagically generate Makefile in each directory.

$ ./configure \
 --prefix=(full path to the install directory)
 --with-netcdf=(full path to the NetCDF library file) \    
 --with-netcdff=(full path to the NetCDF library file for Fortran 90) \    
 --with-gtool5=(full path to the gtool5 library file)

For example, in the case of using Debian pacakges,

$ ./configure \
  --prefix=/usr/local/IGMBaseLib1.x.x \
  --with-netcdf=/usr/lib/libnetcdf.a \
  --with-netcdf=/usr/lib/libnetcdff.a \
  --with-gtool5=/usr/lib/libgtool5.a

Compile Sources

In order to build IGMBaseLib, GNU make is used. Execute the following command at the top directory.

$ make

Generate Documents

Run test programs

Execute the following command at the top directory of IGMBaseLib.

$ make test

If all test program are succeeded, '*** All unit tests are succeeded !!' will be outputted.

Install

Execute the following command at the top directory. If you choose the administration domain where IGMBaseLib is installed, this installation may require administrative access to your computer.

$ make install