gfs_stochastics_run()

subroutine gfs_stochastics::gfs_stochastics_run	(	integer, intent(in)	im,
		integer, intent(in)	km,
		integer, intent(in)	kdt,
		real(kind_phys), intent(in)	delt,
		logical, intent(in)	do_sppt,
		logical, intent(in)	pert_mp,
		logical, intent(in)	use_zmtnblck,
		logical, intent(in)	do_shum,
		logical, intent(in)	do_skeb,
		logical, intent(in)	do_ca,
		logical, intent(in)	ca_global,
		real(kind_phys), dimension(:), intent(in)	ca1,
		real(kind_phys), dimension(:), intent(in)	vfact_ca,
		real(kind_phys), dimension(:), intent(in)	zmtnblck,
		real(kind_phys), dimension(:,:), intent(inout)	sppt_wts,
		real(kind_phys), dimension(:,:), intent(in)	skebu_wts,
		real(kind_phys), dimension(:,:), intent(in)	skebv_wts,
		real(kind_phys), dimension(:,:), intent(in)	shum_wts,
		real(kind_phys), dimension(:,:), intent(in)	diss_est,
		real(kind_phys), dimension(:,:), intent(in)	ugrs,
		real(kind_phys), dimension(:,:), intent(in)	vgrs,
		real(kind_phys), dimension(:,:), intent(in)	tgrs,
		real(kind_phys), dimension(:,:), intent(in)	qgrs_wv,
		real(kind_phys), dimension(:,:), intent(in)	qgrs_cw,
		real(kind_phys), dimension(:,:), intent(in)	qgrs_rw,
		real(kind_phys), dimension(:,:), intent(in)	qgrs_sw,
		real(kind_phys), dimension(:,:), intent(in)	qgrs_iw,
		real(kind_phys), dimension(:,:), intent(in)	qgrs_gl,
		real(kind_phys), dimension(:,:), intent(inout)	gu0,
		real(kind_phys), dimension(:,:), intent(inout)	gv0,
		real(kind_phys), dimension(:,:), intent(inout)	gt0,
		real(kind_phys), dimension(:,:), intent(inout)	gq0_wv,
		real(kind_phys), dimension(:,:), intent(inout)	dtdtnp,
		real(kind_phys), dimension(:,:), intent(inout)	gq0_cw,
		real(kind_phys), dimension(:,:), intent(inout)	gq0_rw,
		real(kind_phys), dimension(:,:), intent(inout)	gq0_sw,
		real(kind_phys), dimension(:,:), intent(inout)	gq0_iw,
		real(kind_phys), dimension(:,:), intent(inout)	gq0_gl,
		real(kind_phys), dimension(:), intent(in)	rain,
		real(kind_phys), dimension(:), intent(in)	rainc,
		real(kind_phys), dimension(:), intent(inout)	tprcp,
		real(kind_phys), dimension(:), intent(inout)	totprcp,
		real(kind_phys), dimension(:), intent(inout)	cnvprcp,
		real(kind_phys), dimension(:), intent(inout)	totprcpb,
		real(kind_phys), dimension(:), intent(inout)	cnvprcpb,
		logical, intent(in)	cplflx,
		real(kind_phys), dimension(:), intent(inout)	rain_cpl,
		real(kind_phys), dimension(:), intent(inout)	snow_cpl,
		real(kind_phys), dimension(:), intent(in)	drain_cpl,
		real(kind_phys), dimension(:), intent(in)	dsnow_cpl,
		integer, intent(in)	ntcw,
		integer, intent(in)	ntrw,
		integer, intent(in)	ntsw,
		integer, intent(in)	ntiw,
		integer, intent(in)	ntgl,
		character(len=*), intent(out)	errmsg,
		integer, intent(out)	errflg
	)

Argument Table

