A series of scripts to process the STDOUT* files of MITgcm when the
"-ts" or "-papis"/"-pcls" flags were used with genmake2.

To install place the *.awk files in a directory $HOME/awk and the rest
of the mitgcm_* files in a directory $HOME/bin and make sure the
latter is in your path.

All scripts produce the number of time series data points used for
statistics followed by:

arithmetic mean, standard deviation, geometric mean, minimum, maximum

In the case of mitgcm_time, three sets of the above statistics are
produced on one line, each within parentheses, for user time, system
time and wallclock time per timestep.

mitgcm_time:		user, system and wallclock time per timestep stats
mitgcm_mflops:		user Mflop/s per timestep stats
mitgcm_mflops_w:	wallclock Mflop/s per timestep stats
mitgcm_mflops2:		user Mflop/s per timestep stats (adjoint mode)
mitgcm_mflops_w2:	wallclock Mflop/s per timestep stats (adjoint mode)
mitgcm_ipc:		user IPC per timestep stats
mitgcm_ipc_w:		wallclock IPC per timestep stats
mitgcm_ipc2:		user IPC per timestep stats (adjoint mode)
mitgcm_ipc_w2:		wallclock IPC per timestep stats (adjoint mode)

To use

script_name STDOUT_filename 

or

script_name STDOUT_filename start firstn skip

where "start" is the timestep number assigned to the first occurence of
the Mflop/s or IPC information in the STDOUT_filename, "firstn" is the
timestep number that specifies how many of the initial timesteps are
ignored for the purpose of generating statistics and "skip" is used to
specify a period between timing or counter information that is to be
skipped because for example it contains a lot of I/O and skews the
statistics. The default values are 1, 1 and 1000000 respectively. A
careful choice of these 3 should handle most cases.

The mitgcm_mflops(_w) scripts automatically discard the very first
hardware performance counter information that precedes any timestep.

STDOUT_filename can be a file compressed with compress (.Z) or gzip
(.gz) and the script transparently handles that.