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

Module cloudrad_package_mod

Contact:  fil
Reviewers:  ds
Change History: WebCVS Log


OVERVIEW

Module that supplies cloud radiative properties



OTHER MODULES USED

                 fms_mod
time_manager_mod
rad_utilities_mod
esfsw_parameters_mod
cloudrad_diagnostics_mod
bulkphys_rad_mod
microphys_rad_mod

PUBLIC INTERFACE

cloudrad_package_init:
Contructor of cloudrad_package module
cloud_radiative_properties:
Subroutine to calculate cloud radiative properties appropriate for the radiation options that are active.
cldrad_properties_dealloc:
Subroutine to deallocate the array elements of the cldrad_properties_type variable that is input.
cloudrad_package_end:
Destructor of the cloudrad_package module
initialize_cldrad_props:
initialize_cldrad_props allocates and initializes those fields which define the cloud radiative properties needed by the radiation package.
combine_cloud_properties:
combine_cloud_properties produces cloud-radiative properties fields for the total-cloud field in each grid box.
cloudrad_package_dealloc:
Subroutine to deallocate the space cloud radiative properties use in the model


PUBLIC DATA

None.


PUBLIC ROUTINES

  1. cloudrad_package_init

    call cloudrad_package_init ( pref, lonb, latb, axes, Time)
    DESCRIPTION
    Contructor of cloudrad_package module


    INPUT
    pref    reference pressure levels
       [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_radiative_properties

    call cloud_radiative_properties (is, ie, js, je, Time_next, & Astro, Atmos_input, Cld_spec, & Lsc_microphys, Meso_microphys, & Cell_microphys, Cldrad_props, & kbot, mask)
    DESCRIPTION
    Subroutine to calculate 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]
    Time_next    time on next timestep, used as stamp for diagnostic output [ time_type (days, seconds) ]
       [time_type]
    Astro    astronomical properties needed by radiation package
       [astronomy_type]
    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]
    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
    Cldrad_props    cloud radiative properties on model grid
       [cldrad_properties_type]

  3. cldrad_properties_dealloc

    call cldrad_properties_dealloc 
    
    DESCRIPTION
    Subroutine to deallocate the array elements of the cldrad_properties_type variable that is input.


    INPUT/OUTPUT
    Cldrad_props    cldrad_properties_type variable containing cloud radiative properties
       [cldrad_properties_type]

  4. cloudrad_package_end

    call cloudrad_package_end 
    
    DESCRIPTION
    Destructor of the cloudrad_package module


  5. initialize_cldrad_props

    call initialize_cldrad_props (ix, jx, kx, Lscrad_props, & Mesorad_props, Cellrad_props, & Cldrad_props )
    DESCRIPTION
    initialize_cldrad_props allocates and initializes those fields which define the cloud radiative properties needed by the radiation package.


    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
    Lscrad_props    cloud radiative properties for the large-scale clouds
       [microrad_properties_type]
    Mesorad_props    cloud radiative properties for the meso-scale clouds assciated with donner convection
       [microrad_properties_type]
    Cellrad_props    cloud radiative properties for the convective cell clouds associated with donner convection
       [microrad_properties_type]
    Cldrad_props    cloud radiative properties on model grid
       [cldrad_properties_type]

  6. combine_cloud_properties

    call combine_cloud_properties (deltaz, & Lsc_microphys, Meso_microphys, & Cell_microphys, Lscrad_props, & Mesorad_props, Cellrad_props, & Cldrad_props)
    DESCRIPTION
    combine_cloud_properties produces cloud-radiative properties fields for the total-cloud field in each grid box, using as input the properties and characteristics of the various cloud types that may be present (large-scale, mesoscale and cell-scale).


    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]
    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]
    Lscrad_props    cloud radiative properties for the large-scale clouds
       [microrad_properties_type]
    Mesorad_props    cloud radiative properties for the meso-scale clouds
       [microrad_properties_type]
    Cellrad_props    cloud radiative properties for the convective cell clouds associated with donner convection
       [microrad_properties_type]

    INPUT/OUTPUT
    Cldrad_props    cloud radiative properties on model grid
       [cldrad_properties_type]

  7. cloudrad_package_dealloc

    call cloudrad_package_dealloc (Lscrad_props, Mesorad_props, Cldrad_props)
    DESCRIPTION
    Subroutine to deallocate the space cloud radiative properties use in the model


    INPUT
    Lscrad_props    cloud radiative properties for the large-scale clouds
       [microrad_properties_type]
    Mesorad_props    cloud radiative properties for the meso-scale clouds
       [microrad_properties_type]
    Cldrad_props    cldrad_prperties_type variable containing the cloud radiative property output fields needed by the radiation package
       [cldrad_prperties_type]


DATA SETS

None.


ERROR MESSAGES

None.


top