7.6.1 Utilities supplied with the model

About

Installation

Tutorials

Documentation

1.1 Introduction

1.3 Continuous equations in `r' coordinates

2. Discretization and Algorithm

4. Software Architecture

5. Automatic Differentiation

6. Physical Parameterization and Packages

7. Diagnostics and tools

8. Interface with ECCO

Browse Code

PDF file (9Mb)

PS file (7Mb)

Next: 7.6.2 Pre-processing software Up: 7.6 Pre- and Post-Processing Previous: 7.6 Pre- and Post-Processing Contents

Subsections

7.6.1 Utilities supplied with the model

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

7.6.1.1 utils/scripts

In the directory utils/scripts you will find joinds and joinmds: these are perl scripts used from joining the multi-part files created by MITgcm. Use joinmds always. You will only need joinds if you are working with output older than two years (prior to c23).

7.6.1.2 utils/matlab

In the directory utils/matlab you will find several Matlab scripts (.m or dot-em files). The priniciple script is 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:

  >> help rdmds

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.

7.6.1.3 MNC Utils

The MITgcm netCDF integration is relatively new and the tools used to work on netCDF data sets are developing. The following scripts and utilities have been written to help manipulate MNC (netCDF) files:

Tile Assembly:: a matlab script utils/matlab/mnc_assembly.m is available for spatially ``assembling'' MNC output. A convenience wrapper script called utils/matlab/gluemnc.m is also provided. Please use the matlab help facility for more information.
gmt:: As MITgcm evolves to handle more complicated domains and topologies, a suite of matlab tools is being written to more gracefully handle the model files. This suite is called ``gmt'' which refers to ``generalized model topology'' pre-/post-processing. Currently, this directory contains a matlab script utils/matlab/gmt/rdnctiles.m that is able to read the MNC-created netCDF files for any domain. Additional scripts are being created that will work with these fields on a per-tile basis.

Next: 7.6.2 Pre-processing software Up: 7.6 Pre- and Post-Processing Previous: 7.6 Pre- and Post-Processing Contents

mitgcm-support@mitgcm.org

Last update 2011-01-09