--- MITgcm_contrib/jmc_script/README	2009/05/11 12:32:37	1.10
+++ MITgcm_contrib/jmc_script/README	2020/11/09 17:36:04	1.19
@@ -1,6 +1,6 @@
 Some basic scripts are gather here.
 
-a) the restart test : "2+2=4"
+a) the restart test: "2+2=4"
 
 script: tst_2+2
 - to use in a run dir. after a successful "testreport"
@@ -16,8 +16,8 @@
   and can only be used after a successful "testreport"
 - do_test_2+2 -help -> print "usage"
 
-NOTE: scripts "tst_2+2" & "do_test_2+2" have been moved (Dec 25, 2007) 
- to: MITgcm/tools
+NOTE: scripts "tst_2+2" & "do_test_2+2" have been moved (Dec 25, 2007)
+ to: MITgcm/tools/
 
 script: tst_2+2_cpl
  = version of tst_2+2 adapted for coupled set-up (verification/cpl_aim+ocn)
@@ -44,15 +44,38 @@
 
 d) script: rn_pickup
 - Rename 'pickup*.ckpt[A,B].*' files to 'pickup*.[10-digits-iter].*'
-  with several selection options
+  with several selection options.
 - rn_pickup (no argument) -> print "usage"
 
 e) script: mk_mkfile
 - run genmake2 with the same options as when "Makefile" was generated
  (needs an existing previous "Makefile") ; this replaces "make makefile".
- in addition, link *_mpi files from the MODS directory when -mpi was 
+ in addition, link *_mpi files from the MODS directory when -mpi was
  used to generate the previous Makefile.
 
 f) script: derive_other_types
-  from 1 src file, derive other type (R4,RS,RL,RS) version. For now, can 
+  from 1 src file, derive other type (R4,RS,RL,RS) version. For now, can
   only be applied to the 4 src files: "mdsio_pass_r{4,8}tor{l,s}.F"
+
+g) script: mk_options_list
+  generate list of CPP Options used in Fortran source files
+
+----------------------------------------------------------------------
+shell & matlab scripts to process MONITOR output from STDOUT files
+ and make simple time-serie plots:
+--------------------
+a) shell script: select_MON
+ get all MONITOR output from a single file and split into many
+ single-variable output files (easier to load and plot)
+
+b) shell scripts: do_extract_MON & extract_MON
+ collect into a single file all MONITOR output from consecutive
+ STDOUT output files (from a single experiment with one of more restart)
+
+c) matlab script: grph_MON.m
+ plot MONITOR time-serie of one or more experiment (with lines of different
+ color). Note: experiment with larger number of records needs to come first.
+Uses: read_MON.m
+ to load-in single-variable output files (--> many files per experiment)
+and/or: readnc_MON.m
+ to load-in netcdf (MNC) MONITOR output files