1. www.ccsm.ucar.edu Using the CCSM GUI Mariana Vertenstein CCSM Software Engineering Group ccsm@ucar.edu

2. www.ccsm.ucar.edu What does the GUI do? Sets up scripts to do a 1 month run –Either IBM-SP or SGI platforms –Following Resolutions T42(atm,lnd)_gx1v3(ocn,ice) T31(atm,lnd)_gx3(ocn,ice) T62(atm,lnd)_gx1v3(ocn,ice) Last test only valid for tests using latm atm

3. www.ccsm.ucar.edu Example GUI Screen

4. www.ccsm.ucar.edu Required User Inputs - CSMROOT top level directory where the user has untarred the source code and scripts if CSMROOT is set to /home/user/ccsm2.0 then the scripts ASSUME the existence of the directories: –/home/user/ccsm2.0/models –/home/user/ccsm2.0/scripts this is turned into $CMSROOT in the generated scripts

5. www.ccsm.ucar.edu Required user inputs - CASE Case name of the run and name of the directory containing generated scripts Two scripts will be generated in the directory CSMROOT/scripts/CASE – CSMROOT/scripts/CASE/CASE.run – CSMROOT/scripts/CASE/CASE.har this is turned into $CASE in the generated scripts

6. www.ccsm.ucar.edu More About CASE Entry CASE.run performs a one month startup run CASE.har performs harvesting –archiving and harvesting are turned off by default in CASE.run (the lines are commented out) –If CSMROOT/scripts/CASE/CASE.run already exists, the GUI will not generate the run script and will issue an error warning.

7. www.ccsm.ucar.edu Required User Inputs - CSMDATA top level directory where the CCSM input data files have been untarred if CSMDATA is set to /home/user/input_data, the scripts will expect the following directory structure to exist – /home/user/input_data/atm – /home/user/input_data/cpl – /home/user/input_data/ice – /home/user/input_data/lnd – /home/user/input_data/ocn this is turned into $CSMDATA in the scripts

8. www.ccsm.ucar.edu Required User Input - EXEROOT top level directory where the CCSM run will be executed if EXEROOT is set to /ptmp/user/CASE, the following directories will be generated /ptmp/user/CASE/all/ /ptmp/user/CASE/atm/ /ptmp/user/CASE/cpl/ /ptmp/user/CASE/esmf/ /ptmp/user/CASE/ice/ /ptmp/user/CASE/lib/ /ptmp/user/CASE/lnd/ /ptmp/user/CASE/ocn/

9. www.ccsm.ucar.edu Possible Test Choices – Select One A => data [atm,lnd,ocn,ice] B => active [atm,lnd,ocn,ice] C => active [ocn] + data [atm,lnd,ice] D => active [ice] + data [atm,lnd,ocn] F => active [atm,lnd] + pres-clim[ice] + data[ocn] G => active [ocn,ice] + l[atm] + data[lnd] H => active [atm] + data [lnd,ocn,ice] I => active [lnd] + data [atm,ocn,ice] J => pres-clim[ice] + data[atm,lnd,ocn] K => active [atm,lnd] + data [ocn,ice] M=> mlo [ice] + l[atm] + data [lnd,ice]

10. www.ccsm.ucar.edu GUI configuration file –GUI saves configuration in user’s home directory on system where GUI was invoked in the file ~/.ccsm_ gui –This file is read in upon reinvoking the GUI

11. www.ccsm.ucar.edu What if Perl/Tk is not on my system? 1)Copy the CSMROOT/scripts/gui_run directory to a system that has Perl/Tk 2)Invoke the GUI 3)Enter in correct values 4)Copy the script directory that is created for you back to the original platform under 11CSMROOT/scripts