Using GLIMMER

Obtaining Glimmer

GLIMMER is available from the Glimmer project page. Documentation is also available from this site. It is recommended that the latest version of Glimmer should be used; GENIE will not build with versions of Glimmer prior to 1.0.4.

Building Glimmer

More information is provided in the documentation, but the basic build is quite simple:

• First, unpack the tarball:

tar xzvf glimmer-1.0.4.tar.gz

• Descend into the resulting directory:

cd glimmer-1.0.4

• Set the environment variable FCFLAGS to -DGLIMMERSP. This enables compliation of Glimmer with a single-precision interface, required by GENIE. The mechanism used to set environment variables depends on your shell, but for bash or ksh, do this:

export FCFLAGS="-DGLIMMER_SP"

• Run configure with the appropriate arguments. The --prefix specifies where the model will be installed; --with-netcdf specifies the location of the NetCDF library. The NetCDF installation is expected to be laid out in the standard way, so that the directory specified includes lib and include directories. For example:

./configure --prefix=/home/ggdagw/glimmer-genie-version --with-netcdf=/opt/local/intel_fc_81 FC=ifort

• You will need to build GLIMMER separately from GENIE:

make

• GENIE builds will expect to find the GLIMMER libraries and modules in particular locations. Invoke the install target to install GLIMMER:

make install

Configuring GENIE

By default, GENIE is expecting to find Glimmer in the directory ~/glimmer-genie-version, as specified in the ./configure command above. If you have installed Glimmer elsewhere, you can either edit the variable GLIMMER_DIR in genie-main/user.mak or create a symbolic link in your home directory with the name 'glimmer-genie-version' to point to your most recently downloaded version of GLIMMER.

To complete the Glimmer configuration, you also need to set FLAG_GLIMMER=ON in genie-main/user.mak.