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

Module cloudrad_diagnostics_mod

Contact:  fil
Reviewers:  ds
Change History: WebCVS Log


OVERVIEW

cloudrad_diagnostics_mod generates any desired netcdf output fields involving the cloud fields seen by the radiation package or the cloud radiation interaction variables.



OTHER MODULES USED

             fms_mod
time_manager_mod
diag_manager_mod
rad_utilities_mod
esfsw_parameters_mod
microphys_rad_mod
isccp_clouds_mod
constants_mod

PUBLIC INTERFACE

cloudrad_diagnostics_init:
cloudrad_diagnostics_init is the constructor for cloudrad_diagnostics_mod.
cloudrad_netcdf:
cloudrad_netcdf generates and outputs netcdf fields describing the cloud radiative properties, along with isccp cloud diagnostics fields.
cloudrad_diagnostics_end:
cloudrad_diagnostics_end is the destructor for cloudrad_diagnostics_mod.
diag_field_init:
diag_field_init registers the potential netcdf output variables with diag_manager_mod.
isccp_diag:
subroutine isccp_diag maps the model cloud distribution to the isccp cloud categories, and provides netcdf output if desired.
isccp_diag_stochastic:
subroutine isccp_diag maps the model cloud distribution to the isccp cloud categories, and provides netcdf output if desired.
compute_isccp_clds:
subroutine compute_isccp_clds maps the model clouds into isccp categories (high, middle, low) and defines the cloud fraction of each.
cloud_optical_properties_diag:
cloud_optical_properties_diag calculates the cloud optical depth, ice cloud optical depth and longwave cloud emissivity for each cloudy grid box.


PUBLIC DATA

None.


PUBLIC ROUTINES

  1. cloudrad_diagnostics_init

    call cloudrad_diagnostics_init (axes, Time)
    DESCRIPTION
    cloudrad_diagnostics_init is the constructor for cloudrad_diagnostics_mod.


    INPUT
    axes    diagnostic variable axes for netcdf files
       [real]
    Time    current time [ time_type(days, seconds) ]
       [time_type]

  2. cloudrad_netcdf

    call cloudrad_netcdf (is, js, Time_diag, Atmos_input, cosz, & Lsc_microphys, Meso_microphys, & Cell_microphys, Lscrad_props, & Mesorad_props, Cellrad_props, Cldrad_props,& Cld_spec, mask)
    DESCRIPTION
    cloudrad_netcdf generates and outputs netcdf fields describing the cloud radiative properties, along with isccp cloud diagnostics fields.


    INPUT
    is,js    starting subdomain i,j indices of data in the physics_window being integrated
       [integer]
    Time_diag    time on next timestep, used as stamp for diagnostic output [ time_type (days, seconds) ]
       [time_type]
    Atmos_input    atmospheric input fields on model grid,
       [atmos_input_type]
    cosz    cosine of solar zenith angle
       [real]
    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]
    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]
    mask    OPTIONAL: present when running eta vertical coordinate, mask to remove points below ground
       [real]

  3. cloudrad_diagnostics_end

    call cloudrad_diagnostics_end 
    
    DESCRIPTION
    cloudrad_diagnostics_end is the destructor for cloudrad_diagnostics_mod.


  4. diag_field_init

    call diag_field_init (axes, Time)
    DESCRIPTION
    diag_field_init registers the potential netcdf output variables with diag_manager_mod.


    INPUT
    axes    diagnostic variable axes for netcdf files
       [real]
    Time    current time [ time_type(days, seconds) ]
       [time_type]

  5. isccp_diag

    call isccp_diag (is, js, Cld_spec, Atmos_input, coszen, Time)
    DESCRIPTION
    subroutine isccp_diag maps the model cloud distribution to the isccp cloud categories, and provides netcdf output if desired.


    INPUT
    is,js    starting subdomain i,j indices of data in the physics_window being integrated
       [integer]
    Time    time on next timestep, used as stamp for diagnostic output [ time_type (days, seconds) ]
       [time_type]
    Atmos_input    atmospheric input fields on model grid,
       [atmos_input_type]
    coszen    cosine of solar zenith angle
       [real]
    Cld_spec    cloud specification properties on model grid,
       [cld_specification_type]
    Lsctau    cloud optical thickness in the visible
       [real]
    Lsclwem    10 micron cloud emissivity
       [real]

  6. isccp_diag_stochastic

    call isccp_diag_stochastic 
    
    DESCRIPTION
    subroutine isccp_diag maps the model cloud distribution to the isccp cloud categories, and provides netcdf output if desired.


    INPUT
    is,js    starting subdomain i,j indices of data in the physics_window being integrated
       [integer]
    Time    time on next timestep, used as stamp for diagnostic output [ time_type (days, seconds) ]
       [time_type]
    Atmos_input    atmospheric input fields on model grid,
       [atmos_input_type]
    coszen    cosine of solar zenith angle
       [real]
    Lsctau    cloud optical thickness in the visible
       [real]
    Lsclwem    10 micron cloud emissivity
       [real]

  7. compute_isccp_clds

    call compute_isccp_clds (pflux, camtsw, hml_ca)
    DESCRIPTION
    subroutine compute_isccp_clds maps the model clouds into isccp categories (high, middle, low) and defines the cloud fraction of each.


    INPUT
    pflux    average of pressure at adjacent model levels
       [real]
    camtsw    total cloud amount [ nondimensional ]
       [real]

    OUTPUT
    hml_ca    cloud fraction for the 3 isccp cloud types
       [real]

  8. cloud_optical_properties_diag

    call cloud_optical_properties_diag (Cld_spec, tau, em_lw)
    DESCRIPTION
    cloud_optical_properties_diag calculates the cloud optical depth, ice cloud optical depth and longwave cloud emissivity for each cloudy grid box.


    INPUT
    Cld_spec    cloud specification properties on model grid
       [cld_specification_type]

    OUTPUT
    tau    cloud optical depth in each of the num_slingo_bands
       [real]
    em_lw    longwave cloud emissivity
       [real]


DATA SETS

None.


ERROR MESSAGES

None.


top