1 |
% $Header$ |
% $Header$ |
2 |
% $Name$ |
% $Name$ |
3 |
|
|
4 |
\chapter{Diagnostics and I/O - Packages II and Matlab Tools} |
\chapter{Diagnostics and I/O - Packages II, and Post--Processing Utilities} |
5 |
\begin{rawhtml} |
\begin{rawhtml} |
6 |
<!-- CMIREDIR:processing_tools: --> |
<!-- CMIREDIR:processing_tools: --> |
7 |
<!-- CMIREDIR:diagnostics_and_tools: --> |
<!-- CMIREDIR:diagnostics_and_tools: --> |
8 |
\end{rawhtml} |
\end{rawhtml} |
9 |
|
|
|
\section{Diagnostics and I/O} |
|
10 |
|
|
11 |
The MITgcm has several packages that are related to the output |
MITgcm has several packages related to the input and output consumed |
12 |
produced during a model integration that is used for analysis |
and produced during a model integration. The packages used are related |
13 |
of the results. The packages are related to the choice of output |
to the choice of input/output fields and the on-disk format of the model |
14 |
fields and to the format of the model output. |
output. |
15 |
|
|
16 |
\newpage |
\newpage |
17 |
\input{part7/diagnostics.tex} |
\input{part7/diagnostics.tex} |
26 |
\input{part7/monitor.tex} |
\input{part7/monitor.tex} |
27 |
|
|
28 |
\newpage |
\newpage |
29 |
\input{part7/rw.tex} |
\input{part7/grid_gen.tex} |
30 |
|
|
31 |
\newpage |
\newpage |
32 |
\section{Pre- and Post- Processing Scripts and Utilities} |
\input{part7/scripts_and_utils.tex} |
33 |
|
|
34 |
There are numerous tools for pre-processing data, converting model |
\newpage |
35 |
output and analysis written in Matlab, fortran (f77 and f90) and perl. |
\input{part7/pvdiag.tex} |
|
As yet they remain undocumented although many are self-documenting |
|
|
(Matlab routines have "help" written into them). |
|
|
|
|
|
Here we'll summarize what is available but this is an ever growing resource |
|
|
so this may not cover everything that is out there: |
|
|
|
|
|
\subsection{Utilities supplied with the model} |
|
|
|
|
|
We supply some basic scripts with the model to facilitate conversion or reading |
|
|
of data into analysis software. |
|
|
|
|
|
\subsubsection{utils/scripts} |
|
|
|
|
|
In the directory {\em utils/scripts} you will find {\em joinds} and {\em joinmds}: |
|
|
these are perl scripts used from joining the multi-part files created by |
|
|
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). |
|
|
|
|
|
\subsubsection{utils/matlab} |
|
|
|
|
|
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. |
|
|
|
|
|
\subsection{Pre-processing software} |
|
36 |
|
|
|
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. |
|