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

Module atmos_convection_tracer_mod

Contact:  Richard Hemler
Reviewers: 
Change History: WebCVS Log


OVERVIEW

This code allows the incorporation of an arbitrarily-specified tracer for testing within the donner_deep module.

This module is to serve as a testbed for assessing convective transport of tracers.

This module presents an implementation of an arbirary tracer, including its convective transport by the donner_deep module.


OTHER MODULES USED

                   fms_mod
time_manager_mod
diag_manager_mod
tracer_manager_mod
field_manager_mod
atmos_tracer_utilities_mod

PUBLIC INTERFACE

atmos_cnvct_tracer_sourcesink:
The routine that calculate the sources and sinks of the convection tracer.
atmos_convection_tracer_init:
The constructor routine for the convection tracer module.
atmos_convection_tracer_end:
The destructor routine for the convection tracer module.


PUBLIC DATA

None.


PUBLIC ROUTINES

  1. atmos_cnvct_tracer_sourcesink

    call atmos_cnvct_tracer_sourcesink (lon, lat, land, pwt, convtr, convtr_dt, Time, is, ie, js, je, kbot)
    DESCRIPTION
    This is an implementation of an arbitrarily-specified tracer. At this time it is assumed to have no source or sink.



    INPUT
    lon    Longitude of the centre of the model gridcells
       [real, dimension(:,:)]
    lat    Latitude of the centre of the model gridcells
       [real, dimension(:,:)]
    land    Land/sea mask.
       [real, dimension(:,:)]
    pwt    The pressure weighting array. = dP/grav
       [real, dimension(:,:,:)]
    convtr    The array of the convection tracer mixing ratio.
       [real, dimension(:,:,:)]
    Time    Model time.
       [type(time_type)]
    is, ie, js, je    Local domain boundaries.
       [integer]
    kbot    Integer array describing which model layer intercepts the surface.
       [integer, optional, dimension(:,:)]

    OUTPUT
    convtr_dt    The array of the tendency of the convection tracer mixing ratio.
       [real, dimension(:,:,:)]

  2. atmos_convection_tracer_init

    call atmos_convection_tracer_init 
    
    DESCRIPTION
    A routine to initialize the convection tracer module.


    INPUT
    phalf    pressure at model interface levels
       [real, dimension(:,:,:)]
    mask    optional mask (0. or 1.) that designates which grid points are above (=1.) or below (=0.) the ground dimensioned as (nlon,nlat,nlev).
       [real, optional, dimension(:,:,:)]
    Time    Model time.
       [type(time_type)]
    axes    The axes relating to the tracer array dimensioned as (nlon, nlat, nlev, ntime)
       [integer, dimension(4)]

    INPUT/OUTPUT
    r    Tracer fields dimensioned as (nlon,nlat,nlev,ntrace).
       [real, dimension(:,:,:,:)]

  3. atmos_convection_tracer_end

    call atmos_convection_tracer_end 
    
    DESCRIPTION
    This subroutine marks the module as uninitialized and exits.



DATA SETS

None.


ERROR MESSAGES

None.


top