← Back to Documentation Home
CCPP SciDoc for Global Workflow v1.0.0  GW v1.0.0
Common Community Physics Package Developed at DTC
Loading...
Searching...
No Matches
GFDL Cloud Microphysics Module

This is cloud microphysics package for GFDL global cloud resolving model. The algorithms are originally derived from Lin et al. (1983) [77]. Most of the key elements have been simplified/improved. This code at this stage bears little to no similarity to the original Lin MP. Therefore, it is best to be called GFDL microphysics (GFDL MP) . More...

Collaboration diagram for GFDL Cloud Microphysics Module:

Topics

 GFDL Cloud MP modules

Functions/Subroutines

real function gfdl_cloud_microphys_mod::acr3d (v1, v2, q1, q2, c, cac, rho)
 The function is an accretion function (Lin et al.(1983) [77] ).
real function gfdl_cloud_microphys_mod::smlt (tc, dqs, qsrho, psacw, psacr, c, rho, rhofac)
 Melting of snow function (Lin et al.(1983) [77]) note: psacw and psacr must be calc before smlt is called.

Detailed Description

The module contains the GFDL cloud microphysics (Chen and Lin (2013) [16] ). The module is paired with GFDL In-Core Fast Saturation Adjustment Module, which performs the "fast" processes.

The subroutine executes the full GFDL cloud microphysics.

Argument Table

gfdl_cloud_microphys_run argument table
local_namestandard_namelong_nameunitstypedimensionskindintent
levsvertical_layer_dimensionnumber of vertical levelscountinteger()in
imhorizontal_loop_extenthorizontal loop extentcountinteger()in
rainminlwe_thickness_of_minimum_rain_amountminimum rain amountmreal()kind_physin
con_ggravitational_accelerationgravitational accelerationm s-2real()kind_physin
con_fvirtratio_of_vapor_to_dry_air_gas_constants_minus_onerv/rd - 1 (rv = ideal gas constant for water vapor)nonereal()kind_physin
con_rdgas_constant_of_dry_airideal gas constant for dry airJ kg-1 K-1real()kind_physin
con_epsratio_of_dry_air_to_water_vapor_gas_constantsrd/rvnonereal()kind_physin
frlandland_area_fraction_for_microphysicsland area fraction used in microphysics schemesfracreal(ccpp_constant_one:horizontal_loop_extent)kind_physin
gareacell_areaarea of grid cellm2real(ccpp_constant_one:horizontal_loop_extent)kind_physin
islmsksea_land_ice_masksea/land/ice mask (=0/1/2)flaginteger(ccpp_constant_one:horizontal_loop_extent)in
gq0specific_humiditywater vapor specific humiditykg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntcwcloud_liquid_water_mixing_ratiocloud condensed water mixing ratiokg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntrwrain_mixing_ratiomoist mixing ratio of rainkg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntiwcloud_ice_mixing_ratiomoist mixing ratio of cloud icekg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntswsnow_mixing_ratiomoist mixing ratio of snowkg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntglgraupel_mixing_ratiomoist ratio of mass of graupel to mass of dry air plus vapor (without condensates)kg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntclamtcloud_area_fraction_in_atmosphere_layercloud fractionfracreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gt0air_temperatureair temperatureKreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gu0x_windzonal windm s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gv0y_windmeridional windm s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
vvllagrangian_tendency_of_air_pressurelayer mean vertical velocityPa s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
prslair_pressuremean layer pressurePareal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
phiigeopotential_at_interfacegeopotential at model layer interfacesm2 s-2real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_interface_dimension)kind_physin
delair_pressure_difference_between_midlayersair pressure difference between mid-layersPareal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
rain0lwe_thickness_of_explicit_rain_amountexplicit rain on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
ice0lwe_thickness_of_ice_amountice fall on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
snow0lwe_thickness_of_snow_amountsnow fall on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
graupel0lwe_thickness_of_graupel_amountgraupel fall on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
prcp0lwe_thickness_of_explicit_precipitation_amountexplicit precipitation (rain, ice, snow, graupel) on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
srratio_of_snowfall_to_rainfallsnow ratio: ratio of snow to total precipitationfracreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
dtptimestep_for_physicsphysics timestepsreal()kind_physin
hydrostaticflag_for_hydrostatic_solverflag indicating hydrostatic solverflaglogical()in
phys_hydrostaticflag_for_hydrostatic_heating_from_physicsflag indicating hydrostatic heating from physicsflaglogical()in
lradarflag_for_radar_reflectivityflag for radar reflectivityflaglogical()in
refl_10cmradar_reflectivity_10cminstantaneous refl_10cmdBZreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
resetflag_reset_maximum_hourly_fieldsflag for resetting maximum hourly fieldsflaglogical()in
effr_inflag_for_cloud_effective_radiiflag for cloud effective radii calculations in GFDL microphysicsflaglogical()in
reweffective_radius_of_stratiform_cloud_liquid_water_particleeff. radius of cloud liquid water particle in micrometerumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
reieffective_radius_of_stratiform_cloud_ice_particleeff. radius of cloud ice water particle in micrometerumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
rereffective_radius_of_stratiform_cloud_rain_particleeffective radius of cloud rain particle in micrometersumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
reseffective_radius_of_stratiform_cloud_snow_particleeffective radius of cloud snow particle in micrometersumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
regeffective_radius_of_stratiform_cloud_graupel_particleeff. radius of cloud graupel particle in micrometerumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
cplchmflag_for_chemistry_couplingflag controlling cplchm collection (default off)flaglogical()in
pfi_lsanice_flux_due_to_large_scale_precipitationinstantaneous 3D flux of ice from nonconvective precipitationkg m-2 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
pfl_lsanliquid_flux_due_to_large_scale_precipitationinstantaneous 3D flux of liquid water from nonconvective precipitationkg m-2 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
ten_ttendency_of_air_temperaturetendency of air temperature calculated by one physics schemeK s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_utendency_of_x_windtendency of x wind calculated by one physics schemem s-2real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_vtendency_of_y_windtendency of y wind calculated by one physics schemem s-2real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qvtendency_of_specific_humiditywater vapor specific humidity tendencykg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qltendency_of_cloud_liquid_water_mixing_ratiocloud condensed water mixing ratio tendencykg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qrtendency_of_rain_mixing_ratioratio of mass of rain water tendency to mass of dry air plus vapor (without condensates)kg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qitendency_of_cloud_ice_mixing_ratiocloud condensed water mixing ratio tendencykg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qstendency_of_snow_mixing_ratioratio of mass of snow water tendency to mass of dry air plus vapor (without condensates)kg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qgtendency_of_graupel_mixing_ratioratio of mass of graupel tendency to mass of dry air plus vapor (without condensates)kg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_cldfrctendency_of_cloud_area_fraction_in_atmosphere_layercloud fraction tendencyfrac s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qtendency_of_tracer_concentrationtendency of tracer concentration calculated by one physics schemekg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension, ccpp_constant_one:number_of_tracers)kind_physout
errmsgccpp_error_messageerror message for error handling in CCPPnonecharacter()len=*out
errflgccpp_error_codeerror code for error handling in CCPP1integer()out

