...
Load the same modules that a full E3SM case would load:
E3SM’s CIME provides a script which will give the csh output needed to load the correct modules and other configuration settings:
eval `~/codes/acme/cime/scripts/Tools/get_case_env`
Most users will be using the bash shell, in which case examine the output of ~/codes/acme/cime/scripts/Tools/get_case_env and modify to work with bash
Run cmake from your $wdir
cd $wdir
cmake -C $mach $homme
make -j4 theta-l (optional step to see if code will compile)
For additional CMAKE options, see $homme/README.cmake. Options include number of vertical levels (default 26), type of output, native or lat/lon or disabled, ability to enable/disable energy diagnostics, ability to disable kokkos components (SL transport).
After step 2 is complete, one can build many different targets. The generic targets preqx, theta-l, sweqx use the configurations options specified above. Then there are a host of specific targets such as “theta-l-nlev20-native” that are used by various test cases.
Run DCMIP2012 Test 3-1 (simple gravity wave)
cd $wdir/dcmip_tests/dcmip2012_test3.1_nh_gravity_waves/theta-l
make install (copies test case related files from $homme)
./build.sh (build the correct executable with correct compile time options for this test)
ls jobscript-sh*.
look for a suitable jobscript for your machine. most test cases include “jobscript-snl.sh” which runs on E3SM institutional clusters, and jobscript-knl.sh for NERSC Cori. Some editing may be neccessary.
The jobscript usually runs included NCL scripts for creating standard test case plots from the output
All the DCMIP2012 and DCMIP2016 test cases can be run similar to the above example for Test 3-1.
Other standalone HOMME test cases of interest. These usually contain a single script that will configure and build the model (assuming step1 above is done)
Held-Suarez: see $homme/test/held_suarez0 and the script “hs.job”
NGGPS and V1 benchmarks: see $homme/test/benchmark and associated scripts.
HOMME doubly periodic test cases