Model variables

The variable meta-data (i.e., all instances of veros.variables.Variable) are available in a dictionary as the attribute Veros.variables. The actual data arrays are added directly as attributes to Veros. The following code snippet (as commonly used in the Diagnostics) illustrates this behavior:

var_meta = {key: val for key, val in vs.variables.items() if val.time_dependent and val.output}
var_data = {key: getattr(veros, key) for key in var_meta.keys()}

In this case, var_meta is a dictionary containing all metadata for variables that are time dependent and should be added to the output, while var_data is a dictionary with the same keys containing the corresponding data arrays.

Variable class

class veros.variables.Variable(name, dims, units='', long_description='', dtype=None, time_dependent=True, scale=1.0, write_to_restart=False, extra_attributes=None, mask=None, active=True, initial=None)[source]

Bases: object

Available variables

There are two kinds of variables in Veros. Main variables are always present in a simulation, while conditional variables are only available if their respective condition is True at the time of variable allocation.

Attributes:
: Time-dependent
: Conditional
: Written to restart files by default
VerosVariables.tau
Units

Dimensions

scalar

Type

int32

Attributes

Index of current time step

VerosVariables.taup1
Units

Dimensions

scalar

Type

int32

Attributes

Index of next time step

VerosVariables.taum1
Units

Dimensions

scalar

Type

int32

Attributes

Index of last time step

VerosVariables.time
Units

Dimensions

scalar

Type

float

Attributes

Current time

VerosVariables.itt
Units

Dimensions

scalar

Type

int32

Attributes

Current iteration

VerosVariables.dxt
Units

m

Dimensions

xt

Type

float

Attributes

Zonal (x) spacing of T-grid point

VerosVariables.dxu
Units

m

Dimensions

xu

Type

float

Attributes

Zonal (x) spacing of U-grid point

VerosVariables.dyt
Units

m

Dimensions

yt

Type

float

Attributes

Meridional (y) spacing of T-grid point

VerosVariables.dyu
Units

m

Dimensions

yu

Type

float

Attributes

Meridional (y) spacing of U-grid point

VerosVariables.zt
Units

m

Dimensions

zt

Type

float

Attributes

Vertical coordinate

VerosVariables.zw
Units

m

Dimensions

zw

Type

float

Attributes

Vertical coordinate

VerosVariables.dzt
Units

m

Dimensions

zt

Type

float

Attributes

Vertical spacing

VerosVariables.dzw
Units

m

Dimensions

zw

Type

float

Attributes

Vertical spacing

VerosVariables.cost
Units

1

Dimensions

yt

Type

float

Attributes

Metric factor for spherical coordinates

VerosVariables.cosu
Units

1

Dimensions

yu

Type

float

Attributes

Metric factor for spherical coordinates

VerosVariables.tantr
Units

1

Dimensions

yt

Type

float

Attributes

Metric factor for spherical coordinates

VerosVariables.coriolis_t
Units

1/s

Dimensions

xt, yt

Type

float

Attributes

Coriolis frequency at T grid point

VerosVariables.kbot
Units

Dimensions

xt, yt

Type

int32

Attributes

Index of the deepest grid cell (counting from 1, 0 means all land)

VerosVariables.ht
Units

m

Dimensions

xt, yt

Type

float

Attributes

Total depth of the water column

VerosVariables.hu
Units

m

Dimensions

xu, yt

Type

float

Attributes

Total depth of the water column

VerosVariables.hv
Units

m

Dimensions

xt, yu

Type

float

Attributes

Total depth of the water column

VerosVariables.hur
Units

m

Dimensions

xu, yt

Type

float

Attributes

Total depth of the water column (masked)

VerosVariables.hvr
Units

m

Dimensions

xt, yu

Type

float

Attributes

Total depth of the water column (masked)

VerosVariables.beta
Units

1/(ms)

Dimensions

xt, yt

Type

float

Attributes

Change of Coriolis frequency with latitude

VerosVariables.area_t
Units

m^2

Dimensions

xt, yt

Type

float

Attributes

Area of T-box

