Model help:ROMS

ROMS

ROMS is a community model shared by a large user group around the world, with applications ranging from the study of entire ocean basins to coastal sub-regions.

Model introduction

ROMS incorporates advanced features and high-order numerics, allowing efficient and robust resolution of mesoscale dynamics in the oceanic and coastal domains. The model solves the free surface, hydrostatic, primitive equations of the fluid dynamics over variable topography using stretched; terrain-following coordinates in the vertical and orthogonal, curvilinear coordinates in the horizontal. This allows enhancement of the spatial resolution in the regions of interest.

Model parameters

Parameter	Description	Unit
<span class= Input directory	<span class= Path to input directory	-
Input File name	Name of input file	-
Site prefix	Site prefix for input/output files	-
Case prefix	Case prefix for input/output files	-
ROMS application title	-	-
C-preprocessing flag	-	-
Variable information filename	-	-
Runinterval	timestep multiplied by timestep size (In cases where input is read from a file rather than GUI	second

Parameter	Description	Unit
<span class=Number of nested grids	<span class= -	<span class= -
Number of nodes in I-direction	number of I-direction interior rho-points	-
Number of nodes in J-direction	number of J-direction interior rho-points	-
Number of vertical levels	-	-
Number of sediment bed layers	-	-
Number of active tracers	usually 2; e.g., temperature and salinity	-
Number of inactive passive tracers	-	-
Number of cohesive (mud) sediment tracers	-	-
Number of non-cohesive (sand) sediment tracers	-	-
Number of titles in I-direction	used for parallel mode	-
Number of titles in J-direction	used for parallel mode	-

Parameter	Description	Unit
<span class=Number of timesteps	<span class= -	<span class= -
Timestep size	-	seconds
Number of barotropic steps	-	-
Starting perturbation or iteration	-	-
Ending perturbation or iteration	-	-
Max number of 4DVar outer loop iterations	-	-
Max number of 4DVar inner loop iterations	-	-
Number of stochastic optimals interval divisions	-	-
Number of eigenvalues for GST analysis	-	-
Number of eigenvectors for GST analysis	-	-

Parameter	Description	Unit
<span class= Model restart flag	<span class= -	<span class= -
Switch to recycle restart records	True (T) or False (F)	-
Number of time-steps between restart records	-	-
Number of time-steps between stations records	-	-
Number of time-steps between floats records	-	-
Number of time-steps between info diagnostics	-	-
Switch to create (T) or append (F) files	True (T) or False (F)	-
Number of time-steps between history records	-	-
Number of time-steps between creation of new history file	-	-
Starting averages timestep	-	-
Number of time-steps between averages records	-	-
Number of time-steps between creation of new averages file	-	-
Starting diagnostics timestep	-	-
Number of time-steps between diagnostics records	-	-
Number of time-steps between creation of new diagnostics file	-	-
Number to recycle TLM time records	True (T) or False (F)	-
Number of time-steps between creation of new TLM file	-	-
Switch to recycle ADM time records	True (T) or False (F)	-
Number of time-steps between ADM records	-	-
Number of time-steps between creation of new ADM file	-	-
Number of time-steps between 4DVAR adjustment of SFF	Number of time-steps between 4DVAR adjustment of surface forcing flux	-
Number of time-steps between 4DVAR adjustment of OBF	Number of time-steps between 4DVAR adjustment of open boundary fields	-
Switch for GST restart	Generalized Stability Theory restart switch (T or F)	-
Maximum number of iterations for GST	Maximum number of iterations for Generalized Stability Theory	-
Checking point interval for GST	Checking point interval for Generalized Stability Theory	-

Parameter	Description	Unit
<span class= Relative accuracy of Ritz values in GST	<span class= Relative accuracy of Ritz values in Generalized Stability Theory	<span class= -
Harmonic horiz. diffusion coeff. for tracers (I-dir, NLM)	Harmonic horizontal diffusion coefficient for tracers in NONLINEAR model in I-direction	m^2/s
Harmonic horiz. diffusion coeff. for tracers (J-dir, NLM)	Harmonic horizontal diffusion coefficient for tracers in NONLINEAR model in J-direction	m^2/s
Biharmonic horiz. diffusion for tracers (I-dir, NLM)	Biharmonic horizontal diffusion coefficient for tracers in NONLINEAR model in I-direction	m^4/s
Biharmonic horiz. diffusion for tracers (J-dir, NLM)	Biharmonic horizontal diffusion coefficient for tracers in NONLINEAR model in J-direction	m^4/s
Harmonic horiz. diffusion coeff. for tracers (I-dir, ADJ)	Harmonic horizontal diffusion coefficient for tracers in ADJOINT model in the I-direction	m^2/s
Harmonic horiz. diffusion coeff. for tracers (J-dir, ADJ)	Harmonic horizontal diffusion coefficient for tracers in ADJOINT model in the I-direction	m^2/s
Biharmonic horiz. diffusion for tracers (I-dir, ADJ)	Biharmonic horizontal diffusion coefficient for tracers in ADJOINT model in I-direction	m^4/s
Biharmonic horiz. diffusion for tracers (J-dir, NLM)	Biharmonic horizontal diffusion coefficient for tracers in ADJOINT model in J-direction	m^4/s
Harmonic horiz. viscosity coeff. (NLM)	Harmonic horizontal viscosity coefficient in NONLINEAR model	m^2/s
Biharmonic horiz. viscosity coeff. (NLM)	Biharmonic horizontal viscosity coefficient in NONLINEAR model	m^4/s
Harmonic horiz. viscosity coeff. (ADJ)	Harmonic horizontal viscosity coefficient in ADJOINT model	m^2/s
Biharmonic horiz. viscosity coeff. (ADJ)	Biharmonic horizontal viscosity coefficient in ADJOINT model	m^4/s
Background vert. mixing coeff. for active tracers (NLM)	Background vertical mixing coefficient for active tracers in NOLINEAR model	m^2/s
Background vert. mixing coeff. for passive tracers (NLM)	Background vertical mixing coefficient for passive tracers in NOLINEAR model	m^2/s
Background vert. mixing coeff. for active tracers (ADI)	Background vertical mixing coefficient for active tracers in ADJOINT model	-
Background vert. mixing coeff. for passive tracers (ADI)	Background vertical mixing coefficient for passive tracers in ADJOINT model	-
	Background vert. mixing coeff. for momentum (NLM)	Background vertical mixing coefficient for momentum in NOLINEAR model	m^2/s
Background vert. mixing coeff. for momentum (ADJ)	Background vertical mixing coefficient for momentum in ADJOINT model	-

Parameter	Description	Unit
<span class= Turbulent closure parameter 1	<span class= -	<span class= m^2/s
Turbulent closure parameter 2	-	m^2/s
Turbulent closure parameter 3	-	m^2/s
Turbulent closure parameter 3	-	m^4/s
K-epsilon parameter for GLS	K-epsilon parameter (Generic Length Scale closure)	-
Turbulent kinetic energy exponent for GLS	Turbulent kinetic energy exponent (Generic Length Scale closure)	-
Turbulent length scale exponent for GLS	Turbulent length scale exponent (Generic Length Scale closure)	-
Min value of specific turbulent energy for GLS	Min value of specific turbulent energy (Generic Length Scale closure)	-
Min value of dissipation for GLS	Min value of dissipation (Generic Length Scale closure)	-
Stability coefficient (GLS, closure indep.)	Stability coefficient (Generic Length Scale closure)	-
Shear production coefficient (GLS, closure indep.)	Shear production coefficient (Generic Length Scale closure)	-
Dissipation coefficient (GLS, closure indep.)	Dissipation coefficient (Generic Length Scale closure)	-
Buoyancy production coefficient, minus (GLS, closure indep)	Buoyancy production coefficient, minus (Generic Length Scale closure)	-
Buoyancy production coefficient, plus (GLS, closure indep.)	Buoyancy production coefficient, plus (Generic Length Scale closure)	-
Constant Schmidt number for turb.KE diffusivity (GLS, closure indep.)	Constant schmidt number for turbulent kinetic energy diffusivity (Generic Length Scale closure)	-
Constant Schmidt number for turb. "psi" field (GLS, closure indep.)	Constant schmidt number for turbulent generic statistical field, "psi" (Generic Length Scale closure)	-
Charnok surface roughness	-	-
	Roughness from wave amplitude	-	-
Roughness from wave dissipation	-	-
Graig and Banner wave breaking coefficient	-	-

Parameter	Description	Unit
<span class= Momentum stress constant 1	<span class= constant used in momentum stress computation	<span class= m/s
Momentum stress constant 2	constant used in momentum stress computation	-
Momentum stress constant 3	constant used in momentum stress computation	m
Momentum stress constant 4	constant used in momentum stress computation	m
Height of measurement for air humidity (bulk flux)	Height of atmospheric measurement for air humidity (bulk flux)	m
Height of measurement for air temperature (bulk flux)	Height of atmospheric measurement for air temperature (bulk flux)	m
Height of measurement for winds (bulk flux)	Height of atmospheric measurement for winds (bulk flux)	m
Min depth for wetting and drying	-	m
Jerlov water type for shortwave radiation depth scale	Jerlov water type used to set vertical depth scale for shortwave radiation depth scale	-
Deepest level to apply surf. momentum stress as a body force	-	-
Shallowest level to apply surf. momentum stress as a body force	-	-
Mean water density	-	kg/m^3
Brunt-Vaisala frequency	-	1/s^2
Time-stamp for model initilization	-	days
Reference time origin for tidal forcing	-	days
Model reference time for output NetCDF units attribute	-	yyyymmdd.dd
	-	-
	Roughness from wave amplitude	-	-
Roughness from wave dissipation	-	-
Graig and Banner wave breaking coefficient	-	-

Uses ports

This will be something that the CSDMS facility will add

Provides ports

This will be something that the CSDMS facility will add

Main equations

A list of the key equations. HTML format is supported; latex format will be supported in the future

Notes

Any notes, comments, you want to share with the user

Numerical scheme

Examples

An example run with input parameters, BLD files, as well as a figure / movie of the output

Follow the next steps to include images / movies of simulations:

Upload file: http://csdms.colorado.edu/wiki/Special:Upload
Create link to the file on your page: [[Image:<file name>]].

Developer(s)

Name of the module developer(s)

References

Key papers

Links

Any link, eg. to the model questionnaire, etc.