Variables

Variables

This wikipage includes all ROMS global variables in alphabetic order. A single long page is built to facilitate printing. Each variable has a unique anchor tag to facilitate linking from any wikipage.

F

FLTname

Output floats data file name.

dimension = FLTname(Ngrids)

option =

routine = mod_iounits.F

keyword = FLTNAME

input = ocean.in

fposnam

Input initial floats positions file name (floats.in).

option = FLOATS

routine = mod_iounits.F

keyword = FPOSNAM

input = ocean.in

frrec

Flag to indicate re-start from a previous solution. For new solutions (not a model restart) use frrec=0. In a re-start solution, frrec is the time index in the floats NetCDF file assigned for initialization. If frrec is negative (say frrec=-1), the floats will re-start from the most recent time record. That is, the initialization record is assigned internally.

dimension = frrec(Ngrids)

option = FLOATS

routine = mod_scalars.F

keyword = FRREC

input = floats.in

H

Hout

Set of switches that determine what fields are written to the history output file (HISname).

dimension = Hout(NV,Ngrids)

option =

routine = mod_ncparam.F

keyword = Hout

input = ocean.in

HISname

Output history data file name.

dimension = HISname(Ngrids)

option =

routine = mod_iounits.F

keyword = HISNAME

input = ocean.in

Hz

Vertical level thicknesses, $\,H_{z}\,(\xi ,\eta ,s)$.

dimension = Hz(LBi:UBi,LBj:UBj,N(ng))

pointer = GRID(ng)%Hz

tangent = tl_Hz

adjoint = ad_Hz

units = meter

grid = ρ-points

option = SOLVE3D

routine = set_depths.F

I

Iend

Non-overlapping upper bound tile index in the i-direction. Its value depends on the tile rank (sub-domain partition).

routine = tile.h, get_tile.F

Istr

Non-overlapping lower bound tile index in the i-direction. Its value depends on the tile rank (sub-domain partition).

routine = tile.h, get_tile.F

idbio

Identification indexes for biological tracer variables, t(:,:,:,:,idbio(:)).

dimension = idbio(NBT)

option = BIOLOGY

routine = mod_scalars.F

idsed

Identification indexes for biological tracer variables, t(:,:,:,:,idsed(:)).

dimension = idsed(NST)

option = SEDIMENT

routine = mod_scalars.F

inert

Identification indexes for inert tracer variables, t(:,:,:,:,inert(:)).

dimension = inert(NPT)

option = T_PASSIVE

routine = mod_scalars.F

isalt

Tracer identification index for salinity, t(:,:,:,:,isalt).

routine = mod_scalars.F

itemp

Tracer identification index for potential temperature, t(:,:,:,:,itemp).

routine = mod_scalars.F

J

Jend

Non-overlapping upper bound tile index in the j-direction. Its value depends on the tile rank (sub-domain partition).

routine = tile.h, get_tile.F

Jstr

Non-overlapping lower bound tile index in the j-direction. Its value depends on the tile rank (sub-domain partition).

routine = tile.h, get_tile.F

L

LBi

Array lower bound dimension in the i-direction. In serial and shared-memory applications its value is LBi=-2 for East-West periodic grids or LBi=0 for non-periodic grids . In distributed-memory its value is a function of the tile partition, LBi=Istr-NghostPoints.

option = LOWER_BOUND_I

routine = get_bounds.F, get_tile.F

LBj

Array lower bound dimension in the j-direction. In serial and shared-memory applications its value is LBj=-2 for North-South periodic grids or LBj=0 for non-periodic grids . In distributed-memory its value is a function of the tile partition, LBj=Jstr-NghostPoints.

option = LOWER_BOUND_J

routine = get_bounds.F, get_tile.F

Lfloats

Switch to control the computation of floats trajectories within nested and/or multiple connected grids. Ngrids values are expected. By default this switch is set to TRUE in mod_scalars.F for all grids when the CPP option FLOATS is activated. The user can control which grids to process by turning on/off this switch.

dimension = Lfloats(Ngrids)

option = FLOATS

routine = mod_scalars.F

keyword = Lfloats

input = floats.in

Lsediment

Switch is used to control sediment model computation within nested and/or multiple connected grids. Ngrids values are expected. By default this switch is set to TRUE in mod_scalars.F for all grids when the CPP option SEDIMENT is activated. The user can control which grids to process by turning on/off this switch.

dimension = Lsediment(Ngrids)

option = SEDIMENT