VerosVariables.area_u
Units

m^2

Dimensions

xu, yt

Type

float

Attributes

Area of U-box

VerosVariables.area_v
Units

m^2

Dimensions

xt, yu

Type

float

Attributes

Area of V-box

VerosVariables.maskT
Units

Dimensions

xt, yt, zt

Type

bool

Attributes

Mask in physical space for tracer points

VerosVariables.maskU
Units

Dimensions

xu, yt, zt

Type

bool

Attributes

Mask in physical space for U points

VerosVariables.maskV
Units

Dimensions

xt, yu, zt

Type

bool

Attributes

Mask in physical space for V points

VerosVariables.maskW
Units

Dimensions

xt, yt, zw

Type

bool

Attributes

Mask in physical space for W points

VerosVariables.maskZ
Units

Dimensions

xu, yu, zt

Type

bool

Attributes

Mask in physical space for Zeta points

VerosVariables.rho
Units

kg/m^3

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

In-situ density anomaly, relative to the surface mean value of 1024 kg/m^3

VerosVariables.prho
Units

kg/m^3

Dimensions

xt, yt, zt

Type

float

Attributes

Potential density anomaly, relative to the surface mean value of 1024 kg/m^3 (identical to in-situ density anomaly for equation of state type 1, 2, and 4)

VerosVariables.int_drhodT
Units

kg / (m^2 deg C)

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Partial derivative of dynamic enthalpy by temperature

VerosVariables.int_drhodS
Units

kg / (m^2 g / kg)

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Partial derivative of dynamic enthalpy by salinity

VerosVariables.Nsqr
Units

1/s^2

Dimensions

xt, yt, zw, timesteps

Type

float

Attributes

Square of stability frequency

VerosVariables.Hd
Units

m^2/s^2

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Dynamic enthalpy

VerosVariables.dHd
Units

m^2/s^3

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Change of dynamic enthalpy due to advection

VerosVariables.temp
Units

deg C

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Conservative temperature

VerosVariables.dtemp
Units

deg C/s

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Conservative temperature tendency

VerosVariables.salt
Units

g/kg

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Salinity

VerosVariables.dsalt
Units

g/(kg s)

Dimensions

xt, yt, zt, timesteps

Type

float

Attributes

Salinity tendency

VerosVariables.dtemp_vmix
Units

deg C/s

Dimensions

xt, yt, zt

Type

float

Attributes

Change of temperature due to vertical mixing

VerosVariables.dtemp_hmix
Units

deg C/s

Dimensions

xt, yt, zt

Type

float

Attributes

Change of temperature due to horizontal mixing

VerosVariables.dsalt_vmix
Units

deg C/s

Dimensions

xt, yt, zt

Type

float

Attributes

Change of salinity due to vertical mixing

VerosVariables.dsalt_hmix
Units

deg C/s

Dimensions

xt, yt, zt

Type

float

Attributes

Change of salinity due to horizontal mixing

VerosVariables.dtemp_iso
Units

deg C/s

Dimensions

xt, yt, zt

Type

float

Attributes

Change of temperature due to isopycnal mixing plus skew mixing

VerosVariables.dsalt_iso
Units

deg C/s

Dimensions

xt, yt, zt

Type

float

Attributes

Change of salinity due to isopycnal mixing plus skew mixing

VerosVariables.forc_temp_surface
Units

m deg C/s

Dimensions

xt, yt

Type

float

Attributes

Surface temperature flux

VerosVariables.forc_salt_surface
Units

m g/s kg

Dimensions

xt, yt

Type

float

Attributes

Surface salinity flux

VerosVariables.u
Units

m/s

Dimensions

xu, yt, zt, timesteps

Type

float

Attributes

Zonal velocity

VerosVariables.v
Units

m/s

Dimensions

xt, yu, zt, timesteps

Type

float

Attributes

Meridional velocity

VerosVariables.w
Units

m/s

Dimensions

xt, yt, zw, timesteps

Type

float

Attributes

Vertical velocity

VerosVariables.du
Units

m/s

Dimensions

xu, yt, zt, timesteps

