S-Coordinates Rutgers University Model (SCRUM)
SUBSCRIPTION
To subscribe to the SCRUM's mailing list, please send a message to
majordomo@imcs.rutgers.edu with no subject and the following line
in the body of the message:
subscribe scrum
or to unsubscribe send the following line:
unsubscribe scrum
or to inquire information about the mailing list manager send the
following line:
help
Announcements of new versions and patches will be sent to the SCRUM's
mailing list.
INQUIRING
Please report all bugs or feel free to contact me at:
Hernan G. Arango
Institute of Marine and Coastal Sciences
Rutgers University
71 Dubley Road
New Brunswick, NJ 08901-8521
off: (732) 932-6555 x266
fax: (732) 932-6520
arango@ahab.rutgers.edu
MANUAL
There is a draft SCRUM
manual written by Kate Hedstrom. It contains a color
figure which you might want separately.
OCEAN MODEL
SCRUM solves the free surface, hydrostatic, primitive equations over
variable topography using stretched terrain-following coordinates in
the vertical and orthogonal curvilinear coordinates in the horizontal.
Earlier versions of SCRUM are described in:
Song, Y. and D. Haidvogel, 1994: A semi-implicit ocean
circulation model using a generalized topography-
following coordinate system, J. Comp. Physics,
115, 228-244.
The model equations are solved separately for total momentum and
vertically integrated momentum and then coupled. The total momentum
and tracer equations are time discretized using a third order
Adams-Bashforth scheme; the vertical viscosity/diffusion terms are
treated implicitly using a Crank-Nicolson scheme. The free-surface
and vertically integrated momentum equations are time discretized
using a trapezoidal Leapfrog scheme. Horizontal and vertical
derivatives are evaluated using finite differences on a staggered
horizontal C-grid and a staggered vertical grid.
New Features: (+ completed; * ongoing testing; - under development;
~ near future)
-
[+]
Vertical staggered grid.
-
[+]
Vertical finite elements are replaced by finite differences.
-
[*]
Option for Horizontal and vertical Smolarkiewicz advection.
-
[+]
Rotated mixing tensors to mix on constant z-surfaces and
constant "in situ" density surfaces.
-
[+]
Several vertical closures:
-
(+)
Pacanowski and Philander (1981) mixing scheme.
-
(+)
Mellor and Yamada (1974) level 2 closure.
-
(+)
Mellor and Yamada (1982) level 2.5 closure.
-
(+)
Large, McWilliams, and Doney (1994) oceanic planetary
boundary layer and ocean interior mixing scheme.
-
[*]
Styles and Glenn (1996) coupled bottom boundary layer model.
-
[-]
Lagrangian drifters.
-
[+]
Analytical and data driven packages for initial conditions,
boundary conditions, and forcing functions.
-
[*]
Analytical test examples.
-
[+]
Parallel/Serial Land/Sea masking.
-
[+]
Input/output via NetCDF.
-
[*]
Coupled Sea-Ice model (Kate Hedstrom and Paul Budgell).
-
[*]
Grid generation and Land/Sea mask packages.
-
[+]
Forcing package to generate forcing NetCDF file.
-
[*]
Data assimilation scheme.
-
[~]
Coupled biological model.
-
[+]
User's Manual.
The model is fully documented in each file component. The
programming style is very consistent and clear. All variables are
documented in the include (.h) files. Mostly all dimensional
variables are given in MKS units. There are numerous C-preprocessing
options which allows to conditionally select and compile sections of
the code. The User needs to modify the file "scrumdefs.h" to
activate or deactivate available C-preprocessing options. These
C-preprocessing options are documented in "scrumdefs.h". All internal
parameters are initialized via a block data routine "blkdat". It is
unlikely that the User have to change these internal parameters.
Input parameters into the model are via input script "scrum.in". All
input parameters are well documented in this script file. Domain
dimension parameters are specified in include file "param.h".
SOFTWARE AND INSTALLATION
INSTALL The system requirements and links to the
SCRUM software components are described on this web page.
PLOTTING PACKAGE
The directory "scrum/plot" contains the plotting package for SCRUM.
The SCRUM data is stored in NetCDF . There are two output
NetCDF files in SCRUM: restart and history. As the name indicates,
the restart NetCDF file is used to restart a model run. It can have
two or more time records. Two time-records are recommended; the user
can recycle these two time records. See documentation for parameters
NRST and LCYCLE in input script "scrum.in". The history file contains
the fields requested by User at requested levels and time interval.
See parameters NWRT, LDEFHIS, NLEV, LEV, and various logical switches
in input script file "scrum.in".
This plotting package has four executable programs:
-
cnt
- horizontal contours, non-color version.
Input script: cnt.in
-
ccnt
- horizontal contours, color version.
Input script: ccnt.in
-
sec
- cross-section contours, non-color version.
Input script: sec.in
-
csec
- cross-section contours, color version.
Input script: csec.in
These plotting programs are complex. They are generic in the sense
that the same executable can be used to plot different applications.
See documentation in input script files "cnt.in", "ccnt.in", "sec.in",
and "csec.in". Also see documentation in contour parameters files
"scrum/plot/Data/default.cnt" or "scrum/plot/Data/scrum.cnt". The
color palettes are documented in directory "scrum/plot/Palettes".
