PUBLIC INTERFACE ~ PUBLIC DATA ~ PUBLIC ROUTINES ~ NAMELIST ~ DIAGNOSTIC FIELDS ~ ERROR MESSAGES ~ REFERENCES ~ NOTES

Module ocean_velocity_mod

Contact:  R.C. Pacanowski A. Rosati
Reviewers:  M.J. Harrison S.M. Griffies
Change History: WebCVS Log


OVERVIEW

Time step velocity

This module steps the velocity field forward in time using a leap-frog time stepping scheme.


OTHER MODULES USED

            constants_mod
diag_manager_mod
fms_mod
fms_io_mod
mpp_domains_mod
mpp_mod
ocean_bih_friction_mod
ocean_coriolis_mod
ocean_domains_mod
ocean_lap_friction_mod
ocean_obc_mod
ocean_operators_mod
ocean_pressure_mod
ocean_types_mod
ocean_util_mod
ocean_velocity_advect_mod
ocean_velocity_diag_mod
ocean_vert_mix_mod
ocean_workspace_mod

PUBLIC INTERFACE

ocean_velocity_init:
check_gravity_wave_cfl:
ocean_explicit_accel_a:
ocean_explicit_accel_b:
update_ocean_velocity:
ocean_implicit_friction:
ocean_implicit_coriolis:
ocean_velocity_end:
energy_analysis:
ocean_velocity_chksum:


PUBLIC DATA

None.


PUBLIC ROUTINES

  1. ocean_velocity_init

    DESCRIPTION
    Initialize terms for the velocity equation.


  2. check_gravity_wave_cfl

    DESCRIPTION
    Check CFL for internal gravity waves.


  3. ocean_explicit_accel_a

    DESCRIPTION
    Time explicit contributions to thickness weighted acceleration. Omit here the Coriolis force and verrtical friction here.


  4. ocean_explicit_accel_b

    DESCRIPTION
    Add Coriolis force and explicit vertical friction to explicit-time thickness weighted acceleration.


  5. update_ocean_velocity

    DESCRIPTION
    Update velocity components


  6. ocean_implicit_friction

    DESCRIPTION
    Contributions to thickness weighted acceleration from implicit vertical friction.


  7. ocean_implicit_coriolis

    DESCRIPTION
    Contributions to acceleration from time-implicit Coriolis force.


  8. ocean_velocity_end

    DESCRIPTION
    Write the velocity field to a restart


  9. energy_analysis

    DESCRIPTION
    Perform energy analysis by taking scalar product of horizontal velocity with the velocity equations and integrating over the ocean volume.


  10. ocean_velocity_chksum

    DESCRIPTION
    Compute checksum for velocity components



NAMELIST

&ocean_velocity_nml

zero_tendency
For debugging. Will freeze the baroclinic velocity fields.
[logical]
zero_tendency_explicit
For debugging. Will not use explicit part of the tendency.
[logical]
zero_tendency_implicit
For debugging. Will not use implicit part of the tendency.
[logical]
truncate_velocity
Truncate the velocity to a maximum value. Useful for cases where the initial spin-up initiates spuriously large model velocities that would otherwise cause the model to blow-up.
[logical]
vel_max
Truncation velocity
[real, units: meter/sec]
max_cgint
Maximum internal gravity wave speed--used for diagnosing conservative estimate of stable time steps.
[real]
adams_bashforth_epsilon
Dimensionless parameter for 2nd order Adams-Bashforth implementation of velocity advection. Values between 0.5 and 1.0 are recommended. Value of 0.5 leads to second order accurate, but it is formally weakly unstable (Durran, Section 2.3.4).
[real, units: dimensionless]
adams_bashforth_third
For a third order treatment of the velocity advection. This is stable and so needs no temporal dissipation (Section 2.3.6 of Durran). This is the model default.
[logicall]
truncate_verbose
For verbose printout
[logical]


DATA SETS

None.


ERROR MESSAGES

None.


REFERENCES

  1. Durran, Numerical Methods for Wave Equations in Geophysical Fluid Dynamics (1999).
  2. R.C. Pacanowski and S.M. Griffies, The MOM3 Manual (1999). NOAA/Geophysical Fluid Dynamics Laboratory
  3. S.M. Griffies, M.J. Harrison, R.C. Pacanowski, and A. Rosati, A Technical Guide to MOM4 (2004). NOAA/Geophysical Fluid Dynamics Laboratory
  4. S.M. Griffies, Fundamentals of Ocean Climate Models (2004). Princeton University Press.
  5. S.M. Griffies, R.C. Pacanowski, R.M. Schmidt, and V. Balaji Tracer Conservation with an Explicit Free Surface Method for Z-coordinate Ocean Models Monthly Weather Review (2001) vol 129 pages 1081--1098


COMPILER SPECIFICS

None.


PRECOMPILER OPTIONS

None.


LOADER OPTIONS

None.


TEST PROGRAM

None.


KNOWN BUGS

None.


NOTES

None.


FUTURE PLANS

None.


top