| 1 |
\section{Pre-- and Post--Processing Scripts and Utilities} |
| 2 |
|
| 3 |
There are numerous tools for pre-processing data, converting model |
| 4 |
output and analysis written in Matlab, fortran (f77 and f90) and perl. |
| 5 |
As yet they remain undocumented although many are self-documenting |
| 6 |
(Matlab routines have "help" written into them). |
| 7 |
|
| 8 |
Here we'll summarize what is available but this is an ever growing |
| 9 |
resource so this may not cover everything that is out there: |
| 10 |
|
| 11 |
\subsection{Utilities supplied with the model} |
| 12 |
|
| 13 |
We supply some basic scripts with the model to facilitate conversion |
| 14 |
or reading of data into analysis software. |
| 15 |
|
| 16 |
\subsubsection{utils/scripts} |
| 17 |
|
| 18 |
In the directory {\em utils/scripts} you will find {\em joinds} and |
| 19 |
{\em joinmds}: these are perl scripts used from joining the multi-part |
| 20 |
files created by MITgcm. {\bf Use {\em joinmds} always}. You will only |
| 21 |
need {\em joinds} if you are working with output older than two years |
| 22 |
(prior to c23). |
| 23 |
|
| 24 |
\subsubsection{utils/matlab} |
| 25 |
|
| 26 |
In the directory {\em utils/matlab} you will find several Matlab |
| 27 |
scripts (.m or dot-em files). The priniciple script is {\em rdmds.m} |
| 28 |
used for reading the multi-part model output files in to matlab. Place |
| 29 |
the scripts in your matlab path or change the path appropriately, then |
| 30 |
at the matlab prompt type: |
| 31 |
\begin{verbatim} |
| 32 |
>> help rdmds |
| 33 |
\end{verbatim} |
| 34 |
to get help on how to use rdmds. |
| 35 |
|
| 36 |
Another useful script scans the terminal output file for "monitor" |
| 37 |
information. |
| 38 |
|
| 39 |
Most other scripts are for working in the curvilinear coordinate |
| 40 |
systems which as yet are unpublished and undocumented. |
| 41 |
|
| 42 |
\subsubsection{MNC Utils} |
| 43 |
|
| 44 |
The MITgcm netCDF integration is relatively new and the tools used to |
| 45 |
work on netCDF data sets are developing. The following scripts and |
| 46 |
utilities have been written to help manipulate MNC (netCDF) files: |
| 47 |
\begin{description} |
| 48 |
\item[Tile Assembly:] a matlab script {\tt |
| 49 |
utils/matlab/mnc\_assembly.m} is available for spatially |
| 50 |
``assembling'' MNC output. A convenience wrapper script called {\tt |
| 51 |
utils/matlab/gluemnc.m} is also provided. Please use the matlab |
| 52 |
help facility for more information. |
| 53 |
|
| 54 |
\item[gmt:] As MITgcm evolves to handle more complicated domains and |
| 55 |
topologies, a suite of matlab tools is being written to more |
| 56 |
gracefully handle the model files. This suite is called ``gmt'' |
| 57 |
which refers to ``generalized model topology'' pre-/post-processing. |
| 58 |
Currently, this directory contains a matlab script {\tt |
| 59 |
utils/matlab/gmt/rdnctiles.m} that is able to read the MNC-created |
| 60 |
netCDF files for any domain. Additional scripts are being created |
| 61 |
that will work with these fields on a per-tile basis. |
| 62 |
|
| 63 |
\end{description} |
| 64 |
|
| 65 |
|
| 66 |
\subsection{Pre-processing software} |
| 67 |
|
| 68 |
There is a suite of pre-processing software for intepolating |
| 69 |
bathymetry and forcing data, written by Adcroft and Biastoch. At some |
| 70 |
point, these will be made available for download. If you are in need |
| 71 |
of such software, contact one of them. |
| 72 |
|