routine = mod_scalars.F

keyword = Lsediment

input = sediment.in

Lstations

Switch to control the writing of station data within nested and/or multiple connected grids. Ngrids values are expected. By default this switch is set to TRUE in mod_scalars.F for all grids when the CPP option STATIONS is activated. The user can control which grids to process by turning on/off this switch.

dimension = Lstations(Ngrids)

option = STATIONS

routine = mod_scalars.F

keyword = Lstations

input = stations.in

N

N

Number of vertical levels for each nested grid.

dimension = N(Ngrids)

routine = mod_param.F

NAT

Number of active tracer-type variables. Usually, it has a value of two for potential temperature and salinty.

option = SOLVE3D

routine = mod_param.F

NBT

Number of biological tracer-type variables.

option = BIOLOGY

routine = mod_param.F

NCS

Number of cohesive (mud) sediment tracer-type variables.

option = SEDIMENT

routine = mod_param.F

Nfloats

Number of floats to release in each nested grid. Value(s) are used to dynamically allocate the arrays in FLOATS array structure. Ngrids values are expected.

dimension = Nfloats(Ngrids)

option = FLOATS

routine = mod_floats.F init_param.F

keyword = NFLOATS

input = floats.in

NghostPoints

Number of ghost points in the halo region used in distributed-memory configurations.

option = GHOST_POINTS

routine = mod_param.F

Ngrids

Number of nested and/or multiple connected grids to solve.

routine = mod_param.F

NNS

Number of non-cohesive (sand) sediment tracer-type variables.

option = SEDIMENT

routine = mod_param.F

NPT

Number of inert tracer-type variables. Currently, an inert passive tracer is one that it is only advected and diffused. Other processes are ignored. These tracers include, for example, dyes, pollutants, oil spills, etc.

option = T_PASSIVE

routine = mod_param.F

NST

Number of sediment tracer-type variables, NST=NCS+NNS.

option = SEDIMENT

routine = mod_param.F

Nstation

Number of stations to process in each nested grid. Value(s) are used to dynamically allocate the station arrays. Ngrids values are expected.

dimension = Nstation(Ngrids)

option = STATIONS

routine = mod_param.F

keyword = NSTATION

input = stations.in

NT

Total number of tracer-type variables for each nested grid. Currently, NT=NAT+NPT+NST+NBT.

dimension = NT(Ngrids)

option = SOLVE3D

routine = mod_param.F

input = ocean.in

NV

Maximum number of variables in information arrays. Currently, 500.

option =

routine = mod_ncparam.F

input = ocean.in

R

rho

In situ density anomaly computed as a function of potential temperature, salinity, and depth.

$\,\sigma (\xi ,\eta ,s)=\rho (\xi ,\eta ,s)-1000$.

dimension = rho(LBi:UBi,LBj:UBj,N(ng))

pointer = OCEAN(ng)%rho

tangent = tl_rho

adjoint = ad_rho

units = kilogram meter^-3

grid = ρ-points

option = SOLVE3D, NONLIN_EOS

routine = rho_eos.F

It can computed using a linear or nonlinear equation of state. The nonlinear equation of state is based on Jackett and McDougall (1992) polynomial expressions.

S

Sout

Set of switches that determine what fields are written to the stations output file (STAname).

dimension = Sout(NV,Ngrids)

option = STATIONS

routine = mod_ncparam.F

keyword = Sout

input = stations.in

sposnam

Input initial stations positions (stations.in) file name.

option = STATIONS

routine = mod_iounits.F

keyword = SPOSNAM

input = ocean.in

STAname

Output station data file name.

dimension = STAname(Ngrids)

option =

routine = mod_iounits.F

keyword = STANAME

input = ocean.in

T

t

Tracer-type variables, $\,T(\xi ,\eta ,s,t,itrc)$.

dimension = t(LBi:UBi,LBj:UBj,N(ng),3,NT(ng))

pointer = OCEAN(ng)%t

tangent = tl_t

adjoint = ad_t

grid = ρ-points

option = SOLVE3D

routine = step3d_t.F

This array contains all the tracer fields. They are classified as active (potential temperature, salinity), inert (dyes, pollutants, oil spills, etc), passive (sediment, biology). There is a index identifier for each tracer field (see table below). Notice that salinity does not have physical units. Usually PSU is used to indicate that the practical salinity scale was used to determine conductivity.

