Running the AMWG diagnostic tool on ARCHER

This short note describes the location of the AMWG diagnostic tool, plus the associated modules that must be employed.

Location

The AMWG diagnostic tool is actually a set of scripts. The entire package has been downloaded and is available in this project's shared space on ARCHER, namely

/work/ecse0116/ecse0116/shared

and resides in a folder named 

amwg_diag_20140207

Associated modules

The tool employs the GNU programming environment, whilst the CESM packages employs the INTEL programming environment.  Further, the default programming environment on ARCHER is CRAY. Thus, to employ the AMWG diagnostic tool, users must first run

module switch PrgEnv-cray PrgEnv-gnu

or

module switch PrgEnv-intel PrgEnv-gnu

Further, the AMWG diagnostic tool requires three other packages, namely ncl, nco and convert.

To access ncl on ARCHER, simply run the command

module load ncl

To access nco on ARCHER, simply run the command

module load nco

The convert command (which converts .ps files to jpg/gif/etc) is available by default and no module command is required.

Altering the AMWG scripts.

The AMWG scripts must be updated to the user's local environment. The main script is named

diag140207.csh

As the author (GJP) is not familiar with its use, only the most basic of directions can be given.  MB should be able to add to this section for a more complete list of required alterations.

The script appears to be written for the username hannay and ucar.edu.  Thus, all lines which include hannay and/or ucar.edu must be altered.

The environment variable DIAG_HOME has already been changed to /work/ecse0116/ese016/shared/amwg_diag_20140207

Summary

To enable the AMWG diagnostic took, run the commands

module switch PrgEnv-cray PrgEnv-gnu

or

module switch PrgEnv-intel PrgEnv-gnu

and then, and only once in the GNU Programming Environment:

module load ncl

module load nco

Then update the diag140207.csh.

To run, either run the script on the command line for small short jobs.  For longer jobs, users must use the batch queue.