Allow for pretty-printing of namelist array variables in log file.

[nusbaume]

Tag name (required for release branches):
Originator(s): nusbaume

Description (include the issue title, and the keyword ['closes', 'fixes', 'resolves'] followed by the issue number):

This PR allows for the "pretty-printing" of namelist variables in the SIMA log file that are arrays. Originally the variables were printed in an entirely un-formatted way, which could make it difficult to read. Now array variables are printed to the log like so:

aero_phys_props_climate(1) =
 N:sulf:bulk_sulfate:/glade/campaign/cesm/cesmdata/inputdata/atm/cam/physprops/sulfate_camrt_c080918.nc

aero_phys_props_climate(2) =
 N:dust1:dust_bin1:/glade/campaign/cesm/cesmdata/inputdata/atm/cam/physprops/dust1_camrt_c120518.nc                                                                                           
aero_phys_props_climate(3) =
 N:dust2:dust_bin2:/glade/campaign/cesm/cesmdata/inputdata/atm/cam/physprops/dust2_camrt_c120518.nc                                                                                           
aero_phys_props_climate(4) =
 UNSET                                                                                                                                                                                        
aero_phys_props_climate(5) =
 UNSET                      

The PR also removes a non-varying property in the namelist reader generation code, adds the iomsg output to the actual read calls, and now only writes the namelist variable values to the log if the logging level is greater than the minimum.

Fixes #450

Describe any changes made to build system: Modifications were made to the namelist reader generation routine.

Describe any changes made to the namelist: No changes to the namelist files themselves (just the generated readnl routines).

List any changes to the defaults for the input datasets (e.g. boundary datasets): N/A

List all files eliminated and why: N/A

List all files added and what they do: N/A

List all existing files that have been modified, and describe the changes:
(Helpful git command: git diff --name-status development...<your_branch_name>)

M cime_config/create_readnl_files.py

• Add array pretty-printing, iomsg, and log-level control to generated Fortran. Remove un-needed log_info variable.

M src/control/runtime_opts.F90

• Add comment indicating the need to read the logging namelist first.

M test/unit/python/sample_files/namelist_files/banana_namelist.F90
M test/unit/python/sample_files/namelist_files/kumquat_namelist.F90

• Update testing files to incorporate new Fortran code.

M test/unit/python/test_create_readnl_files.py

• Add test to make sure array dimension number limit check works correctly.

If there are new failures (compared to the test/existing-test-failures.txt file),
have them OK'd by the gatekeeper, note them here, and add them to the file.
If there are baseline differences, include the test and the reason for the
diff. What is the nature of the change? Roundoff?

derecho/intel/aux_sima: ALL PASS excluding expected multitape failure.

derecho/gnu/aux_sima: ALL PASS

If this changes climate describe any run(s) done to evaluate the new
climate in enough detail that it(they) could be reproduced:

CAM-SIMA date used for the baseline comparison tests if different than latest:

[jimmielin]

Thanks @nusbaume!

[peverwhee]

one tiny optional thing

[peverwhee]

not critical at all, but maybe a slightly clearer message?

Suggested change

	msg = f"Namelist values from {grpname} for {self.scheme}"
	msg = f"Namelist values from group '{grpname}' for scheme '{self.scheme}'"

[nusbaume]

Super-critical change made. Thanks for the suggestion!