Index	Field	Units	CPP
itemp	Potential temperature	Celsius	SOLVE3D
isalt	Salinity	None	SALINITY
inert(1:NPT)	NPT inert tracers	kilogram meter-3	T_PASSIVE
idsed(1:NST)	NST sediment tracers	kilogram meter-3	SEDIMENT
idbio(1:NBT)	NBT biology tracers	millimole meter-3	BIOLOGY

U

UBi

Array upper bound dimension in the i-direction. In serial and shared-memory applications its value is govern by the value of UPPER_BOUND_I. In distributed-memory its value is a function of the tile partition, UBi=Iend+NghostPoints.

option = UPPER_BOUND_I

routine = get_bounds.F, get_tile.F

UBj

Array upper bound dimension in the j-direction. In serial and shared-memory applications its value is govern by the value of UPPER_BOUND_J. In distributed-memory its value is a function of the tile partition, UBj=Jend+NghostPoints.

option = UPPER_BOUND_J

routine = get_bounds.F, get_tile.F

u

Total momentum component in the ξ-direction, $\,u(\xi ,\eta ,s,t)$.

dimension = u(LBi:UBi,LBj:UBj,N(ng),2)

pointer = OCEAN(ng)%u

tangent = tl_u

adjoint = ad_u

units = meter second^-1

grid = u-points

option = SOLVE3D

routine = step3d_uv.F

ubar

Vertically-integrated momentum component in the ξ-direction, ${\bar {u}}(\xi ,\eta ,t)$.

${\bar {u}}={\frac {1}{D}}\int _{-h}^{\zeta }u\,H_{z}\,dz$

dimension = ubar(LBi:UBi,LBj:UBj,3)

pointer = OCEAN(ng)%ubar

tangent = tl_ubar

adjoint = ad_ubar

units = meter second^-1

grid = u-points

routine = step2d.F

V

v

3D momentum component in the η-direction, $\,v(\xi ,\eta ,s,t)$.

dimension = v(LBi:UBi,LBj:UBj,N(ng),2)

pointer = OCEAN(ng)%v

tangent = tl_u

adjoint = ad_u

units = meter second^-1

grid = v-points

option = SOLVE3D

routine = step3d_uv.F

vbar

Vertically-integrated momentum component in the η-direction, ${\bar {v}}(\xi ,\eta ,t)$.

${\bar {v}}={\frac {1}{D}}\int _{-h}^{\zeta }v\,H_{z}\,dz$

dimension = vbar(LBi:UBi,LBj:UBj,3)

pointer = OCEAN(ng)%vbar

tangent = tl_vbar

adjoint = ad_vbar

units = meter second^-1

grid = v-points

routine = step2d.F

W

W

Terrain-following, vertical velocity component, $\,\Omega (\xi ,\eta ,s)\,Hz/mn$.

dimension = W(LBi:UBi,LBj:UBj,0:N(ng))

pointer = OCEAN(ng)%W

tangent = tl_W

adjoint = ad_W

units = meter³ second^-1

sign = positive downwards (downwelling), negative upwards (upwelling)

grid = w-points

option = SOLVE3D

routine = omega.F

wvel

True vertical velocity component, $\,w(\xi ,\eta ,s)$. It is computed only for output purposes.

dimension = wvel(LBi:UBi,LBj:UBj,0:N(ng))

pointer = OCEAN(ng)%wvel

units = meter second^-1

sign = positive downwards (downwelling), negative upwards (upwelling

grid = w-points

option = SOLVE3D

routine = wvelocity.F

Z

zeta

Free-surface, $\,\zeta (\xi ,\eta ,t)$.

dimension = zeta(LBi:UBi,LBj:UBj,3)

pointer = OCEAN(ng)%zeta

tangent = tl_zeta

adjoint = ad_zeta

units = meter

grid = ρ-points

routine = step2d.F

z_r

Actual depths of variables at ρ-points, $\,Z_{r}(\xi ,\eta ,s)$.

dimension = z_r(LBi:UBi,LBj:UBj,N(ng))

pointer = GRID(ng)%z_r

units = meter

sign = negative downwards

grid = ρ-points

option = SOLVE3D

routine = set_depths.F

z_w

Actual depths of variables at w-points, $\,Z_{w}(\xi ,\eta ,s)$.

dimension = z_w(LBi:UBi,LBj:UBj,0:N(ng))

pointer = GRID(ng)%z_w

units = meter

sign = negative downwards

grid = w-points

option = SOLVE3D

routine = set_depths.F