CCPP Scientific Documentation
v5.0.0
Morrison-Gettelman MP Driver Module

This subroutine is the Morrison-Gettelman MP driver, which computes grid-scale condensation and evaporation of cloud condensate. More...

Detailed Description

Argument Table

m_micro_run argument table
local_namestandard_namelong_nameunitstypedimensionskindintentoptional
imhorizontal_loop_extenthorizontal loop extentcountinteger()inFalse
lmvertical_dimensionvertical layer dimensioncountinteger()inFalse
flipvflag_flipvertical flip logicalflaglogical()inFalse
dt_itime_step_for_physicsphysics time stepsreal()kind_physinFalse
prsl_iair_pressurelayer mean pressurePareal(horizontal_dimension, vertical_dimension)kind_physinFalse
prsi_iair_pressure_at_interfaceair pressure at model layer interfacesPareal(horizontal_dimension, vertical_dimension_plus_one)kind_physinFalse
philgeopotentialgeopotential at model layer centersm2 s-2real(horizontal_dimension, vertical_dimension)kind_physinFalse
phiigeopotential_at_interfacegeopotential at model layer interfacesm2 s-2real(horizontal_dimension, vertical_dimension_plus_one)kind_physinFalse
omega_iomegalayer mean vertical velocityPa s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
qlls_icloud_condensed_water_mixing_ratio_convective_transport_tracerratio of mass of cloud water to mass of dry air plus vapor (without condensates) in the convectively transported tracer arraykg kg-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
qlcn_imass_fraction_of_convective_cloud_liquid_watermass fraction of convective cloud liquid waterkg kg-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
qils_iice_water_mixing_ratio_convective_transport_tracerratio of mass of ice water to mass of dry air plus vapor (without condensates) in the convectively transported tracer arraykg kg-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
qicn_imass_fraction_of_convective_cloud_icemass fraction of convective cloud ice waterkg kg-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
lwheat_itendency_of_air_temperature_due_to_longwave_heating_on_radiation_time_steptotal sky lw heating rateK s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
swheat_itendency_of_air_temperature_due_to_shortwave_heating_on_radiation_time_steptotal sky sw heating rateK s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
w_upivertical_velocity_for_updraftvertical velocity for updraftm s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
cf_upiconvective_cloud_fraction_for_microphysicsconvective cloud fraction for microphysicsfracreal(horizontal_dimension, vertical_dimension)kind_physinFalse
frlandland_area_fraction_for_microphysicsland area fraction used in microphysics schemesfracreal(horizontal_dimension)kind_physinFalse
zpblatmosphere_boundary_layer_thicknesspbl heightmreal(horizontal_dimension)kind_physinFalse
cnv_mfd_idetrained_mass_fluxdetrained mass fluxkg m-2 s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
cnv_dqldt_itendency_of_cloud_water_due_to_convective_microphysicstendency of cloud water due to convective microphysicskg m-2 s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
clcn_iconvective_cloud_volume_fractionconvective cloud volume fractionfracreal(horizontal_dimension, vertical_dimension)kind_physinFalse
u_ix_wind_updated_by_physicszonal wind updated by physicsm s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
v_iy_wind_updated_by_physicsmeridional wind updated by physicsm s-1real(horizontal_dimension, vertical_dimension)kind_physinFalse
taugwxcumulative_surface_x_momentum_flux_for_diag_multiplied_by_timestepcumulative sfc x momentum flux multiplied by timestepPa sreal(horizontal_dimension)kind_physinFalse
taugwycumulative_surface_y_momentum_flux_for_diag_multiplied_by_timestepcumulative sfc y momentum flux multiplied by timestepPa sreal(horizontal_dimension)kind_physinFalse
tauoroxinstantaneous_surface_x_momentum_fluxx momentum fluxPareal(horizontal_dimension)kind_physinFalse
tauoroyinstantaneous_surface_y_momentum_fluxy momentum fluxPareal(horizontal_dimension)kind_physinFalse
cnv_fice_iice_fraction_in_convective_towerice fraction in convective towerfracreal(horizontal_dimension, vertical_dimension)kind_physinFalse
cnv_ndrop_inumber_concentration_of_cloud_liquid_water_particles_for_detrainmentdroplet number concentration in convective detrainmentm-3real(horizontal_dimension, vertical_dimension)kind_physinFalse
cnv_nice_inumber_concentration_of_ice_crystals_for_detrainmentcrystal number concentration in convective detrainmentm-3real(horizontal_dimension, vertical_dimension)kind_physinFalse
q_iowater_vapor_specific_humidity_updated_by_physicswater vapor specific humidity updated by physicskg kg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
lwm_ocloud_condensed_water_mixing_ratio_updated_by_physicsratio of mass of cloud water to mass of dry air plus vapor (without condensates) updated by physicskg kg-1real(horizontal_dimension, vertical_dimension)kind_physoutFalse
qi_oice_water_mixing_ratio_updated_by_physicsratio of mass of ice water to mass of dry air plus vapor (without condensates) updated by physicskg kg-1real(horizontal_dimension, vertical_dimension)kind_physoutFalse
t_ioair_temperature_updated_by_physicstemperature updated by physicsKreal(horizontal_dimension, vertical_dimension)kind_physinoutFalse
rn_olwe_thickness_of_explicit_precipitation_amountexplicit precipitation (rain, ice, snow, graupel, ...) on physics timestepmreal(horizontal_dimension)kind_physoutFalse
sr_oratio_of_snowfall_to_rainfallsnow ratio: ratio of snow to total precipitationfracreal(horizontal_dimension)kind_physoutFalse
ncpl_iocloud_droplet_number_concentration_updated_by_physicsnumber concentration of cloud droplets updated by physicskg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
ncpi_ioice_number_concentration_updated_by_physicsnumber concentration of ice updated by physicskg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
fprcpnumber_of_frozen_precipitation_speciesnumber of frozen precipitation speciescountinteger()inFalse
rnw_iolocal_rain_water_mixing_ratioratio of mass of rain water to mass of dry air plus vapor (without condensates) local to physicskg kg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
snw_iolocal_snow_water_mixing_ratioratio of mass of snow water to mass of dry air plus vapor (without condensates) local to physicskg kg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
qgl_iolocal_graupel_mixing_ratioratio of mass of graupel to mass of dry air plus vapor (without condensates) local to physicskg kg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
ncpr_iolocal_rain_number_concentrationnumber concentration of rain local to physicskg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
ncps_iolocal_snow_number_concentrationnumber concentration of snow local to physicskg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
ncgl_iolocal_graupel_number_concentrationnumber concentration of graupel local to physicskg-1real(horizontal_dimension, vertical_dimension)kind_physinoutFalse
clls_iocloud_fraction_for_MGcloud fraction used by Morrison-Gettelman MPfracreal(horizontal_dimension, vertical_dimension)kind_physinoutFalse
kcblvertical_index_at_cloud_basevertical index at cloud baseindexinteger(horizontal_dimension)inoutFalse
cldreffleffective_radius_of_stratiform_cloud_liquid_water_particle_in_umeffective radius of cloud liquid water particle in micrometerumreal(horizontal_dimension, vertical_dimension)kind_physoutFalse
cldreffieffective_radius_of_stratiform_cloud_ice_particle_in_umeffective radius of cloud ice water particle in micrometersumreal(horizontal_dimension, vertical_dimension)kind_physoutFalse
cldreffreffective_radius_of_stratiform_cloud_rain_particle_in_umeffective radius of cloud rain particle in micrometersumreal(horizontal_dimension, vertical_dimension)kind_physoutFalse
cldreffseffective_radius_of_stratiform_cloud_snow_particle_in_umeffective radius of cloud snow particle in micrometersumreal(horizontal_dimension, vertical_dimension)kind_physoutFalse
cldreffgeffective_radius_of_stratiform_cloud_graupel_particle_in_umeffective radius of cloud graupel particle in micrometersumreal(horizontal_dimension, vertical_dimension)kind_physoutFalse
aerfld_iaerosol_number_concentration_from_gocart_aerosol_climatologyGOCART aerosol climatology number concentrationkg-1?real(horizontal_dimension, vertical_dimension, number_of_aerosol_tracers_MG)kind_physinFalse
naai_iin_number_concentrationIN number concentrationkg-1?real(horizontal_dimension, vertical_dimension)kind_physinFalse
npccn_iccn_number_concentrationCCN number concentrationkg-1?real(horizontal_dimension, vertical_dimension)kind_physinFalse
iccnflag_for_in_ccn_forcing_for_morrison_gettelman_microphysicsflag for IN and CCN forcing for morrison gettelman microphysicsnoneinteger()inFalse
skip_macroflag_skip_macroflag to skip cloud macrophysics in Morrison schemeflaglogical()inFalse
alf_facmg_tuning_factor_for_alphastuning factor for alphas (alpha = 1 - critical relative humidity)nonereal()kind_physinFalse
qc_minmg_minimum_cloud_condensed_water_and_ice_mixing_ratiominimum cloud condensed water and ice mixing ratio in MG macro cloudskg kg-1real(2)kind_physinFalse
pdfflagflag_for_pdf_for_morrison_gettelman_microphysics_schemepdf flag for MG macrophysicsflaginteger()inFalse
kdtindex_of_time_stepcurrent forecast iterationindexinteger()inFalse
xlatlatitudelatituderadianreal(horizontal_dimension)kind_physinFalse
xlonlongitudelongituderadianreal(horizontal_dimension)kind_physinFalse
rhc_icritical_relative_humiditycritical relative humidityfracreal(horizontal_dimension, vertical_dimension)kind_physinFalse
errmsgccpp_error_messageerror message for error handling in CCPPnonecharacter()len=*outFalse
errflgccpp_error_flagerror flag for error handling in CCPPflaginteger()outFalse

