next up previous contents
Next: 10 The Atmosphere Setup Up: UsersGuide Previous: 8 Supporting Scripts:   Contents

9 The Graphical User Interface: ccsm_gui

The CCSM Graphical User Interface (GUI) will generate example scripts to run the CCSM for one month in configurations different from the default ``all active models'' configuration in the CCSM2.0 distribution. To do this, the GUI modifies the scripts/test.a1/ example script so that it will run the selected model configurations.

The GUI is a perl wrapper for some of the tools created by the CCSM developers at NCAR for automated generation and testing of different model configurations. While the GUI is designed to generate scripts that run at NCAR, the resulting scripts are a good starting point for off-site users as well.

Currently, the only officially supported configuration and resolution combination is all active components (Configuration B) at the T42_gx1v3 resolution. While the GUI will generate test scripts for other combinations, the results have not been scientifically validated.

The CCSM GUI can be found in the .../ccsm2.0/scripts/gui_run directory. The GUI is designed so that it does not have to be run on the same machine that the CCSM model will be run. PerlTK is required to run the GUI. Start the GUI by typing ./ccsm_gui and a window will be created with a few pull-down menus and some input and check boxes. The GUI will search for any previous GUI settings archived in the file  /ccsm_gui.

First select the platform that the CCSM will be run on: aix for IBM SP AIX and sgi for SGI Origin 2000-type machines. If the target machine is neither of these, chose 'aix' if the target machine is a distributed memory architecture and choose 'sgi' if it is a shared memory architecture. Then select the desired resolution.

Information on the directory structure of the target machine where the CCSM will be run needs to be supplied for $CSMROOT, $CSMDATA and $EXEROOT. The test $CASE name is also needed.

CSMROOT (string) defines the root directory of the CCSM code distribution directory tree. The model source code, scripts and documention are located underneath this directory.
CASE (string) is the "name" that identifies this model run. The CASE name is propagated throughout the CCSM environment into script and directory names. Currently CASE can be up to 16 characters long.
CSMDATA (string) is the root directory for the input and boundary datasets. This directory differs from the others in that it is not created by the CCSM run script. It is assumed that $CSMDATA already exists and contains the data files contained in the CCSM2.0 input data distribution tar files.
EXEROOT (string) is the directory where the model will run. Subdirectories for each of the model components will be created under EXEROOT. Typically, this is a local, fast, and large temporary disk space.

Then, select the desired configuration. The G and M configurations are used to test the sea-ice model and require a T62_gx1v3 resolution setting from the pull-down menu. Any of the other configurations can be built at either T42_gx1v3 or T31_gx3, but these results have not yet been scientifically verified.

next up previous contents
Next: 10 The Atmosphere Setup Up: UsersGuide Previous: 8 Supporting Scripts:   Contents