Skip to content
Jessica Meixner edited this page Jan 21, 2020 · 2 revisions

Frequently Asked Questions

How to turn on dump fields from model components

Dump fields are netcdf files written out from each model cap. To turn on dump fields, in the nems.configure file (in the NEMS regression test system this is copied from the parm/nems.configure.med_atm_ocn_ice.IN or parm/nems.configure.medcold_atm_ocn_ice.IN input files), set

DumpFields = true

for each component that you wish to have dump fields from. The dump fields will be written in your run directory.

How to turn on/off ESMF PET Logs

In model_configure file (in the NEMS regression test this is the parm/model_configure.IN file), set the print_esmf field to true to turn on or false to turn off:

print_esmf: .false.

Turning on debug in compilation

If you want to turn on debug/traceback options, for each of the components:

For NEMS: In conf/configure.fv3.{machine} in the FLAGS section set:

DEBUG = Y

For CICE: In CICE/bld/Macros.Linux.NEMS.$MACHINE_ID update the FFLAGS.

For MOM6: In MOM6/src/mkmf/templates/{$MACHINE_ID}-intel.mk in the FLAGS section set:

DEBUG = Y

How to get a text output of profile timings

There is an option to print out text summary of output timings (ie no need for Java/Eclipse/Cupid installs). The reference manual describes two new environment variables to turn on the profile summary output:

export ESMF_RUNTIME_PROFILE=ON

export ESMF_RUNTIME_PROFILE_OUTPUT=SUMMARY

If you are using a NEMS app these should likely be added in compsets/*.input fv3_prep section.

Note, your job must complete for the summary table to be written so make sure to adjust the wall clock or runtime.

In your run directory /rtgen.*/tmp// there will be a file ESMF_Profile.summary which you can then use to check load balance and run times of different components.