Type

float

Attributes

Zonal velocity tendency

VerosVariables.dv
Units

m/s

Dimensions

xt, yu, zt, timesteps

Type

float

Attributes

Meridional velocity tendency

VerosVariables.du_cor
Units

m/s^2

Dimensions

xu, yt, zt

Type

float

Attributes

Change of u due to Coriolis force

VerosVariables.dv_cor
Units

m/s^2

Dimensions

xt, yu, zt

Type

float

Attributes

Change of v due to Coriolis force

VerosVariables.du_mix
Units

m/s^2

Dimensions

xu, yt, zt

Type

float

Attributes

Change of u due to implicit vertical mixing

VerosVariables.dv_mix
Units

m/s^2

Dimensions

xt, yu, zt

Type

float

Attributes

Change of v due to implicit vertical mixing

VerosVariables.du_adv
Units

m/s^2

Dimensions

xu, yt, zt

Type

float

Attributes

Change of u due to advection

VerosVariables.dv_adv
Units

m/s^2

Dimensions

xt, yu, zt

Type

float

Attributes

Change of v due to advection

VerosVariables.p_hydro
Units

m^2/s^2

Dimensions

xt, yt, zt

Type

float

Attributes

Hydrostatic pressure

VerosVariables.kappaM
Units

m^2/s

Dimensions

xt, yt, zt

Type

float

Attributes

Vertical viscosity

VerosVariables.kappaH
Units

m^2/s

Dimensions

xt, yt, zw

Type

float

Attributes

Vertical diffusivity

VerosVariables.surface_taux
Units

N/m^2

Dimensions

xu, yt

Type

float

Attributes

Zonal surface wind stress

VerosVariables.surface_tauy
Units

N/m^2

Dimensions

xt, yu

Type

float

Attributes

Meridional surface wind stress

VerosVariables.forc_rho_surface
Units

kg / (m^2 s)

Dimensions

xt, yt

Type

float

Attributes

Surface potential density flux

VerosVariables.psi
Units

m^3/s

Dimensions

xu, yu, timesteps

Type

float

Attributes

Barotropic streamfunction

VerosVariables.dpsi
Units

m^3/s^2

Dimensions

xu, yu, timesteps

Type

float

Attributes

Streamfunction tendency

VerosVariables.land_map
Units

Dimensions

xt, yt

Type

int32

Attributes

Land map

VerosVariables.isle
Units

Dimensions

isle

Type

float

Attributes

Island number

VerosVariables.psin
Units

m^3/s

Dimensions

xu, yu, isle

Type

float

Attributes

Boundary streamfunction

VerosVariables.dpsin
Units

m^3/s^2

Dimensions

isle, timesteps

Type

float

Attributes

Boundary streamfunction factor

VerosVariables.line_psin
Units

m^4/s^2

Dimensions

isle, isle

Type

float

Attributes

Boundary line integrals

VerosVariables.boundary_mask
Units

Dimensions

xt, yt, isle

Type

bool

Attributes

Boundary mask

VerosVariables.line_dir_south_mask
Units

Dimensions

xt, yt, isle

Type

bool

Attributes

Line integral mask

VerosVariables.line_dir_north_mask
Units

Dimensions

xt, yt, isle

Type

bool

Attributes

Line integral mask

VerosVariables.line_dir_east_mask
Units

Dimensions

xt, yt, isle

Type

bool

Attributes

Line integral mask

VerosVariables.line_dir_west_mask
Units

Dimensions

xt, yt, isle

Type

bool

Attributes

Line integral mask

VerosVariables.K_gm
Units

m^2/s

Dimensions

xt, yt, zw

Type

float

Attributes

GM diffusivity, either constant or from EKE model

VerosVariables.K_iso
Units

m^2/s

Dimensions

xt, yt, zw

Type

float

Attributes

Along-isopycnal diffusivity

VerosVariables.K_diss_v
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Kinetic energy dissipation by vertical, rayleigh and bottom friction

VerosVariables.K_diss_bot
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Mean energy dissipation by bottom and rayleigh friction

