s_outp_pkgs/text/top_section.tex

% $Header: /u/gcmpack/manual/part7/part7.tex,v 1.6 2005/07/14 19:19:38 molod Exp $
% $Name:  $

\chapter{Pre-processsing and Post-processing Tools}
\begin{rawhtml}
<!-- CMIREDIR:processing_tools: -->
<!-- CMIREDIR:diagnostics_and_tools: -->
\end{rawhtml}

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

Here we'll summarize what is available but this is an ever growing resource
so this may not cover everything that is out there:

\section{Utilities supplied with the model}

We supply some basic scripts with the model to facilitate conversion or reading
of data into analysis software.

\subsection{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).

\subsection{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.

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