COSP2 in CESM2 Guidance

At this time, COSP2 has been implemented with CESM1/CAM6 physics and released to the public. Here we provide answers to some frequently asked questions. COSP2/CESM2 contacts are Jennifer Kay (University of Colorado/CIRES), Dustin Swales (University of Colorado/CIRES) and Brian Medeiros (NCAR).

What is the easiest way to run COSP within CAM and look at COSP diagnostics using the AMWG diagnostics package? The instructions below assume you are running on Cheyenne but steps will be similar on other supercomputers.

1. Get the CESM2 code from github and check out the externals (including CAM with COSP2)
   git clone https://github.com/ESCOMP/cesm.git cesm2
cd cesm2
./manage_externals/checkout_externals
2. Create the case and go to your case directory
   cd cime/scripts
./create_newcase --case /glade/u/home/$USER/$CASE_NAME --compset B1850 --res f09_g17
cd /glade/u/home/$USER/$CASE_NAME

3. Configure CAM so that you compile with COSP
   ./xmlchange CAM_CONFIG_OPTS="-phys cam6 -co2_cycle -cosp
4. Set up the case
   ./cesm_setup
5. Edit the CAM namelist and include COSP. A common option will be to run with cosp_amwg set to true. With this setting in the CAM namelist, you will run the radar, lidar, modis, misr and isccp simulators, and save the monthly COSP outputs needed for the AMWG diagnostics package in the CAM h0 history files. cosp_amwg=.true.
   Note that setting cosp_amwg=.true. is the equivalent of setting:
   cosp_histfile_num = 1
cosp_lisccp_sim = .true.
cosp_lradar_sim = .true.
cosp_llidar_sim = .true.
cosp_lmisr_sim = .true.
cosp_lmodis_sim = .true.
cosp_nradsteps = 3
cosp_ncolumns = 10
6. Build the model and Run CESM for at least one year including months needed for DJF averaging qcmd -- ./case.build
./xmlchange STOP_OPTION="nmonths",STOP_N=1,REST_N=1,REST_OPTION="nmonths",RESUBMIT=0,CONTINUE_RUN=FALSE
./xmlchange PROJECT=$PROJECTCODE,JOB_WALLCLOCK_TIME="01:00:00",JOB_QUEUE="regular"
./case.submit
7. Run the latest version of the AMWG diagnostics package on your outputs

What COSP2 outputs available in CESM2/CAM6? CALIPSO (+OPAQ outputs new in COSP2) CloudSat (+PREC outputs new in COSP2) MISR MODIS (2 new outputs in COSP2) ISCCP

What COSP namelist options are available in CAM?