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 |
|