Welcome to SWM

The SWM is a shallow water model developed at the GEOMAR Helmholtz Centre for Ocean Research Kiel within the research group of Richard Greatbatch. Project maintenance is done by Martin Claus and Willi Rath.

The Model

Here might be a good place for a list of features

Installation

A very brief list of what to do:

• download the model source code
• extract it
• run the configure script (if UDUNITS and/or NETCDF libraries are installed in a non-standard-location, set the UDDIR and/or NETDIR variables or set CPPFLAGS and LDFLAGS)
• adjust Makefile if needed

Setup

Again a very brief list:

• adjust header files
• run make
• prepare input datasets
• adjust namelists
• run the model

Run as Docker container

You may run the model as a docker container. Readily build docker images are available at Docker hub as martinclaus/swm.

To run the model for a specific configuration, you must have the model.h and model.namelist file within the same directory. The absolut path to this directory is called ABS_CONF_PATH here. This directory must be mounted as the volume /run to be available inside the container. Since this directory is the only mounted volume inside the container, both input and output must located within that directory.

docker run -v ABS_CONF_PATH:/run martinclaus/swm:latest

The resources available to the container can be limited when running the container, see the Docker docs. For limiting the CPU usage there are basically two options, --cpus and --cpuset-cpus. The former limits the available CPU resources a container can use while the latter controls which physical cores are available to the container. Since the code uses shared-memory parallelism it is strongly recommended to use --cpuset-cpus. Note that using all available cores will lead to a performance penalty.

docker run -v ABS_CONF_PATH:/run --cpuset-cpus 0-1 martinclaus/swm:latest

Documentation

Todo

List of Applications

• Greatbatch, Richard, Zhai, Xiaoming, Claus, M., Czeschel, Lars and Rath, Willi (2010) Transport driven by eddy momentum fluxes in the Gulf Stream Extension region Geophysical Research Letters, 37 . L24401. doi: 10.1029/2010GL045473
• Claus, Martin (2011) The Gulf Stream Extension Region: Its dynamics and interaction with the atmosphere (Diploma thesis), Christian-Albrechts-Universität, Kiel, Germany, 65 pp
• Greatbatch, R. J., Brandt, P., Claus, M., Didwischus, S. H. and Fu, Y. (2012) On the width of the equatorial deep jets, Journal of Physical Oceanography . doi: 10.1175/JPO-D-11-0238.1.
• Bachelors Thesis by Valentin Kratzsch (2012)
• Bachelors Thesis by Christian Wengel (2012)
• Brandt, P., Greatbatch, R. J., Claus, M., Didwischus, S. H., Hormann, V., Funk, A., Hahn, J., Krahmann, G., Fischer, J. and Körtzinger, A. (2012) Ventilation of the equatorial Atlantic by the equatorial deep jets, Journal of Geophysical Research, 117 (C12). C12015. doi: 10.1029/2012JC008118
• Claus, M., Richard John Greatbatch, and Peter Brandt. (2014) Influence of the Barotropic Mean Flow on the Width and the Structure of the Atlantic Equatorial Deep Jets, Journal of Physical Oceanography 44, pp. 2485–2497. issn: 0022-3670. doi: 10.1175/JPO-D-14-0056.1

And some more!