VerosVariables.K_diss_h
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Kinetic energy dissipation by horizontal friction

VerosVariables.K_diss_gm
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Mean energy dissipation by GM (TRM formalism only)

VerosVariables.P_diss_v
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Potential energy dissipation by vertical diffusion

VerosVariables.P_diss_nonlin
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Potential energy dissipation by nonlinear equation of state

VerosVariables.P_diss_iso
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Potential energy dissipation by isopycnal mixing

VerosVariables.P_diss_skew
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Potential energy dissipation by GM (w/o TRM)

VerosVariables.P_diss_hmix
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Potential energy dissipation by horizontal mixing

VerosVariables.P_diss_adv
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Potential energy dissipation by advection

VerosVariables.P_diss_sources
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Attributes

Potential energy dissipation by external sources (e.g. restoring zones)

VerosVariables.u_wgrid
Units

m/s

Dimensions

xt, yt, zw

Type

float

Attributes

Zonal velocity interpolated to W grid points

VerosVariables.v_wgrid
Units

m/s

Dimensions

xt, yt, zw

Type

float

Attributes

Meridional velocity interpolated to W grid points

VerosVariables.w_wgrid
Units

m/s

Dimensions

xt, yt, zw

Type

float

Attributes

Vertical velocity interpolated to W grid points

VerosVariables.xt
Units

<function <lambda> at 0x7f3438e16170>

Dimensions

xt

Type

float

Attributes

Zonal (x) coordinate of T-grid point

VerosVariables.xu
Units

<function <lambda> at 0x7f3438e16320>

Dimensions

xu

Type

float

Attributes

Zonal (x) coordinate of U-grid point

VerosVariables.yt
Units

<function <lambda> at 0x7f3438e164d0>

Dimensions

yt

Type

float

Attributes

Meridional (y) coordinate of T-grid point

VerosVariables.yu
Units

<function <lambda> at 0x7f3438e16680>

Dimensions

yu

Type

float

Attributes

Meridional (y) coordinate of U-grid point

VerosVariables.temp_source
Units

K/s

Dimensions

xt, yt, zt

Type

float

Condition

lambda settings: settings.enable_tempsalt_sources

Attributes

Non-conservative source of temperature

VerosVariables.salt_source
Units

g/(kg s)

Dimensions

xt, yt, zt

Type

float

Condition

lambda settings: settings.enable_tempsalt_sources

Attributes

Non-conservative source of salt

VerosVariables.u_source
Units

m/s^2

Dimensions

xu, yt, zt

Type

float

Condition

lambda settings: settings.enable_momentum_sources

Attributes

Non-conservative source of zonal velocity

VerosVariables.v_source
Units

m/s^2

Dimensions

xt, yu, zt

Type

float

Condition

lambda settings: settings.enable_momentum_sources

Attributes

Non-conservative source of meridional velocity

VerosVariables.K_11
Units

m^2/s

Dimensions

xt, yt, zt

Type

float

Condition

lambda settings: settings.enable_neutral_diffusion

Attributes

Isopycnal mixing tensor component

VerosVariables.K_22
Units

m^2/s

Dimensions

xt, yt, zt

Type

float

Condition

lambda settings: settings.enable_neutral_diffusion

Attributes

Isopycnal mixing tensor component

VerosVariables.K_33
Units

m^2/s

Dimensions

xt, yt, zt

Type

float

Condition

lambda settings: settings.enable_neutral_diffusion

Attributes

Isopycnal mixing tensor component

VerosVariables.Ai_ez
Units

Vertical isopycnal diffusion coefficient on eastern face of T cell

Dimensions

xt, yt, zt, tensor1, tensor2

Type

float

Condition

lambda settings: settings.enable_neutral_diffusion

Attributes

1

VerosVariables.Ai_nz
Units

Vertical isopycnal diffusion coefficient on northern face of T cell

Dimensions

xt, yt, zt, tensor1, tensor2

Type

float

Condition

lambda settings: settings.enable_neutral_diffusion

Attributes

1

VerosVariables.Ai_bx
Units

