Annotation of /MITgcm_contrib/jmc_script/README

Some basic scripts are gather here. 
They are not specially design to be general and obviously 
need to be modified/customized for each application.

a) the restart test : "1+1=2"
script: tst1+1
 call 2 short scripts: rnp & add0upto10c

* no input argument but few comments within the file tst1+1
  (needs to be edited and modify).
* an example of data.tst file is provided 
Note: the script is sensitive to space and upper-case / lower
  case characters regarding nIter0 line and nTimeSteps line.

script: tst_2+2_cpl
 = version adapted for coupled set-up (verification/cpl_aim+ocn)

b) PBS-batch script that re-submit itself (loop).
script: runScript
 call 2 short scripts: add0upto3c & add0upto10c

* used (and tested) on myrinet-3 cluster.
* suffer from a lack of meaningful comments.
  
c) A short script to split the ASCII Diagnostics-Stats output file
   into separated files (one per field) that are easy to read/load 
   (e.g., in matlab, just use "load" command)
script: extract_StD
 no known dependency
 + A matlab script to load in 1 array all the separated files:
matlab-script: read_StD
 no known dependency
1	jmc	1.1	Some basic scripts are gather here.
2			They are not specially design to be general and obviously
3			need to be modified/customized for each application.
4
5			a) the restart test : "1+1=2"
6			script: tst1+1
7	jmc	1.2	call 2 short scripts: rnp & add0upto10c
8	jmc	1.1
9			* no input argument but few comments within the file tst1+1
10			(needs to be edited and modify).
11			* an example of data.tst file is provided
12			Note: the script is sensitive to space and upper-case / lower
13			case characters regarding nIter0 line and nTimeSteps line.
14
15	jmc	1.5	script: tst_2+2_cpl
16			= version adapted for coupled set-up (verification/cpl_aim+ocn)
17
18	jmc	1.1	b) PBS-batch script that re-submit itself (loop).
19			script: runScript
20	jmc	1.2	call 2 short scripts: add0upto3c & add0upto10c
21	jmc	1.1
22			* used (and tested) on myrinet-3 cluster.
23			* suffer from a lack of meaningful comments.
24
25	jmc	1.3	c) A short script to split the ASCII Diagnostics-Stats output file
26			into separated files (one per field) that are easy to read/load
27			(e.g., in matlab, just use "load" command)
28			script: extract_StD
29			no known dependency
30	jmc	1.4	+ A matlab script to load in 1 array all the separated files:
31			matlab-script: read_StD
32			no known dependency