Exercises in session 2 may have changed variables or output.  To reset, follow steps 2-7 in Session 1 to rebuild and rerun the baseline case.  This is usually not needed, but added her for completeness.

Setup the environment for the case directory location.

For bash:

For csh:

Load the wgrib2 module on Cheyenne.

Move to the directory that contains the configuration files and scripts used for creating a custom flat text file read by UPP.

We recommend creating copies of the original *.xml and *.txt files that will be modified or created by this process so they are not overwritten.

This example describes how to add the field SFEXC (heat exchange coefficient at the surface) to the postcntrl_gfs.xml and postcntrl_gfs_f00.xml configuration files. Using your favorite text editor, edit each configuration file by adding the following parameter to the list at the end of the file, but before the </paramset> and </postxml> tags.

You may also delete an unwanted field by completely removing the parameter block of that field from these files and then continuing with step 5.

* Formatting is important; use other entries in the file as a guide.

** Adding fields requires knowledge on which fields can be output for your specific dynamic core and physics options. Not all fields available in UPP can be output with the UFS MRW application.

This example will describe how to add height agl levels to the SPFH field in the postcntrl_gfs.xml and postcntrl_gfs_f00.xml configuration files. Using your favorite text editor, edit each configuration file by adding the bold highlighted levels to the field ‘Specific humidity on flight levels’.

Leave no whitespace between the opening <level> and 20. and between 100. and the closing </level>

For the list of available levels for each level type, please reference the UPP documentation on ‘Controlling which levels UPP outputs’.

You may also easily remove levels from the <level> tag by simply deleting them from the list.

* Formatting is important; use other entries in the file as a guide.

In order to ensure there are no errors in your modified *.xml files, you may validate them against the XML stylesheets provided in the directory:

If the xml’s are error free, then the commands will return that the xml validates. (e.g. postcntrl_gfs.xml validates)

In the $HOME/UFS_training/my_ufs_sandbox/src/post/parm directory, create the flat text files.

Running make calls the perl program PostXMLPreprocessor.pl, which checks for any modified xml files and re-creates the flat text configuration files where changes were found. The new files generated for this example include:

In order to run the MRW post-processing with these new customized flat text files, you will need to copy or link them to the following location from the top level of your case directory.

Check that the workflow recognizes the flat text files in the new directory location by previewing the namelist before re-running UPP.

When running the workflow, CIME first looks in the ${CASEROOT}/SourceMods/src.ufsatm directory for the UPP parameter file(s) and uses them for the post-processing. If there are no flat text files present in this directory, then the default parameter file(s) in the pre-configured location are used.

UPP output from the initial case run (Session 1) is located in $CASEROOT/run with the naming convention:

If you would like to keep the previous UPP output to compare, copy it to a new name or directory so it does not get overwritten.

Rerun the UPP job to output the new field and/or levels.

You can check the new UPP output using a simple wgrib2 command. For example, to check that the new SPFH height levels were added:

You can also view additional diagnostic output such as min/max values. For example, to just look at the newly added variable SFEXC:

If UPP fails, the UPP log files, $CASEROOT/run/oi.HHH, can be consulted for errors.

UPP grib2 output is on the same grid as the model output, which for the MRW is a Guassian grid. The specifications for a simple lat-lon projection are:

-new_grid latlon lon0:nlon:dlon lat0:nlat:dlat

Move to the run directory and run the following example.

This would interpolate to a 0.25 degree latitude-longitude grid with earth-relative winds (U-wind goes east, V-wind goes north).

You can check the new grid by again using wgrib2. We will print out the info just for the SFEXC field rather than list all fields.

For more examples, you can refer to the wgrib2 site.