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

Module cloud_spec_mod

Contact:  fil
Reviewers:  ds
Change History: WebCVS Log


OVERVIEW

cloud_spec_mod defines the variables that are used in a partic- ular cloud parameterization to specify the cloud location, cloud type and cloud magnitude for the active cloud parameterization(s).

if microphysically-based radiative properties are desired, then cloud_spec_mod also provides the microphysical parameters used in determining the radiative properties, either from the cloud scheme itself if they are present, or from a prescribed formula based on prescribed water paths for high, middle and low clouds.


OTHER MODULES USED

        time_manager_mod
fms_mod
tracer_manager_mod
field_manager_mod
data_override_mod
rad_utilities_mod
esfsw_parameters_mod
strat_clouds_W_mod
diag_clouds_W_mod
zetac_clouds_W_mod
specified_clouds_W_mod
rh_based_clouds_mod
donner_deep_clouds_W_mod
mgrp_prscr_clds_mod
standalone_clouds_mod

PUBLIC INTERFACE

cloud_spec_init:
Contructor of cloud_spec_package module
cloud_spec:
cloud_radiative_properties defines the cloud radiative properties appropriate for the radiation options that are active.
cloud_spec_dealloc:
cloud_spec_dealloc deallocates the component arrays of the cld_specification_type structure Cld_spec and the microphysics_type structures Lsc_microphys, Meso_microphys and Cell_microphys.
initialize_cldamts:
initialize_cldamts allocates and initializes the array components of the structures used to specify the model cloud and microphysics fields.
combine_cloud_properties:
combine_cloud_properties produces cloud specification property arrays for the total cloud field in each grid box, using as input the specification of the component cloud types that may be present (large-scale, mesoscale and cell-scale).
microphs_presc_conc:
Subroutine to determine water droplet and ice crystal based on prescribed microphysics model.


PUBLIC DATA

None.


PUBLIC ROUTINES

  1. cloud_spec_init

    call cloud_spec_init ( pref, lonb, latb, axes, Time)
    DESCRIPTION
    Contructor of cloud_spec_package module


    INPUT
    pref    reference pressure levels containing two reference pressure profiles for use in defining transmission functions [ Pa ]
       [real]
    lonb    the longitude array of the model grid point
       [real]
    latb    the latitude array of the model grid point
       [real]
    axes    diagnostic variable axes for netcdf files
       [real]
    Time    current time [ time_type(days, seconds) ]
       [time_type]

  2. cloud_spec

    call cloud_spec (is, ie, js, je, lat, z_half, z_full, Rad_time, Atmos_input, & Surface, Cld_spec, Lsc_microphys, & Meso_microphys, Cell_microphys, cloud_water_in, & cloud_ice_in, cloud_area_in, r, kbot, mask)
    DESCRIPTION
    cloud_radiative_properties defines the cloud radiative properties appropriate for the radiation options that are active.


    INPUT
    is,ie,js,je    starting/ending subdomain i,j indices of data in the physics_window being integrated
       [integer]
    Rad_time    time at which radiation calculation is to apply
       [time_type]
    cloud_water_in    OPTIONAL: cloud water mixing ratio present when running standalone columns or sa_gcm
       [real]
    cloud_ice_in    OPTIONAL: cloud ice mixing ratio present when running standalone columns or sa_gcm
       [real]
    cloud_area_in    OPTIONAL: fractional cloud area, present when running standalone columns or sa_gcm
       [real]
    r    OPTIONAL: model tracer fields on the current time step
       [real]
    kbot    OPTIONAL: present when running eta vertical coordinate, index of lowest model level above ground
       [integer]
    mask    OPTIONAL: present when running eta vertical coordinate, mask to remove points below ground
       [real]

    INPUT/OUTPUT
    Atmos_input    atmospheric input fields on model grid,
       [atmos_input_type]
    Cld_spec    cloud specification properties on model grid,
       [cld_specification_type]
    Lsc_microphys    microphysical specification for large-scale clouds
       [microphysics_type]
    Meso_microphys    microphysical specification for meso-scale clouds assciated with donner convection
       [microphysics_type]
    Cell_microphys    microphysical specification for convective cell clouds associated with donner convection
       [microphysics_type]
    Surface    Surface boundary condition to radiation package
       [Surface]

  3. cloud_spec_dealloc

    call cloud_spec_dealloc (Cld_spec, Lsc_microphys, Meso_microphys,& Cell_microphys)
    DESCRIPTION
    cloud_spec_dealloc deallocates the component arrays of the cld_specification_type structure Cld_spec and the microphysics_type structures Lsc_microphys, Meso_microphys and Cell_microphys.


    INPUT/OUTPUT
    Cld_spec    cloud specification properties on model grid,
       [cld_specification_type]
    Lsc_microphys    microphysical specification for large-scale clouds
       [microphysics_type]
    Meso_microphys    microphysical specification for meso-scale clouds assciated with donner convection
       [microphysics_type]
    Cell_microphys    microphysical specification for convective cell clouds associated with donner convection
       [microphysics_type]

  4. initialize_cldamts

    call initialize_cldamts (ix, jx, kx, Lsc_microphys, & Meso_microphys, Cell_microphys, Cld_spec)
    DESCRIPTION
    initialize_cldamts allocates and initializes the array components of the structures used to specify the model cloud and microphysics fields.


    INPUT
    ix, jx, kx    ix size of i dimension of physics window jx size of j dimension of physics window kx size of k dimension of physics window
       [integer]

    INPUT/OUTPUT
    Cld_spec    cloud specification properties on model grid,
       [cld_specification_type]
    Lsc_microphys    microphysical specification for large-scale clouds
       [microphysics_type]
    Meso_microphys    microphysical specification for meso-scale clouds assciated with donner convection
       [microphysics_type]
    Cell_microphys    microphysical specification for convective cell clouds associated with donner convection
       [microphysics_type]

  5. combine_cloud_properties

    call combine_cloud_properties (Lsc_microphys, Meso_microphys, & Cell_microphys, Cld_spec)
    DESCRIPTION
    combine_cloud_properties produces cloud specification property arrays for the total cloud field in each grid box, using as input the specification of the component cloud types that may be present (large-scale, mesoscale and cell-scale).


    INPUT
    Lsc_microphys    microphysical specification for large-scale clouds
       [microphysics_type]
    Meso_microphys    microphysical specification for meso-scale clouds assciated with donner convection
       [microphysics_type]
    Cell_microphys    microphysical specification for convective cell clouds associated with donner convection
       [microphysics_type]

    INPUT/OUTPUT
    Cld_spec    cloud specification properties on model grid,
       [cld_specification_type]

  6. microphs_presc_conc

    call microphs_presc_conc 
    
    DESCRIPTION
    This subroutine uses prescribed microphysics model to determine concentrations of water droplets and ice crystals.


    INPUT
    is    starting indice of the x dimension in the physics domain
       [integer]
    ie    ending indice of the x dimension in the physics domain
       [integer]
    js    starting indice of the y dimension in the physics domain
       [integer]
    je    ending indice of the y dimension in the physics domain
       [integer]
    deltaz    Height of each pressure layers.
       [real]
    temp    Temperatures of pressure levels
       [real]
    Cld_spec    cloud specification properties on model grid,
       [cld_specification_type]

    INPUT/OUTPUT
    Lsc_microphys    microphysical specification for large-scale clouds
       [microphysics_type]


DATA SETS

None.


ERROR MESSAGES

None.


top