The module contains the GFDL cloud microphysics (Chen and Lin (2013) [16] ). The module is paired with GFDL In-Core Fast Saturation Adjustment Module, which performs the "fast" processes.

The subroutine executes the full GFDL cloud microphysics.

Argument Table

gfdl_cloud_microphys_v3_run argument table
local_namestandard_namelong_nameunitstypedimensionskindintent
fast_mp_consvflag_for_fast_microphysics_energy_conservationflag for fast microphysics energy conservationflaglogical()in
levsvertical_layer_dimensionnumber of vertical levelscountinteger()in
imhorizontal_loop_extenthorizontal loop extentcountinteger()in
rainminlwe_thickness_of_minimum_rain_amountminimum rain amountmreal()kind_physin
con_ggravitational_accelerationgravitational accelerationm s-2real()kind_physin
con_fvirtratio_of_vapor_to_dry_air_gas_constants_minus_onerv/rd - 1 (rv = ideal gas constant for water vapor)nonereal()kind_physin
con_rdgas_constant_of_dry_airideal gas constant for dry airJ kg-1 K-1real()kind_physin
con_epsratio_of_dry_air_to_water_vapor_gas_constantsrd/rvnonereal()kind_physin
gareacell_areaarea of grid cellm2real(ccpp_constant_one:horizontal_loop_extent)kind_physin
slmskarea_typelandmask: sea/land/ice=0/1/2flagreal(ccpp_constant_one:horizontal_loop_extent)kind_physin
snowdlwe_surface_snowwater equivalent snow depthmmreal(ccpp_constant_one:horizontal_loop_extent)kind_physin
gq0specific_humiditywater vapor specific humiditykg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntcwcloud_liquid_water_mixing_ratiocloud condensed water mixing ratiokg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntrwrain_mixing_ratiomoist mixing ratio of rainkg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntiwcloud_ice_mixing_ratiomoist mixing ratio of cloud icekg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntswsnow_mixing_ratiomoist mixing ratio of snowkg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntglgraupel_mixing_ratiomoist ratio of mass of graupel to mass of dry air plus vapor (without condensates)kg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gq0_ntclamtcloud_area_fraction_in_atmosphere_layercloud fractionfracreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
aerfldmass_mixing_ratio_of_aerosol_from_gocart_or_merra2mass mixing ratio of aerosol from gocart or merra2kg kg-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension, ccpp_constant_one:number_of_aerosol_tracers_MG)kind_physin
gt0air_temperatureair temperatureKreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gu0x_windzonal windm s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
gv0y_windmeridional windm s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
vvllagrangian_tendency_of_air_pressurelayer mean vertical velocityPa s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
prslair_pressuremean layer pressurePareal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
phiigeopotential_at_interfacegeopotential at model layer interfacesm2 s-2real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_interface_dimension)kind_physin
delair_pressure_difference_between_midlayersair pressure difference between mid-layersPareal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physin
rain0lwe_thickness_of_explicit_rain_amountexplicit rain on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
ice0lwe_thickness_of_ice_amountice fall on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
snow0lwe_thickness_of_snow_amountsnow fall on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
graupel0lwe_thickness_of_graupel_amountgraupel fall on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
prcp0lwe_thickness_of_explicit_precipitation_amountexplicit precipitation (rain, ice, snow, graupel) on physics timestepmreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
srratio_of_snowfall_to_rainfallsnow ratio: ratio of snow to total precipitationfracreal(ccpp_constant_one:horizontal_loop_extent)kind_physout
oroheight_above_mean_sea_levelheight_above_mean_sea_levelmreal(ccpp_constant_one:horizontal_loop_extent)kind_physin
dtptimestep_for_physicsphysics timestepsreal()kind_physin
hydrostaticflag_for_hydrostatic_solverflag indicating hydrostatic solverflaglogical()in
lradarflag_for_radar_reflectivityflag for radar reflectivityflaglogical()in
refl_10cmradar_reflectivity_10cminstantaneous refl_10cmdBZreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
resetflag_reset_maximum_hourly_fieldsflag for resetting maximum hourly fieldsflaglogical()in
effr_inflag_for_cloud_effective_radiiflag for cloud effective radii calculations in GFDL microphysicsflaglogical()in
reweffective_radius_of_stratiform_cloud_liquid_water_particleeff. radius of cloud liquid water particle in micrometerumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
reieffective_radius_of_stratiform_cloud_ice_particleeff. radius of cloud ice water particle in micrometerumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
rereffective_radius_of_stratiform_cloud_rain_particleeffective radius of cloud rain particle in micrometersumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
reseffective_radius_of_stratiform_cloud_snow_particleeffective radius of cloud snow particle in micrometersumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
regeffective_radius_of_stratiform_cloud_graupel_particleeff. radius of cloud graupel particle in micrometerumreal(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
cplchmflag_for_chemistry_couplingflag controlling cplchm collection (default off)flaglogical()in
pfi_lsanice_flux_due_to_large_scale_precipitationinstantaneous 3D flux of ice from nonconvective precipitationkg m-2 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
pfl_lsanliquid_flux_due_to_large_scale_precipitationinstantaneous 3D flux of liquid water from nonconvective precipitationkg m-2 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physinout
con_oneconstant_onemathematical constant of one1real()kind_physin
con_p001constant_one_hundredthmathematical constant for one hundredth1real()kind_physin
con_secindayseconds_in_a_daynumber of seconds in a daysreal()kind_physin
ten_ttendency_of_air_temperaturetendency of air temperature calculated by one physics schemeK s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_utendency_of_x_windtendency of x wind calculated by one physics schemem s-2real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_vtendency_of_y_windtendency of y wind calculated by one physics schemem s-2real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qvtendency_of_specific_humiditywater vapor specific humidity tendencykg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qltendency_of_cloud_liquid_water_mixing_ratiocloud condensed water mixing ratio tendencykg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qrtendency_of_rain_mixing_ratioratio of mass of rain water tendency to mass of dry air plus vapor (without condensates)kg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qitendency_of_cloud_ice_mixing_ratiocloud condensed water mixing ratio tendencykg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qstendency_of_snow_mixing_ratioratio of mass of snow water tendency to mass of dry air plus vapor (without condensates)kg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qgtendency_of_graupel_mixing_ratioratio of mass of graupel tendency to mass of dry air plus vapor (without condensates)kg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_cldfrctendency_of_cloud_area_fraction_in_atmosphere_layercloud fraction tendencyfrac s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)kind_physout
ten_qtendency_of_tracer_concentrationtendency of tracer concentration calculated by one physics schemekg kg-1 s-1real(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension, ccpp_constant_one:number_of_tracers)kind_physout
errmsgccpp_error_messageerror message for error handling in CCPPnonecharacter()len=*out
errflgccpp_error_codeerror code for error handling in CCPP1integer()out