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

Module ocean_tracer_mod

Contact:  Stephen Griffies Matt Harrison Richard D. Slater (initialization) Ron Pacanowski
Reviewers: 
Change History: WebCVS Log


OVERVIEW

This module time steps the tracer fields.

This module time steps the tracer fields. Initialization for the tracer packages is done as well.


OTHER MODULES USED

            constants_mod
diag_manager_mod
field_manager_mod
fms_mod
fms_io_mod
mpp_domains_mod
mpp_io_mod
mpp_mod
platform_mod
time_manager_mod
ocean_convect_mod
ocean_domains_mod
ocean_horz_diffuse_mod
ocean_neutral_physics_mod
ocean_obc_mod
ocean_tpm_mod
ocean_tpm_util_mod
ocean_tracer_advect_mod
ocean_tracer_util_mod
ocean_types_mod
ocean_util_mod
ocean_vert_mix_mod
ocean_workspace_mod

PUBLIC INTERFACE

ocean_prog_tracer_init:
ocean_diag_tracer_init:
update_ocean_tracer:
update_advection_only:
ocean_tracer_end:
compute_tmask_limit:


PUBLIC DATA

None.


PUBLIC ROUTINES

  1. ocean_prog_tracer_init

    DESCRIPTION
    Initialization code for prognostic tracers, returning a pointer to the T_prog array.


  2. ocean_diag_tracer_init

    DESCRIPTION
    Initialization code for diagnostic tracers, returning a pointer to the T_diag array


  3. update_ocean_tracer

    DESCRIPTION
    Update value of tracer concentration to time taup1.


  4. update_advection_only

    DESCRIPTION
    Redo tracers that are evolved using only advection--nothing else. Useful for testing advection schemes in Boussinesq simulations.

    T_prog(n)%use_only_advection==.true. ignores all boundary forcing and sources, so if T_prog(n)%stf or pme, rivers, sources are nonzero, tracer diagnostics will spuriously indicate non-conservation.

    Assume for these tests that (1) vertical advection is done fully explictly (2) pme, rivers, stf, btf, and other sources are zero



  5. ocean_tracer_end

    DESCRIPTION
    Write ocean tracer restarts


  6. compute_tmask_limit

    DESCRIPTION
    Provide for possibility that quicker advection and/or neutral physics reverts to first order upwind when tracer is outside a specified range. For this purpose, we define a mask which is set to unity where fluxes revert to first order upwind advection (if using quicker) and horizontal diffusion (if using neutral).

    This method is very ad hoc. What is preferred for advection is to use a monotonic scheme, such as mdfl_sweby. For neutral physics, no analogous monotonic scheme has been implemented in mom4. Such could be useful, especially for passive tracers. In the meantime, tmask_limit provides a very rough limiter for neutral physics to help keep tracers within specified bounds.




NAMELIST

&ocean_tracer_nml

zero_tendency
If true, then will freeze the tracer fields.
[logical]
convective_adjust_on
To use the Rahmstorf full convection scheme.
[logical]
use_frazil
If true, then will compute ocean heating in the top model grid cell due to the production of frazil ice.
[logical]
t_min
Minimum potential temperature below which we gracefully bring down the model.
[real, units: deg C]
t_max
Maximum potential temperature above which we gracefully bring down the model.
[real, units: deg C]
s_min
Minimum salinity below which we gracefully bring down the model.
[real, units: psu]
s_max
Maximum salinity below which we gracefully bring down the model.
[real, units: psu]
t_min_limit
Minimum potential temperature below which will employ upwind advection instead of quicker, and horizontal diffusion instead of neutral physics.
[real, units: deg C]
t_max_limit
Maximum potential temperature above which will employ upwind advection instead of quicker, and horizontal diffusion instead of neutral physics.
[real, units: deg C]
s_min_limit
Minimum salinity below which will employ upwind advection instead of quicker, and horizontal diffusion instead of neutral physics.
[real, units: psu]
s_max_limit
Maximum salinity below which will employ upwind advection instead of quicker, and horizontal diffusion instead of neutral physics.
[real, units: psu]
debug_tracer
For debugging the tracer module
[logical]
ocean_tpm_debug
For debugging ocean tracer package manager.
[logical]


DATA SETS

None.


ERROR MESSAGES

None.


REFERENCES

  1. R.C. Pacanowski and S.M. Griffies The MOM3 Manual (1999)
  2. S.M. Griffies, M.J. Harrison, R.C. Pacanowski, and A. Rosati A Technical Guide to MOM4 (2004)
  3. S.M. Griffies, Fundamentals of ocean climate models (2004)


COMPILER SPECIFICS

None.


PRECOMPILER OPTIONS

None.


LOADER OPTIONS

None.


TEST PROGRAM

None.


KNOWN BUGS

None.


NOTES

None.


FUTURE PLANS

None.


top