Changing the CCSM setup: Active Ocean plus Data Models

1. Changing the CCSM setup: Active Ocean plus Data Models Nancy Norton ccsm@ucar.edu

2. Quick Summary • Download CCSM2.0 source code, scripts, and input datasets • Set up active ocean + data atm,ice,lnd-- use the GUI!!! • Edit the ocean-model namelist file: pop_in • Edit the ocn.setup.csh script • Run one-month test run • Wait for CCSM2.0.1 releasebefore making production runs!

3. CCSM code,scripts, and data directories CCSM2.0 ------------------------------|------------------------- | | ccsm2.0/ inputdata/ ----------------- | | | atm/ ice/ lnd/ ocn/ models/ scripts/ | --------|-----------| ocn/ gui_run/ test.a1/ | | | pop/ ccsm_gui.pl *.setup.csh | test.a1.run input_templates/ gx1v3_pop_in

4. Download CCSM2.0 source code, scripts, and input datasets • On local system: • mkdir CCSM2.0 • Go to the CCSM2.0 website: www.ccsm.ucar.edu/models/ccsm2.0 • Find Model Source Code section • Download ccsm2.0.tar.gz into CCSM2.0 directory • Find Model Input Data section • Download T42/gx1v3 input datasets tar file into CCSM2.0 directory • On local system: • cd CCSM2.0 • gunzip ccsm2.0.tar.gz • tar -xvf ccsm2.0.tar

5. Download CCSM2.0 source code, scripts, and input datasets CCSM2.0 ------------------------------|------------------------- | | | ccsm2.0/ ccsm2.0.tarinputdata/ | | ----------------- atm/ ice/ lnd/ ocn/ | | models/ scripts/ | --------|------------| ocn/ gui_run/ test.a1/ | | | pop/ ccsm_gui.pl *.setup.csh | test.a1.run input_templates/ gx1v3_pop_in

6. Set up active ocean + data atm,ice,lnd • Set up a new directory with a collection of scripts to run the active ocean + data atmosphere, ice, and land models through the coupler -- use the GUI!!! • How do you use the GUI?

7. How do you use the GUI? CCSM2.0 ------------------------------|------------------------- | | ccsm2.0/ inputdata/ ----------------- | | | atm/ ice/ lnd/ ocn/ models/ scripts/ | --------|------------| ocn/ gui_run/ test.a1/ | | | pop/ ccsm_gui.pl *.setup.csh | test.a1.run input_templates/ gx1v3_pop_in

8. How do you use the GUI? • cd CCSM2.0/ccsm2.0/scripts/gui_run • issue the perl command: ccsm_gui.pl • the GUI will pop up • select “C” run: active ocean, coupler, and data atmosphere, ice, and land: • ocn.setup.csh • cpl.setup.csh • datm.setup.csh • dice.setup.csh • dlnd.setup.csh

10. CCSM2.0 GUI Status Window

11. New directory generated by GUI: newtest.001 CCSM2.0 ------------------------------|------------------------- | | ccsm2.0/ inputdata/ ----------------- | | | atm/ ice/ lnd/ ocn/ models/ scripts/ | --------|----------|--------------| ocn/ gui_run/ test.a1/ newtest.001/ | | | | pop/ ccsm_gui.pl *.setup.csh *.setup.csh | test.a1.run newtest.001.run input_templates/ gx1v3_pop_in

12. Edit the ocean-model namelist file: pop_in • cd CCSM2.0/ccsm2.0/scripts/newtest.001 • mkdir src.ocn • cd src.ocn • cp CCSM2.0/ccsm2.0/models/ocn/pop/ input_templates/gx1v3_pop_in . • edit gx1v3_pop_in

13. Edit personal copy of gx1v3_pop_in CCSM2.0 ------------------------------|------------------------- | | ccsm2.0/ inputdata/ ----------------- | | | atm/ ice/ lnd/ ocn/ models/ scripts/ | --------|----------|--------------| ocn/ gui_run/ test.a1/ newtest.001/ | | | | pop/ ccsm_gui.pl *.setup.csh *.setup.csh | test.a1.run newtest.001.run input_templates/ src.ocn/ gx1v3_pop_in | ---------------------------> gx1v3_pop_in

14. Edit gx1v3_pop_in 1. &forcing_shf_nml luse_cpl_ifrac = .true. 2. &ice_nml lactive_ice = .false. 3. probably one new namelist parameter will be released with CCSM2.0.1 -- will be announced if needed

15. Edit the ocn.setup.csh script • cd CCSM2.0/ccsm2.0/scripts/newtest.001 • edit ocn.setup.csh: • note line in ocn.setup.csh script: • set my_path = $SCRIPTS/src.ocn • change • sed -f $EXEDIR/commands.sed $SRCDIR/input_templates/${OCN_GRID}_pop_in to sed -f $EXEDIR/commands.sed $my_path/${OCN_GRID}_pop_in …

16. Edit personal copy of gx1v3_pop_in CCSM2.0 ------------------------------|------------------------- | | ccsm2.0/ inputdata/ ----------------- | | | atm/ ice/ lnd/ ocn/ models/ scripts/ | --------|----------|--------------| ocn/ gui_run/ test.a1/ newtest.001/ | | | | pop/ ccsm_gui.pl *.setup.csh *.setup.csh | test.a1.run newtest.001.run input_templates/ src.ocn/ gx1v3_pop_in | ---------------------------> gx1v3_pop_in

17. Wait for CCSM2.0.1 before running production runs! • Datasets referenced in CCSM2.0 datm.setup.csh and dlnd.setup.csh are outdated and should not be used in production runs • Datasets referenced in CCSM2.0.1 datm.setup.csh and dlnd.setup.csh will be obtained from active-atm, active-lnd branch run (an “F” run branched from the CCSM2.0 control run) • Wait for CCSM2.0.1 release before running any production runs! Repeat preceding process with CCSM2.0.1 tar file.

18. Running the “C” run • The GUI set up a one-month test run for you -- now submit it to your target machine (llsubmit newtest.001.run on the IBM) • Review the output from the *.log.* files from each component • Review the output from the ocean log file -- all namelist values are echoed into the log file, so check to make certain that the changes you made to lactive_ice and luse_cpl_ifrac were actually used in your run • Wait for the CCSM2.0.1 release before running the “C” run in production mode!