Changes between Version 1 and Version 2 of Developers/NamelistChecker

Timestamp:

2020-06-05T13:32:41+02:00 (4 years ago)

Author:

acc

Comment:

--

Developers/NamelistChecker

@@ -18 +18 @@
   * namelists are closed with / appearing as the first non-whitespace on a line
 
-then the attached nemo_nml_check.py script will:
+then the attached [[attachment:nemo_nml_check.py]] script will:
  * read supplied namelist files 
  * construct lists of namelist blocks and their contents (the latter being a list of lists) 
@@ -26 +26 @@
 By default, the script will compare ''namelist_cfg'' and ''namelist_ref'' from the current directory. Alternative pairs can be named using the ''-c'' and ''-r'' command-line options:
 
-{{{#!bash
+{{{
 python nemo_nml_check.py --help
 usage: nemo_nml_check.py [-h] [--cfg [CFGFILE]]  [--ref [REFFILE]]
@@ -41 +41 @@
 A typical example of an error found between the default pairing is:
 
-{{{#!bash
+{{{
 python nemo_nml_check.py
 No match for:  rn_rdt  in  namdom  (at line no.  39 )
@@ -49 +49 @@
 
 == Part 2 Constructing a pseudo-reference namelist ==
+
+Parsing the source code to extract information to build a pseudo reference namelist is simpler if we assume adherence to some coding conventions:
+
+* The namelist opening declaration: ''namelist / name_of_namelist /'' occurs on one line
+* The ''name_of_namelist'' string contains only alphanumeric characters and underscores
+* subsequent continuation lines have a leading ampersand and a trailing ampersand is placed on the preceding line (comments are allowed after the trailing ampersand)
+
+With these (seemingly safe) assumptions the attached Perl script: nemo_list_nmls.pl can be used to extract namelist templates from the source. For example:
+
+{{{
+perl nemo_list_nmls.pl OCE/nemogcm.F90
+&namctl
+  ln_ctl =
+  sn_cfctl =
+  nn_print =
+  nn_ictls =
+  nn_ictle =
+  nn_isplt =
+  nn_jsplt =
+  nn_jctls =
+  nn_jctle =
+  ln_timing =
+  ln_diacfl =
+/
+&namcfg
+  ln_read_cfg =
+  cn_domcfg =
+  ln_closea =
+  ln_write_cfg =
+  cn_domcfg_out =
+  ln_use_jattr =
+/
+}}}
+
+Combined with a few lines of bash, this can be used to construct a pseudo-namelist_ref:
+
+{{{#!bash
+for f in `find ./OCE -name '*.[Fh]90'`
+do
+  echo "! "$f >> pseudo_nml_ref
+  perl nemolist_nmls.pl $f >> pseudo_nml_ref
+done
+}}}
+
+''(this does assume scanning OCE is sufficient; how about OFF, SAS etc.?)''
+
+
+