Zonal isopycnal diffusion coefficient on bottom face of T cell

Dimensions

xt, yt, zt, tensor1, tensor2

Type

float

Condition

lambda settings: settings.enable_neutral_diffusion

Attributes

1

VerosVariables.Ai_by
Units

Meridional isopycnal diffusion coefficient on bottom face of T cell

Dimensions

xt, yt, zt, tensor1, tensor2

Type

float

Condition

lambda settings: settings.enable_neutral_diffusion

Attributes

1

VerosVariables.B1_gm
Units

m^2/s

Dimensions

xt, yu, zt

Type

float

Condition

lambda settings: settings.enable_skew_diffusion

Attributes

Zonal component of GM streamfunction

VerosVariables.B2_gm
Units

m^2/s

Dimensions

xu, yt, zt

Type

float

Condition

lambda settings: settings.enable_skew_diffusion

Attributes

Meridional component of GM streamfunction

VerosVariables.r_bot_var_u
Units

1/s

Dimensions

xu, yt

Type

float

Condition

lambda settings: settings.enable_bottom_friction_var

Attributes

Zonal bottom friction coefficient

VerosVariables.r_bot_var_v
Units

1/s

Dimensions

xt, yu

Type

float

Condition

lambda settings: settings.enable_bottom_friction_var

Attributes

Meridional bottom friction coefficient

VerosVariables.kappa_gm
Units

m^2/s

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_TEM_friction

Attributes

Vertical diffusivity

VerosVariables.tke
Units

m^2/s^2

Dimensions

xt, yt, zw, timesteps

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

Turbulent kinetic energy

VerosVariables.sqrttke
Units

m/s

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

Square-root of TKE

VerosVariables.dtke
Units

m^2/s^3

Dimensions

xt, yt, zw, timesteps

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

Turbulent kinetic energy tendency

VerosVariables.Prandtlnumber
Units

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

Prandtl number

VerosVariables.mxl
Units

m

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

Mixing length

VerosVariables.forc_tke_surface
Units

m^3/s^3

Dimensions

xt, yt

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

TKE surface flux

VerosVariables.tke_diss
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

TKE dissipation

VerosVariables.tke_surf_corr
Units

m^3/s^3

Dimensions

xt, yt

Type

float

Condition

lambda settings: settings.enable_tke

Attributes

Correction of TKE surface flux

VerosVariables.eke
Units

m^2/s^2

Dimensions

xt, yt, zw, timesteps

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

meso-scale energy

VerosVariables.deke
Units

m^2/s^3

Dimensions

xt, yt, zw, timesteps

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

meso-scale energy tendency

VerosVariables.sqrteke
Units

m/s

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

square-root of eke

VerosVariables.L_rossby
Units

m

Dimensions

xt, yt

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

Rossby radius

VerosVariables.L_rhines
Units

m

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

Rhines scale

VerosVariables.eke_len
Units

m

Dimensions

xt, yt, zt

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

Eddy length scale

VerosVariables.eke_diss_iw
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

Dissipation of EKE to internal waves

VerosVariables.eke_diss_tke
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_eke

Attributes

Dissipation of EKE to TKE

VerosVariables.E_iw
Units

m^2/s^2

Dimensions

xt, yt, zw, timesteps

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

Internal wave energy

VerosVariables.dE_iw
Units

m^2/s^2

Dimensions

xt, yt, zw, timesteps

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

Internal wave energy tendency

VerosVariables.c0
Units

m/s

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

Vertical internal wave group velocity

VerosVariables.v0
Units

m/s

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

Horizontal internal wave group velocity

VerosVariables.alpha_c
Units

?

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

?

VerosVariables.iw_diss
Units

m^2/s^3

Dimensions

xt, yt, zw

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

Internal wave dissipation

VerosVariables.forc_iw_surface
Units

m^3/s^3

Dimensions

xt, yt

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

Internal wave surface forcing

VerosVariables.forc_iw_bottom
Units

m^3/s^3

Dimensions

xt, yt

Type

float

Condition

lambda settings: settings.enable_idemix

Attributes

Internal wave bottom forcing