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

Module land_types_mod

Contact:  Christopher Milly
Reviewers:  Elena Shevliakova ,  Sergey Malyshev
Change History: WebCVS Log

OVERVIEW

Initializes land data types and allocates boundary data.

This module defines two derived types. atmos_land_boundary_type represents data passed from the atmosphere to the surface and the derivatives of the fluxes. Data describing the land is land_data_type. This module contains routines for initializing land type data and allocating and deallocating data for the specified domain and number of tiles.

OTHER MODULES USED

mpp_domains_mod
        fms_mod

PUBLIC INTERFACE

land_types_init:
Initializes the land types.
allocate_boundary_data:
Allocates the boundary data.
deallocate_boundary_data:
Deallocates the boundary data.

PUBLIC DATA

None.

PUBLIC ROUTINES

  1. land_types_init

    subroutine land_types_init()
    call land_types_init ()
    DESCRIPTION
    Initializes the land types module and writes the CVS version and tagname


  2. allocate_boundary_data

    subroutine allocate_boundary_data (a2l, bnd, domain, n_tiles)
  type(atmos_land_boundary_type), intent(inout) :: a2l
  type(land_data_type), intent(inout) :: bnd     ! data to allocate
  type(domain2d),       intent(in)  :: domain  ! domain to allocate for
  integer,              intent(in)  :: n_tiles ! number of tiles
    call allocate_boundary_data (bnd, domain, n_tiles)
    DESCRIPTION
    Allocates data for the specified domain and number of tiles.


  3. deallocate_boundary_data

    subroutine deallocate_boundary_data ( a2l, bnd )
  type(atmos_land_boundary_type), intent(inout) :: a2l
  type(land_data_type), intent(inout) :: bnd  ! data to deallocate
    call deallocate_boundary_data ( bnd )
    DESCRIPTION
    Deallocates the boundary data.



PUBLIC TYPES

atmos_land_boundary_type

Data passed from the atmosphere to the surface and derivatives of the fluxes. This data is provided by the flux_exchange.

t_flux
Sensible heat flux
[real, pointer, dimension3, units: W/m2]
q_flux
Water vapor flux
[real, pointer, dimension3, units: kg/m2/s]
lw_flux
Net longwave flux
[real, pointer, dimension3, units: W/m2]
sw_flux
Net shortwave flux
[real, pointer, dimension3, units: W/m2]
sw_flux_down_vis_dir
Downward visible band direct shortwave flux
[real, pointer, dimension3, units: W/m2]
sw_flux_down_total_dir
Total direct downward shortwave flux
[real, pointer , dimension3, units: W/m2]
sw_flux_down_vis_dif
Downward visible diffuse shortwave flux
[real, pointer, dimension3, units: W/m2]
sw_flux_down_total_diff
Total downward diffuse shortwave flux
[real, pointe r, dimension3, units: W/m2]
lprec
Liquid precipitation
[real, pointer, dimension3, units: kg/m2/s]
fprec
Solid precipitation (snowfall)
[real, pointer, dimension3, units: kg/m2/s]
dhdt
Derivative of sensible heat over land surface temperature
[real, pointer, dimension3, units: W/m2/K]
dedt
Derivative of evaporation over land surface temperature
[real, pointer, dimension3, units: kg/m2/s/K]
dedq
Derivative of evaporation over near-surface specific humidity
[real, pointer, dimension3, units: kg/m2/s]
drdt
Derivative of LW radiation over land surface temperature
[real, pointer, dimension3, units: W/m2/K]
drag_q
Product of drag coefficient for water vapor by wind
[real, pointer, dimension3, units: m/s]
p_surf
Surface pressure
[real, pointer, dimension3, units: N/m2]
data
Collective field for "named" fields above
[real, pointer, dimension3]
xtype
REGRID, REDIST or DIRECT
[integer]

land_data_type

Data describing the land.

domain
The computational domain
[domain2d, dimension2]
tile_size
Fractional coverage of cell by tile, dimensionless
[real, pointer, dimension3]
t_surf
Ground surface temperature
[real, pointer, dimension3, units: K]
t_ca
Canopy air temperature
[real, pointer, dimension3, units: K]
q_ca
Canopy air specific humidity
[real, pointer, dimension3, units: kg/kg]
albedo
Snow-adjusted land albedo
[real, pointer, dimension3]
albedo_vis_dir
Snow-adjusted land albedo for direct visible
[real, pointer, dimension3]
albedo_nir_dir
Snow-adjusted land albedo for direct nir
[real, pointer, dimension3]
albedo_vis_dif
Snow-adjusted land albedo for diffuse visible
[real, pointer, dimension3]
albedo_nir_dif
Snow-adjusted land albedo for diffuse nir
[real, pointer, dimension3]
rough_mom
Momentum roughness length
[real, pointer, dimension3, units: m]
rough_heat
Roughness length for tracers (heat and water)
[real, pointer, dimension3, units: m]
rough_scale
Roughness length for topographic momentum drag coefficient scaling
[real, pointer, dimension3, units: m]
discharge
Outflow of fresh water from river mouths into the ocean (per unit area of the ocean part of the grid cell)
[real, pointer, dimension2, units: kg/m2/s]
discharge_snow
Snow analogue of discharge
[real, pointer, dimension2, units: kg/m2/s]
mask
Land mask; true if land
[logical, pointer, dimension3]
axes(2)
Axes IDs for diagnostics
[integer, dimension2]

DATA SETS

None.

ERROR MESSAGES

None.

top