1 |
edhill |
1.5 |
% $Header: /u/gcmpack/manual/part7/part7.tex,v 1.4 2001/11/13 16:14:23 adcroft Exp $ |
2 |
cnh |
1.2 |
% $Name: $ |
3 |
adcroft |
1.1 |
|
4 |
cnh |
1.2 |
\chapter{Diagnostics and tools} |
5 |
edhill |
1.5 |
\begin{rawhtml} |
6 |
|
|
<!-- CMIREDIR:diagnostics_and_tools: --> |
7 |
|
|
\end{rawhtml} |
8 |
adcroft |
1.3 |
|
9 |
|
|
There are numerous tools for pre-processing data, converting model |
10 |
|
|
output and analysis written in Matlab, fortran (f77 and f90) and perl. |
11 |
|
|
As yet they remain undocumented although many are self-documenting |
12 |
|
|
(Matlab routines have "help" written into them). |
13 |
|
|
|
14 |
|
|
Here we'll summarize what is available but this is an ever growing resource |
15 |
|
|
so this may not cover everything that is out there: |
16 |
|
|
|
17 |
|
|
\section{Utilities supplied with the model} |
18 |
|
|
|
19 |
|
|
We supply some basic scripts with the model to facilitate conversion or reading |
20 |
|
|
of data into analysis software. |
21 |
|
|
|
22 |
|
|
\subsection{utils/scripts} |
23 |
|
|
|
24 |
adcroft |
1.4 |
In the directory {\em utils/scripts} you will find {\em joinds} and {\em joinmds}: |
25 |
adcroft |
1.3 |
these are perl scripts used from joining the multi-part files created by |
26 |
|
|
MITgcm. {\bf Use {\em joinmds} always}. You will only need {\em joinds} if you |
27 |
|
|
are working with output older than two years (prior to c23). |
28 |
|
|
|
29 |
|
|
\subsection{utils/matlab} |
30 |
|
|
|
31 |
|
|
In the directory {\em utils/matlab} you will find several Matlab scripts |
32 |
|
|
(.m or dot-em files). The priniciple script is {\em rdmds.m} used for reading |
33 |
|
|
the multi-part model output files in to matlab. Place the scripts in your |
34 |
|
|
matlab path or change the path appropriately, then at the matlab prompt type: |
35 |
|
|
\begin{verbatim} |
36 |
|
|
>> help rdmds |
37 |
|
|
\end{verbatim} |
38 |
|
|
to get help on how to use rdmds. |
39 |
|
|
|
40 |
|
|
Another useful script scans the terminal output file for "monitor" information. |
41 |
|
|
|
42 |
|
|
Most other scripts are for working in the curvilinear coordinate systems which |
43 |
|
|
as yet are unpublished and undocumented. |
44 |
|
|
|
45 |
|
|
\section{Pre-processing software} |
46 |
|
|
|
47 |
|
|
There is a suite of pre-processing software for intepolating bathymetry |
48 |
|
|
and forcing data, written by Adcroft and Biastoch. At some point, |
49 |
|
|
these will be made available for download. If you are in need of such |
50 |
|
|
software, contact one of them. |