Contents of /MITgcm_contrib/jmc_script/README

Some basic scripts are gather here.

a) the restart test : "2+2=4"

script: tst_2+2
- to use in a run dir. after a successful "testreport"
- input argument: '0','1','2','3','4' or 'All':
  proceed step by step or all steps at once
- tst_2+2 (no argument) -> print "usage"
- know problems: specific restart procedure (with fizhi pkg or offline pkg)
  not yet implemented

script: do_test_2+2
- call restart test "tst_2+2" multiple times, in every test experiment.
- needs to be in MITgcm/verification (with a copy of tst_2+2i script)
  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

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

b) PBS-batch script that re-submit itself (loop).
script: runScript

- used (and tested) on myrinet-3 cluster.
- suffer from a lack of meaningful comments.
- not specially design to be general and obviously
  need to be modified/customized for each set-up.

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.m
 no known dependency
+  2 example scripts to make simple plots from Stat-Diags output:
matlab-script: grph_StD.m (uses read_StD.m)
matlab-script: plot_StD.m (uses read_StD.m)

d) script: rn_pickup
- Rename 'pickup*.ckpt[A,B].*' files to 'pickup*.[10-digits-iter].*'
  with several selection options
- rn_pickup (no argument) -> print "usage"
1	Some basic scripts are gather here.
2
3	a) the restart test : "2+2=4"
4
5	script: tst_2+2
6	- to use in a run dir. after a successful "testreport"
7	- input argument: '0','1','2','3','4' or 'All':
8	proceed step by step or all steps at once
9	- tst_2+2 (no argument) -> print "usage"
10	- know problems: specific restart procedure (with fizhi pkg or offline pkg)
11	not yet implemented
12
13	script: do_test_2+2
14	- call restart test "tst_2+2" multiple times, in every test experiment.
15	- needs to be in MITgcm/verification (with a copy of tst_2+2i script)
16	and can only be used after a successful "testreport"
17	- do_test_2+2 -help -> print "usage"
18
19	NOTE: scripts "tst_2+2" & "do_test_2+2" have been moved (Dec 25, 2007)
20	to: MITgcm/tools
21
22	script: tst_2+2_cpl
23	= version of tst_2+2 adapted for coupled set-up (verification/cpl_aim+ocn)
24
25	b) PBS-batch script that re-submit itself (loop).
26	script: runScript
27
28	- used (and tested) on myrinet-3 cluster.
29	- suffer from a lack of meaningful comments.
30	- not specially design to be general and obviously
31	need to be modified/customized for each set-up.
32
33	c) A short script to split the ASCII Diagnostics-Stats output file
34	into separated files (one per field) that are easy to read/load
35	(e.g., in matlab, just use "load" command)
36	script: extract_StD
37	no known dependency
38	+ A matlab script to load in 1 array all the separated files:
39	matlab-script: read_StD.m
40	no known dependency
41	+ 2 example scripts to make simple plots from Stat-Diags output:
42	matlab-script: grph_StD.m (uses read_StD.m)
43	matlab-script: plot_StD.m (uses read_StD.m)
44
45	d) script: rn_pickup
46	- Rename 'pickup.ckpt[A,B].' files to 'pickup.[10-digits-iter].'
47	with several selection options
48	- rn_pickup (no argument) -> print "usage"