gfs_rrtmgp_cloud_overlap_run()

subroutine, public gfs_rrtmgp_cloud_overlap::gfs_rrtmgp_cloud_overlap_run	(	integer, intent(in)	ncol,
		integer, intent(in)	nlev,
		integer, intent(in)	yearlen,
		logical, intent(in)	doswrad,
		logical, intent(in)	dolwrad,
		real(kind_phys), intent(in)	julian,
		real(kind_phys), dimension(:), intent(in)	lat,
		real(kind_phys), dimension(:,:), intent(in), optional	deltazc,
		real(kind_phys), intent(in)	con_pi,
		real(kind_phys), intent(in)	con_g,
		real(kind_phys), intent(in)	con_rd,
		real(kind_phys), intent(in)	con_epsq,
		real(kind_phys), intent(in)	dcorr_con,
		integer, intent(in)	idcor,
		integer, intent(in)	iovr,
		integer, intent(in)	iovr_dcorr,
		integer, intent(in)	iovr_exp,
		integer, intent(in)	iovr_exprand,
		integer, intent(in)	idcor_con,
		integer, intent(in)	idcor_hogan,
		integer, intent(in)	idcor_oreopoulos,
		real(kind_phys), dimension(:,:), intent(in)	cld_frac,
		real(kind_phys), dimension(:,:), intent(in), optional	cld_cnv_frac,
		integer, intent(in)	iovr_convcld,
		logical, intent(in)	top_at_1,
		integer, intent(in)	imfdeepcnv,
		integer, intent(in)	imfdeepcnv_gf,
		integer, intent(in)	imfdeepcnv_samf,
		real(kind_phys), dimension(:), intent(out)	de_lgth,
		real(kind_phys), dimension(:,:), intent(out), optional	cloud_overlap_param,
		real(kind_phys), dimension(:,:), intent(out), optional	cnv_cloud_overlap_param,
		real(kind_phys), dimension(:,:), intent(out), optional	precip_overlap_param,
		character(len=*), intent(out)	errmsg,
		integer, intent(out)	errflg )

Argument Table

local_name	standard_name	long_name	units	type	dimensions	kind	intent
nCol	horizontal_loop_extent	horizontal dimension	count	integer	()		in
nLev	vertical_layer_dimension	number of vertical levels	count	integer	()		in
yearlen	number_of_days_in_current_year	number of days in a year	days	integer	()		in
doSWrad	flag_for_calling_shortwave_radiation	logical flags for sw radiation calls	flag	logical	()		in
doLWrad	flag_for_calling_longwave_radiation	logical flags for lw radiation calls	flag	logical	()		in
julian	forecast_julian_day	julian day	days	real	()	kind_phys	in
lat	latitude	latitude	radian	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
deltaZc	layer_thickness_from_layer_center	layer_thickness	m	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
con_pi	pi	ratio of a circle's circumference to its diameter	none	real	()	kind_phys	in
con_g	gravitational_acceleration	gravitational acceleration	m s-2	real	()	kind_phys	in
con_rd	gas_constant_of_dry_air	ideal gas constant for dry air	J kg-1 K-1	real	()	kind_phys	in
con_epsq	minimum_value_of_specific_humidity	floor value for specific humidity	kg kg-1	real	()	kind_phys	in
dcorr_con	decorrelation_length_used_by_overlap_method	decorrelation length (default) used by cloud overlap method (iovr)	km	real	()	kind_phys	in
idcor	flag_for_decorrelation_length_method	flag for decorrelation length method used in cloud overlap method (iovr)	flag	integer	()		in
iovr	flag_for_cloud_overlap_method_for_radiation	flag for cloud overlap method	flag	integer	()		in
iovr_convcld	flag_for_convective_cloud_overlap_method_for_radiation	flag for convective cloud overlap method	flag	integer	()		in
iovr_dcorr	flag_for_decorrelation_length_cloud_overlap_method	choice of decorrelation-length cloud overlap method	flag	integer	()		in
iovr_exp	flag_for_exponential_cloud_overlap_method	choice of exponential cloud overlap method	flag	integer	()		in
iovr_exprand	flag_for_exponential_random_cloud_overlap_method	choice of exponential-random cloud overlap method	flag	integer	()		in
idcor_con	flag_for_constant_decorrelation_length_method	choice of decorrelation length computation (costant)	flag	integer	()		in
idcor_hogan	flag_for_hogan_decorrelation_length_method	choice of decorrelation length computation (hogan)	flag	integer	()		in
idcor_oreopoulos	flag_for_oreopoulos_decorrelation_length_method	choice of decorrelation length computation (oreopoulos)	flag	integer	()		in
cld_frac	total_cloud_fraction	layer total cloud fraction	frac	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
cld_cnv_frac	convective_cloud_fraction_for_rrtmgp	layer convective cloud fraction	frac	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
top_at_1	flag_for_vertical_ordering_in_radiation	flag for vertical ordering in radiation	flag	logical	()		in
imfdeepcnv	control_for_deep_convection_scheme	flag for mass-flux deep convection scheme	flag	integer	()		in
imfdeepcnv_gf	identifier_for_grell_freitas_deep_convection	flag for Grell-Freitas deep convection scheme	flag	integer	()		in
imfdeepcnv_samf	identifer_for_scale_aware_mass_flux_deep_convection	flag for SAMF deep convection scheme	flag	integer	()		in
de_lgth	cloud_decorrelation_length	cloud decorrelation length	km	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	out
cloud_overlap_param	cloud_overlap_param	cloud overlap parameter	km	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	out
precip_overlap_param	precip_overlap_param	precipitation overlap parameter	km	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	out
cnv_cloud_overlap_param	convective_cloud_overlap_param	convective cloud overlap parameter	km	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	out
errmsg	ccpp_error_message	error message for error handling in CCPP	none	character	()	len=*	out
errflg	ccpp_error_code	error code for error handling in CCPP	1	integer	()		out

