1 |
% $Header$ |
% $Header$ |
2 |
% $Name$ |
% $Name$ |
3 |
|
|
4 |
\chapter{Diagnostiacs and tools} |
\chapter{Diagnostics and I/O - Packages II and Matlab Tools} |
5 |
|
\begin{rawhtml} |
6 |
|
<!-- CMIREDIR:processing_tools: --> |
7 |
|
<!-- CMIREDIR:diagnostics_and_tools: --> |
8 |
|
\end{rawhtml} |
9 |
|
|
10 |
|
\section{Diagnostics and I/O} |
11 |
|
|
12 |
|
The MITgcm has several packages that are related to the output |
13 |
|
produced during a model integration that is used for analysis |
14 |
|
of the results. The packages are related to the choice of output |
15 |
|
fields and to the format of the model output. |
16 |
|
|
17 |
|
\newpage |
18 |
|
\input{part7/diagnostics.tex} |
19 |
|
|
20 |
|
\newpage |
21 |
|
\input{part7/mnc.tex} |
22 |
|
|
23 |
|
\newpage |
24 |
|
\input{part7/mdsio.tex} |
25 |
|
|
26 |
|
\newpage |
27 |
|
\input{part7/monitor.tex} |
28 |
|
|
29 |
|
\newpage |
30 |
|
\input{part7/rw.tex} |
31 |
|
|
32 |
|
\newpage |
33 |
|
\section{Pre- and Post- Processing Scripts and Utilities} |
34 |
|
|
35 |
|
There are numerous tools for pre-processing data, converting model |
36 |
|
output and analysis written in Matlab, fortran (f77 and f90) and perl. |
37 |
|
As yet they remain undocumented although many are self-documenting |
38 |
|
(Matlab routines have "help" written into them). |
39 |
|
|
40 |
|
Here we'll summarize what is available but this is an ever growing resource |
41 |
|
so this may not cover everything that is out there: |
42 |
|
|
43 |
|
\subsection{Utilities supplied with the model} |
44 |
|
|
45 |
|
We supply some basic scripts with the model to facilitate conversion or reading |
46 |
|
of data into analysis software. |
47 |
|
|
48 |
|
\subsubsection{utils/scripts} |
49 |
|
|
50 |
|
In the directory {\em utils/scripts} you will find {\em joinds} and {\em joinmds}: |
51 |
|
these are perl scripts used from joining the multi-part files created by |
52 |
|
MITgcm. {\bf Use {\em joinmds} always}. You will only need {\em joinds} if you |
53 |
|
are working with output older than two years (prior to c23). |
54 |
|
|
55 |
|
\subsubsection{utils/matlab} |
56 |
|
|
57 |
|
In the directory {\em utils/matlab} you will find several Matlab scripts |
58 |
|
(.m or dot-em files). The priniciple script is {\em rdmds.m} used for reading |
59 |
|
the multi-part model output files in to matlab. Place the scripts in your |
60 |
|
matlab path or change the path appropriately, then at the matlab prompt type: |
61 |
|
\begin{verbatim} |
62 |
|
>> help rdmds |
63 |
|
\end{verbatim} |
64 |
|
to get help on how to use rdmds. |
65 |
|
|
66 |
|
Another useful script scans the terminal output file for "monitor" information. |
67 |
|
|
68 |
|
Most other scripts are for working in the curvilinear coordinate systems which |
69 |
|
as yet are unpublished and undocumented. |
70 |
|
|
71 |
|
\subsection{Pre-processing software} |
72 |
|
|
73 |
|
There is a suite of pre-processing software for intepolating bathymetry |
74 |
|
and forcing data, written by Adcroft and Biastoch. At some point, |
75 |
|
these will be made available for download. If you are in need of such |
76 |
|
software, contact one of them. |