local_name	standard_name	long_name	units	type	dimensions	kind	intent
im	horizontal_loop_extent	horizontal loop extent	count	integer	()		in
km	vertical_layer_dimension	number of vertical levels	count	integer	()		in
kdt	index_of_timestep	current forecast iteration	index	integer	()		in
delt	timestep_for_physics	physics timestep	s	real	()	kind_phys	in
do_sppt	flag_for_stochastic_physics_perturbations	flag for stochastic physics perturbations	flag	logical	()		in
pert_mp	flag_for_stochastic_microphysics_perturbations	flag for stochastic microphysics physics perturbations	flag	logical	()		in
use_zmtnblck	flag_for_mountain_blocking_for_sppt	flag for mountain blocking	flag	logical	()		in
do_shum	flag_for_stochastic_shum_option	flag for stochastic shum option	flag	logical	()		in
do_skeb	flag_for_stochastic_skeb_option	flag for stochastic skeb option	flag	logical	()		in
do_ca	flag_for_cellular_automata	cellular automata main switch	flag	logical	()		in
ca_global	flag_for_global_cellular_automata	switch for global ca	flag	logical	()		in
ca1	cellular_automata_global_pattern_from_coupled_process	cellular automata global pattern	flag	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
vfact_ca	cellular_automata_vertical_weight	vertical weight for ca	frac	real	(ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
zmtnblck	level_of_dividing_streamline	level of the dividing streamline	none	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
sppt_wts	sppt_weights_from_coupled_process	weights for stochastic sppt perturbation	none	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
skebu_wts	skeb_x_wind_weights_from_coupled_process	weights for stochastic skeb perturbation of x wind	none	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
skebv_wts	skeb_y_wind_weights_from_coupled_process	weights for stochastic skeb perturbation of y wind	none	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
shum_wts	shum_weights_from_coupled_process	weights for stochastic shum perturbation	none	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
diss_est	dissipation_estimate_of_air_temperature_at_model_layers	dissipation estimate model layer mean temperature	K	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
ugrs	x_wind	zonal wind	m s-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
vgrs	y_wind	meridional wind	m s-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
tgrs	air_temperature	model layer mean temperature	K	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
qgrs_wv	specific_humidity	water vapor specific humidity	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
qgrs_cw	cloud_liquid_water_mixing_ratio	ratio of mass of cloud water to mass of dry air plus vapor (without condensates)	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
qgrs_rw	rain_mixing_ratio	moist mixing ratio of rain	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
qgrs_sw	snow_mixing_ratio	moist mixing ratio of snow	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
qgrs_iw	cloud_ice_mixing_ratio	moist mixing ratio of cloud ice	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
qgrs_gl	graupel_mixing_ratio	moist ratio of mass of graupel to mass of dry air plus vapor (without condensates)	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	in
gu0	x_wind_of_new_state	zonal wind updated by physics	m s-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gv0	y_wind_of_new_state	meridional wind updated by physics	m s-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gt0	air_temperature_of_new_state	temperature updated by physics	K	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gq0_wv	specific_humidity_of_new_state	water vapor specific humidity updated by physics	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
dtdtnp	tendency_of_air_temperature_to_withold_from_sppt	temp. change from physics that should not be perturbed by sppt	K s-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gq0_cw	cloud_liquid_water_mixing_ratio_of_new_state	cloud condensed water mixing ratio updated by physics	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gq0_rw	rain_mixing_ratio_of_new_state	moist mixing ratio of rain updated by physics	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gq0_sw	snow_mixing_ratio_of_new_state	moist mixing ratio of snow updated by physics	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gq0_iw	cloud_ice_mixing_ratio_of_new_state	moist mixing ratio of cloud ice updated by physics	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
gq0_gl	graupel_mixing_ratio_of_new_state	moist ratio of mass of graupel to mass of dry air plus vapor (without condensates) updated by physics	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:vertical_layer_dimension)	kind_phys	inout
rain	lwe_thickness_of_precipitation_amount_on_dynamics_timestep	total rain at this time step	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
rainc	lwe_thickness_of_convective_precipitation_amount_on_dynamics_timestep	convective rain at this time step	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
tprcp	nonnegative_lwe_thickness_of_precipitation_amount_on_dynamics_timestep	total precipitation amount in each time step	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	inout
totprcp	accumulated_lwe_thickness_of_precipitation_amount	accumulated total precipitation	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	inout
cnvprcp	cumulative_lwe_thickness_of_convective_precipitation_amount	cumulative convective precipitation	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	inout
totprcpb	accumulated_lwe_thickness_of_precipitation_amount_in_bucket	accumulated total precipitation in bucket	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	inout
cnvprcpb	cumulative_lwe_thickness_of_convective_precipitation_amount_in_bucket	cumulative convective precipitation in bucket	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	inout
cplflx	flag_for_surface_flux_coupling	flag controlling cplflx collection (default off)	flag	logical	()		in
rain_cpl	cumulative_lwe_thickness_of_precipitation_amount_for_coupling	total rain precipitation	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	inout
snow_cpl	cumulative_lwe_thickness_of_snow_amount_for_coupling	total snow precipitation	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	inout
drain_cpl	tendency_of_lwe_thickness_of_rain_amount_on_dynamics_timestep_for_coupling	change in rain_cpl (coupling_type)	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
dsnow_cpl	tendency_of_lwe_thickness_of_snowfall_amount_on_dynamics_timestep_for_coupling	change in show_cpl (coupling_type)	m	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
ntcw	index_of_cloud_liquid_water_mixing_ratio_in_tracer_concentration_array	tracer index for cloud condensate (or liquid water)	index	integer	()		in
ntrw	index_of_rain_mixing_ratio_in_tracer_concentration_array	tracer index for rain water	index	integer	()		in
ntsw	index_of_snow_mixing_ratio_in_tracer_concentration_array	tracer index for snow water	index	integer	()		in
ntiw	index_of_cloud_ice_mixing_ratio_in_tracer_concentration_array	tracer index for ice water	index	integer	()		in
ntgl	index_of_graupel_mixing_ratio_in_tracer_concentration_array	tracer index for graupel	index	integer	()		in
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

GFS_stochastics_run General Algorithm

This is the GFS stochastic physics driver. Routines are called prior to radiation and physics steps to handle:

1. sets up various time/date variables
2. sets up various triggers
3. defines random seed indices for radiation (in a reproducible way)
4. interpolates coefficients for prognostic ozone calculation
5. performs surface data cycling via the GFS gcycle routine