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

Module standalone_clouds_mod

Contact:  fil
Reviewers: 
Change History: WebCVS Log


OVERVIEW



OTHER MODULES USED

        time_manager_mod
fms_mod
rad_utilities_mod
donner_deep_clouds_W_mod

PUBLIC INTERFACE

standalone_clouds_init:
subroutine standalone_clouds_init is the constructor for the standalone_clouds_mod.

define_column_properties:
subroutine define_column_properties defines values for lw emiss- ivity, visible and nir reflectivity and nir absorption to be used with standalone clouds.

standalone_clouds_end:
standalone_clouds_end is the destructor for standalone_clouds_mod.

standalone_clouds_amt:
standalone_clouds_amt defines the number, amount (cloud fraction), and type (hi, mid, low) of clouds present on the model grid.

obtain_micro_lw_sa:
obtain_micro_lw_sa defines microphysically-based longwave cloud radiative properties when the code is executed in standalone columns mode.

obtain_micro_sw_sa:
obtain_micro_sw_sa defines microphysically-based shortwave cloud radiative properties for the standalone cloud scheme when run in columns mode.

obtain_bulk_lw_sa:
obtain_bulk_lw_sa defines bulk longwave cloud radiative properties when using specified clouds in the standalone columns mode.

obtain_bulk_sw_sa:
obtain_bulk_sw_sa defines bulk shortwave cloud radiative properties for the specified cloud scheme when running in standalone columns mode.



PUBLIC DATA

None.