MG m_micro_run Detailed Algorithm

Collaboration diagram for Morrison-Gettelman MP Driver Module:

Modules

 Morrison-Gettelman MP version 3.0
 

Purpose: MG microphysics version 3.0 - Update of MG microphysics with prognostic hail OR graupel.

 
 Morrison-Gettelman MP utils Module
 This module contains process rates and utility functions used by the MG microphysics.
 
 Morrison-Gettelman MP cldmacro Module
 This module contains MG cloud macrophysics scheme.
 
 Morrison-Gettelman MP aer_cloud Module
 according to the models of Nenes & Seinfeld (2003) [136], Fountoukis and Nenes (2005) [55] and Barahona and Nenes (2008, 2009) [13] [14] . *** Code Developer: Donifan Barahona donif.nosp@m.an.o.nosp@m..bara.nosp@m.hona.nosp@m.@nasa.nosp@m..gov
 
 Morrison-Gettelman MP cldwat2m_micro Module
 This module contains CAM interface for MG microphysics.
 
 Morrison-Gettelman MP wv_saturation Module
 This module contain some utility functions for saturation vapor pressure.
 

Functions/Subroutines

subroutine, public m_micro::m_micro_run ( im, lm, flipv, dt_i , prsl_i, prsi_i, phil, phii , omega_i, QLLS_i, QLCN_i, QILS_i, QICN_i, lwheat_i, swheat_i, w_upi, cf_upi , FRLAND, ZPBL, CNV_MFD_i , CNV_DQLDT_i, CLCN_i, u_i, v_i , TAUGWX, TAUGWY , TAUOROX, TAUOROY, CNV_FICE_i , CNV_NDROP_i, CNV_NICE_i, q_io, lwm_o , qi_o, t_io, rn_o, sr_o , ncpl_io, ncpi_io, fprcp, rnw_io, snw_io, qgl_io, ncpr_io, ncps_io, ncgl_io , CLLS_io, KCBL , CLDREFFL, CLDREFFI, CLDREFFR, CLDREFFS, CLDREFFG, aerfld_i , naai_i, npccn_i, iccn , skip_macro , alf_fac, qc_min, pdfflag , kdt, xlat, xlon, rhc_i, errmsg, errflg)
 
subroutine m_micro::find_cldtop (ncol, pver, cf, kcldtop)
 This subroutine is to find cloud top based on cloud fraction. More...
 
elemental real(r8) function micro_mg_utils::var_coef_r8 (relvar, a)
 Finds a coefficient for process rates based on the relative variance of cloud water. More...
 
elemental real(r8) function micro_mg_utils::var_coef_integer (relvar, a)
 Finds a coefficient for process rates based on the relative variance of cloud water. More...
 
subroutine m_micro::gw_prof (pcols, pver, ncol, t, pm, pi, rhoi, ni, ti, nm, sph)
 This subroutine computes profiles of background state quantities for the multiple gravity wave drag parameterization. More...