This is identical (shares common-code) to RRTMG. The motivation for RRTMGP to have its own scheme is both organizational and philosophical*.

*The number of "clouds" being produced by the model physics is often greater than one. rte-rrtmgp can accomodate multiple cloud-types. This module preservers this enhancement in the EMCs coupling to the RRTMGP scheme.

Parameters

[in]	idcor_oreopoulos	Flag for decorrelation-length. (10.5194/acp-12-9097-2012)
[in]	dolwrad	Call LW radiation
[in]	dcorr_con	Decorrelation-length (used if idcor = idcor_con)
[in]	lat	Latitude
[in]	cld_frac	Total cloud fraction
[in]	cld_cnv_frac	Convective cloud-fraction
[in]	deltazc	Layer thickness (from layer-centers)(m)
[out]	de_lgth	Decorrelation length
[out]	precip_overlap_param	Precipitation overlap parameter
[out]	errmsg	Error message
[out]	errflg	Error flag

Parameters

ncol	Number of horizontal grid points
nlev	Number of vertical layers
yearlen	Length of current year (365/366) WTF?
doswrad	Call SW radiation?
julian	Julian day
con_pi	Physical constant: pi
con_g	Physical constant: gravitational constant
con_rd	Physical constant: gas-constant for dry air
con_epsq	Physical constant: Minimum value for specific humidity
idcor	Choice of method for decorrelation length computation
iovr	Choice of cloud-overlap method
iovr_dcorr	Flag for decorrelation-length cloud overlap method
iovr_exp	Flag for exponential cloud overlap method
iovr_exprand	Flag for exponential-random cloud overlap method
idcor_con	Flag for decorrelation-length. Use constant value
idcor_hogan	Flag for decorrelation-length. (https://rmets.onlinelibrary.wiley.com/doi/full/10.1002/qj.647)
iovr_convcld	Choice of convective cloud-overlap method
top_at_1	Vertical ordering flag
imfdeepcnv
imfdeepcnv_gf
imfdeepcnv_samf
cloud_overlap_param	Cloud-overlap parameter
cnv_cloud_overlap_param	Convective cloud-overlap parameter