PUBLIC ROUTINES

  1. standalone_clouds_init

    call standalone_clouds_init (pref, lonb, latb)
    DESCRIPTION
    subroutine standalone_clouds_init is the constructor for the standalone_clouds_mod.



    INPUT
    pref    pref array containing two reference pressure profiles for use in defining transmission functions [ Pa ]


       [real]
    lonb    lonb array of model longitudes on cell boundaries [ radians ]


       [real]
    latb    latb array of model latitudes at cell boundaries [radians]


       [real]

  2. define_column_properties

    call define_column_properties (pref, lonb, latb)
    DESCRIPTION
    subroutine define_column_properties defines values for lw emiss- ivity, visible and nir reflectivity and nir absorption to be used with standalone clouds.



    INPUT
    pref    pref array containing two reference pressure profiles for use in defining transmission functions [ Pa ]


       [real]
    lonb    lonb array of model longitudes on cell boundaries [ radians ]


       [real]
    latb    latb array of model latitudes at cell boundaries [radians]


       [real]

  3. standalone_clouds_end

    call standalone_clouds_end 
    
    DESCRIPTION
    standalone_clouds_end is the destructor for standalone_clouds_mod.



  4. standalone_clouds_amt

    call standalone_clouds_amt (is, ie, js, je, lat, press_mks, & Cld_spec)
    DESCRIPTION
    standalone_clouds_amt defines the number, amount (cloud fraction), and type (hi, mid, low) of clouds present on the model grid.



    INPUT
    is    is,ie,js,je starting/ending subdomain i,j indices of data in the physics_window being integrated
       [integer]
    ie   
       [integer]
    js   
       [integer]
    je   
       [integer]
    lat    lat latitude of model points [ radians ]


       [real]
    press_mks    press_mks pressure at model levels (1:nlev), surface pressure is stored at index value nlev+1 [ (kg /( m s^2) ]


       [real]

    INPUT/OUTPUT
    Cld_spec    Cld_spec cld_specification_type variable containing the cloud specification input fields needed by the radiation package

    the following elements of Cld_spec are defined here:

    %cmxolw fraction of maximally overlapped clouds seen by the longwave radiation [ dimensionless ] %crndlw fraction of randomly overlapped clouds seen by the longwave radiation [ dimensionless ] %camtsw cloud fraction seen by the shortwave radiation; the sum of the maximally overlapped and randomly overlapped longwave cloud fractions [ dimensionless ] %nmxolw number of maximally overlapped longwave clouds in each grid column. %nrndlw number of randomly overlapped longwave clouds in each grid column. %ncldsw number of clouds seen by he shortwave radiation in each grid column. %hi_cld logical flag indicating the presence of high clouds in a grid box %mid_cld logical flag indicating the presence of middle clouds in a grid box %low_cld logical flag indicating the presence of low clouds in a grid box


       [cld_specification_type]

  5. obtain_micro_lw_sa

    call obtain_micro_lw_sa (is, ie, js, je, Lsc_microphys, & Meso_microphys, Cell_microphys, & Lscrad_props, Mesorad_props, & Cellrad_props)
    DESCRIPTION
    obtain_micro_lw_sa defines microphysically-based longwave cloud radiative properties when the code is executed in standalone columns mode.



    INPUT
    is    is,ie,js,je starting/ending subdomain i,j indices of data in the physics_window being integrated


       [integer]
    ie   
       [integer]
    js   
       [integer]
    je   
       [integer]

    INPUT/OUTPUT
    Lsc_microphys    Lsc_microphys microphysical specification for large-scale clouds, provides input to this subroutine [ microphysics_type ]


       [microphysics_type]
    Meso_microphys    Meso_microphys microphysical specification for meso-scale clouds, provides input to this subroutine [ microphysics_type ]


       [microphysics_type]
    Cell_microphys    Cell_microphys microphysical specification for cell-scale clouds, provides input to this subroutine [ microphysics_type ]


       [microphysics_type]
    Lscrad_props    Lscrad_props cloud radiative properties on model grid, [ microrad_properties_type ]


       [microrad_properties_type]
    Mesorad_props    Mesorad_props meso-scale cloud radiative properties on model grid, [ microrad_properties_type ]


       [microrad_properties_type]
    Cellrad_props    Cellrad_props cell-scale cloud radiative properties on model grid, [ microrad_properties_type ]


       [microrad_properties_type]

  6. obtain_micro_sw_sa

    call obtain_micro_sw_sa (is, ie, js, je, Lsc_microphys, & Meso_microphys, Cell_microphys, & Lscrad_props, Mesorad_props, & Cellrad_props)
    DESCRIPTION
    obtain_micro_sw_sa defines microphysically-based shortwave cloud radiative properties for the standalone cloud scheme when run in columns mode.



    INPUT
    is   
       [integer]
    ie   
       [integer]
    js   
       [integer]
    je   
       [integer]

    INPUT/OUTPUT
    Lsc_microphys   
       [microphysics_type]
    Meso_microphys   
       [microphysics_type]
    Cell_microphys   
       [microphysics_type]
    Lscrad_props   
       [microrad_properties_type]
    Mesorad_props   
       [microrad_properties_type]
    Cellrad_props   
       [microrad_properties_type]

  7. obtain_bulk_lw_sa

    call obtain_bulk_lw_sa (is, ie, js, je, Cldrad_props)
    DESCRIPTION
    obtain_bulk_lw_sa defines bulk longwave cloud radiative properties when using specified clouds in the standalone columns mode.



    INPUT
    is    is,ie,js,je starting/ending subdomain i,j indices of data in the physics_window being integrated
       [integer]
    ie   
       [integer]
    js   
       [integer]
    je   
       [integer]

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

    the following components of this variable are output from this routine:

    %emrndlw longwave cloud emissivity for randomly overlapped clouds in each of the longwave frequency bands [ dimensionless ] %emmxolw longwave cloud emissivity for maximally overlapped clouds in each of the longwave frequency bands [ dimensionless ]


       [cldrad_properties_type]

  8. obtain_bulk_sw_sa

    call obtain_bulk_sw_sa (is, ie, js, je, Cldrad_props)
    DESCRIPTION
    obtain_bulk_sw_sa defines bulk shortwave cloud radiative properties for the specified cloud scheme when running in standalone columns mode.



    INPUT
    is   
       [integer]
    ie   
       [integer]
    js   
       [integer]
    je   
       [integer]

    INPUT/OUTPUT
    Cldrad_props   
       [cldrad_properties_type]


DATA SETS

None.


ERROR MESSAGES

None.


top