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