/[MITgcm]/manual/s_outp_pkgs/text/scripts_and_utils.tex
ViewVC logotype

Annotation of /manual/s_outp_pkgs/text/scripts_and_utils.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.3 - (hide annotations) (download) (as text)
Tue Jun 27 22:33:02 2006 UTC (19 years, 1 month ago) by edhill
Branch: MAIN
CVS Tags: checkpoint01, HEAD
Changes since 1.2: +15 -5 lines
File MIME type: application/x-tex
add brief bit about matlab/gmt

1 edhill 1.1 \section{Pre-- and Post--Processing Scripts and Utilities}
2    
3     There are numerous tools for pre-processing data, converting model
4     output and analysis written in Matlab, fortran (f77 and f90) and perl.
5     As yet they remain undocumented although many are self-documenting
6     (Matlab routines have "help" written into them).
7    
8     Here we'll summarize what is available but this is an ever growing
9     resource so this may not cover everything that is out there:
10    
11     \subsection{Utilities supplied with the model}
12    
13     We supply some basic scripts with the model to facilitate conversion
14     or reading of data into analysis software.
15    
16     \subsubsection{utils/scripts}
17    
18     In the directory {\em utils/scripts} you will find {\em joinds} and
19     {\em joinmds}: these are perl scripts used from joining the multi-part
20     files created by MITgcm. {\bf Use {\em joinmds} always}. You will only
21     need {\em joinds} if you are working with output older than two years
22     (prior to c23).
23    
24     \subsubsection{utils/matlab}
25    
26     In the directory {\em utils/matlab} you will find several Matlab
27     scripts (.m or dot-em files). The priniciple script is {\em rdmds.m}
28     used for reading the multi-part model output files in to matlab. Place
29     the scripts in your matlab path or change the path appropriately, then
30     at the matlab prompt type:
31     \begin{verbatim}
32     >> help rdmds
33     \end{verbatim}
34     to get help on how to use rdmds.
35    
36     Another useful script scans the terminal output file for "monitor"
37     information.
38    
39     Most other scripts are for working in the curvilinear coordinate
40     systems which as yet are unpublished and undocumented.
41    
42     \subsubsection{MNC Utils}
43    
44 edhill 1.3 The MITgcm netCDF integration is relatively new and the tools used to
45     work on netCDF data sets are developing. The following scripts and
46     utilities have been written to help manipulate MNC (netCDF) files:
47 edhill 1.1 \begin{description}
48 edhill 1.2 \item[Tile Assembly:] a matlab script {\tt
49 edhill 1.1 utils/matlab/mnc\_assembly.m} is available for spatially
50 edhill 1.3 ``assembling'' MNC output. A convenience wrapper script called {\tt
51     utils/matlab/gluemnc.m} is also provided. Please use the matlab
52     help facility for more information.
53    
54     \item[gmt:] As MITgcm evolves to handle more complicated domains and
55     topologies, a suite of matlab tools is being written to more
56     gracefully handle the model files. This suite is called ``gmt''
57     which refers to ``generalized model topology'' pre-/post-processing.
58     Currently, this directory contains a matlab script {\tt
59     utils/matlab/gmt/rdnctiles.m} that is able to read the MNC-created
60     netCDF files for any domain. Additional scripts are being created
61     that will work with these fields on a per-tile basis.
62 edhill 1.1
63     \end{description}
64    
65    
66     \subsection{Pre-processing software}
67    
68     There is a suite of pre-processing software for intepolating
69     bathymetry and forcing data, written by Adcroft and Biastoch. At some
70     point, these will be made available for download. If you are in need
71     of such software, contact one of them.
72    

  ViewVC Help
Powered by ViewVC 1.1.22