GFS RRTMG-LW Main Module

This module includes NCEP's modifications of the RRTMG-LW radiation code from AER.The RRTMG-LW package includes three files: More...

Modules
module	module_radlw_avplank
	This module contains plank flux data.
module	module_radlw_ref
	This module contains reference temperature and pressure.
module	module_radlw_cldprlw
	This module contains cloud property coefficients.
module	module_radlw_kgb01
	This module sets up absorption coefficients for band 01: 10-350 cm-1 (low - h2o; high - h2o)
module	module_radlw_kgb02
	This module sets up absorption coefficients for band 02: 350-500 cm-1 (low - h2o; high - h2o)
module	module_radlw_kgb03
	This module sets up absorption coefficients for band 03: 500-630 cm-1 (low - h2o, co2; high - h2o, co2)
module	module_radlw_kgb04
	This module sets up absorption coefficients for band 04: 630-700 cm-1 (low - h2o, co2; high - co2, o3)
module	module_radlw_kgb05
	This module sets up absorption coefficients for band 05: 700-820 cm-1 (low - h2o, co2; high - co2, o3)
module	module_radlw_kgb06
	This module sets up absorption coefficients for band 06: 820-980 cm-1 (low - h2o; high - /)
module	module_radlw_kgb07
	This module sets up absorption coefficients for band 07: 980-1080 cm-1 (low - h2o, o3; high - o3)
module	module_radlw_kgb08
	This module sets up absorption coefficients for band 08: 1080-1180 cm-1 (low - h2o; high - o3)
module	module_radlw_kgb09
	This module sets up absorption coefficients for band 09: 1180-1390 cm-1 (low - h2o, ch4; high - ch4)
module	module_radlw_kgb10
	This module sets up absorption coefficients for band 10: 1390-1480 cm-1 (low - h2o; high - h2o)
module	module_radlw_kgb11
	This module sets up absorption coefficients for band 11: 1480-1800 cm-1 (low - h2o; high - h2o)
module	module_radlw_kgb12
	This module sets up absorption coefficients for band 12: 1800-2080 cm-1 (low - h2o, co2; high - /)
module	module_radlw_kgb13
	This module sets up absorption coefficients for band 13: 2080-2250 cm-1 (low - h2o, n2o; high - /)
module	module_radlw_kgb14
	This module sets up absorption coefficients for band 14: 2250-2380 cm-1 (low - co2; high - co2)
module	module_radlw_kgb15
	This module sets up absorption coefficients for band 15: 2380-2600 cm-1 (low - n2o, co2; high - /)
module	module_radlw_kgb16
	This module sets up absorption coefficients for band 16: 2600-3000 cm-1 (low - h2o, ch4; high - /)
module	module_radlw_parameters
	This module contains LW band parameters set up.

Functions/Subroutines
subroutine, public	rrtmg_lw::rrtmg_lw_run (plyr, plvl, tlyr, tlvl, qlyr, olyr, gasvmr_co2, gasvmr_n2o, gasvmr_ch4, gasvmr_o2, gasvmr_co, gasvmr_cfc11, gasvmr_cfc12, gasvmr_cfc22, gasvmr_ccl4, icseed, aeraod, aerssa, sfemis, sfgtmp, dzlyr, delpin, de_lgth, alpha, npts, nlay, nlp1, lprnt, cld_cf, lslwr, top_at_1, iovr, iovr_rand, iovr_maxrand, iovr_max, iovr_dcorr, iovr_exp, iovr_exprand, inc_minor_gas, ilwcliq, ilwcice, isubclw, hlwc, topflx, sfcflx, cldtau, hlw0, hlwb, flxprf, cld_lwp, cld_ref_liq, cld_iwp, cld_ref_ice, cld_rwp, cld_ref_rain, cld_swp, cld_ref_snow, cld_od, errmsg, errflg)
subroutine, public	rrtmg_lw::rlwinit (me, rad_hr_units, inc_minor_gas, ilwcliq, isubclw, iovr, iovr_rand, iovr_maxrand, iovr_max, iovr_dcorr, iovr_exp, iovr_exprand, errflg, errmsg)
	This subroutine performs calculations necessary for the initialization of the longwave model, which includes non-varying model variables, conversion factors, and look-up tables
subroutine	rrtmg_lw::cldprop (cfrac, cliqp, reliq, cicep, reice, cdat1, cdat2, cdat3, cdat4, nlay, nlp1, ipseed, dz, de_lgth, iovr, alpha, ilwcliq, ilwcice, isubclw, cldfmc, taucld)
	This subroutine computes the cloud optical depth(s) for each cloudy layer and g-point interval.
subroutine	rrtmg_lw::mcica_subcol (cldf, nlay, ipseed, dz, de_lgth, alpha, iovr, lcloudy)
	This suroutine computes sub-colum cloud profile flag array.
subroutine	rrtmg_lw::setcoef (pavel, tavel, tz, stemp, h2ovmr, colamt, coldry, colbrd, nlay, nlp1, laytrop, pklay, pklev, jp, jt, jt1, rfrate, fac00, fac01, fac10, fac11, selffac, selffrac, indself, forfac, forfrac, indfor, minorfrac, scaleminor, scaleminorn2, indminor)
	This subroutine computes various coefficients needed in radiative transfer calculations.
subroutine	rrtmg_lw::rtrn (semiss, delp, cldfrc, taucld, tautot, pklay, pklev, fracs, secdif, nlay, nlp1, totuflux, totdflux, htr, totuclfl, totdclfl, htrcl, htrb)
	This subroutine computes the upward/downward radiative fluxes, and heating rates for both clear or cloudy atmosphere. Clouds assumed as randomly overlaping in a vertical column.
subroutine	rrtmg_lw::rtrnmr (semiss, delp, cldfrc, taucld, tautot, pklay, pklev, fracs, secdif, nlay, nlp1, totuflux, totdflux, htr, totuclfl, totdclfl, htrcl, htrb)
	This subroutine computes the upward/downward radiative fluxes, and heating rates for both clear or cloudy atmosphere. Clouds are assumed as in maximum-randomly overlaping in a vertical column.
subroutine	rrtmg_lw::rtrnmc (semiss, delp, cldfmc, taucld, tautot, pklay, pklev, fracs, secdif, nlay, nlp1, totuflux, totdflux, htr, totuclfl, totdclfl, htrcl, htrb)
	This subroutine computes the upward/downward radiative fluxes, and heating rates for both clear or cloudy atmosphere.Clouds are treated with the mcica stochastic approach.
subroutine	rrtmg_lw::taumol (laytrop, pavel, coldry, colamt, colbrd, wx, tauaer, rfrate, fac00, fac01, fac10, fac11, jp, jt, jt1, selffac, selffrac, indself, forfac, forfrac, indfor, minorfrac, scaleminor, scaleminorn2, indminor, nlay, fracs, tautot)
	This subroutine contains optical depths developed for the rapid radiative transfer model.
subroutine	taugb01
	band 1: 10-350 cm-1 (low key - h2o; low minor - n2); (high key - h2o; high minor - n2)
subroutine	taugb02
	Band 2: 350-500 cm-1 (low key - h2o; high key - h2o)
subroutine	taugb03
	Band 3: 500-630 cm-1 (low key - h2o,co2; low minor - n2o); (high key - h2o,co2; high minor - n2o)
subroutine	taugb04
	Band 4: 630-700 cm-1 (low key - h2o,co2; high key - o3,co2)
subroutine	taugb05
	Band 5: 700-820 cm-1 (low key - h2o,co2; low minor - o3, ccl4) (high key - o3,co2)
subroutine	taugb06
	Band 6: 820-980 cm-1 (low key - h2o; low minor - co2) (high key - none; high minor - cfc11, cfc12)
subroutine	taugb07
	Band 7: 980-1080 cm-1 (low key - h2o,o3; low minor - co2) (high key - o3; high minor - co2)
subroutine	taugb08
	Band 8: 1080-1180 cm-1 (low key - h2o; low minor - co2,o3,n2o) (high key - o3; high minor - co2, n2o)
subroutine	taugb09
	Band 9: 1180-1390 cm-1 (low key - h2o,ch4; low minor - n2o) (high key - ch4; high minor - n2o)
subroutine	taugb10
	Band 10: 1390-1480 cm-1 (low key - h2o; high key - h2o)
subroutine	taugb11
	Band 11: 1480-1800 cm-1 (low - h2o; low minor - o2) (high key - h2o; high minor - o2)
subroutine	taugb12
	Band 12: 1800-2080 cm-1 (low - h2o,co2; high - nothing)
subroutine	taugb13
	Band 13: 2080-2250 cm-1 (low key-h2o,n2o; high minor-o3 minor)
subroutine	taugb14
	Band 14: 2250-2380 cm-1 (low - co2; high - co2)
subroutine	taugb15
	Band 15: 2380-2600 cm-1 (low - n2o,co2; low minor - n2) (high - nothing)
subroutine	taugb16
	Band 16: 2600-3250 cm-1 (low key- h2o,ch4; high key - ch4)
subroutine	rrtmg_lw::cldprmc (nlayers, inflag, iceflag, liqflag, cldfmc, ciwpmc, clwpmc, cswpmc, reicmc, relqmc, resnmc, ncbands, taucmc, errmsg, errflg)

Detailed Description

• radlw_param.f, which contains:
  • module_radlw_parameters: band parameters set up
• radlw_datatb.f, which contains modules:
  • module_radlw_avplank: plank flux data
  • module_radlw_ref: reference temperature and pressure
  • module_radlw_cldprlw: cloud property coefficients
  • module_radlw_kgbnn: absorption coeffients for 16 bands, where nn = 01-16
• radlw_main.f, which contains:
  • rrtmg_lw_run(): the main LW radiation routine
  • rlwinit(): the initialization routine

Version

NCEP LW v5.1 Nov 2012 -RRTMG-LW v4.82

Copyright

2002-2007, Atmospheric & Environmental Research, Inc. (AER). This software may be used, copied, or redistributed as long as it is not sold and this copyright notice is reproduced on each copy made. This model is provided as is without any express or implied warranties. (http://www.rtweb.aer.com/)

Argument Table

local_name	standard_name	long_name	units	type	dimensions	kind	intent
plyr	air_pressure_at_layer_for_radiation_in_hpa	air pressure layer	hPa	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
plvl	air_pressure_at_interface_for_radiation_in_hpa	air pressure level	hPa	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_level_dimension_for_radiation)	kind_phys	in
tlyr	air_temperature_at_layer_for_radiation	air temperature layer	K	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
tlvl	air_temperature_at_interface_for_radiation	air temperature level	K	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_level_dimension_for_radiation)	kind_phys	in
qlyr	water_vapor_specific_humidity_at_layer_for_radiation	specific humidity layer	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
olyr	ozone_concentration_at_layer_for_radiation	ozone concentration layer	kg kg-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_co2	volume_mixing_ratio_of_co2	volume mixing ratio co2	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_n2o	volume_mixing_ratio_of_n2o	volume mixing ratio no2	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_ch4	volume_mixing_ratio_of_ch4	volume mixing ratio ch4	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_o2	volume_mixing_ratio_of_o2	volume mixing ratio o2	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_co	volume_mixing_ratio_of_co	volume mixing ratio co	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_cfc11	volume_mixing_ratio_of_cfc11	volume mixing ratio cfc11	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_cfc12	volume_mixing_ratio_of_cfc12	volume mixing ratio cfc12	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_cfc22	volume_mixing_ratio_of_cfc22	volume mixing ratio cfc22	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
gasvmr_ccl4	volume_mixing_ratio_of_ccl4	volume mixing ratio ccl4	m3 m-3	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
icseed	random_number_seed_for_mcica_longwave	seed for random number generation for longwave radiation	none	integer	(ccpp_constant_one:horizontal_loop_extent)		in
aeraod	aerosol_optical_depth_for_longwave_bands_01_16	aerosol optical depth for longwave bands 01-16	none	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation, ccpp_constant_one:number_of_aerosol_bands_for_longwave_radiation)	kind_phys	in
aerssa	aerosol_single_scattering_albedo_for_longwave_bands_01_16	aerosol single scattering albedo for longwave bands 01-16	frac	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation, ccpp_constant_one:number_of_aerosol_bands_for_longwave_radiation)	kind_phys	in
sfemis	surface_longwave_emissivity	surface emissivity	frac	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
sfgtmp	surface_ground_temperature_for_radiation	surface ground temperature for radiation	K	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
dzlyr	layer_thickness_for_radiation	layer thickness	km	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
delpin	layer_pressure_thickness_for_radiation	layer pressure thickness	hPa	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
de_lgth	cloud_decorrelation_length	cloud decorrelation length	km	real	(ccpp_constant_one:horizontal_loop_extent)	kind_phys	in
alpha	cloud_overlap_decorrelation_parameter	cloud overlap decorrelation parameter	frac	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
npts	horizontal_loop_extent	horizontal dimension	count	integer	()		in
nlay	adjusted_vertical_layer_dimension_for_radiation	number of vertical layers for radiation	count	integer	()		in
nlp1	adjusted_vertical_level_dimension_for_radiation	number of vertical levels for radiation	count	integer	()		in
lprnt	flag_print	flag to print	flag	logical	()		in
cld_cf	total_cloud_fraction	total cloud fraction	frac	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
lslwr	flag_for_calling_longwave_radiation	flag to calculate LW irradiances	flag	logical	()		in
top_at_1	flag_for_vertical_ordering_in_radiation	flag for vertical ordering in radiation	flag	logical	()		in
iovr	flag_for_cloud_overlap_method_for_radiation	flag for 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
iovr_max	flag_for_maximum_cloud_overlap_method	choice of maximum cloud overlap method	flag	integer	()		in
iovr_rand	flag_for_random_cloud_overlap_method	choice of random cloud overlap method	flag	integer	()		in
iovr_maxrand	flag_for_maximum_random_cloud_overlap_method	choice of maximum-random 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
inc_minor_gas	flag_to_include_minor_gases_in_rrtmg	flag to include minor trace gases in rrtmg	flag	logical	()		in
ilwcliq	flag_for_optical_property_for_liquid_clouds_for_longwave_radiation	lw optical property for liquid clouds	flag	integer	()		in
ilwcice	flag_for_optical_property_for_ice_clouds_for_longwave_radiation	lw optical property for ice clouds	flag	integer	()		in
isubclw	flag_for_lw_clouds_sub_grid_approximation	flag for lw clouds sub-grid approximation	flag	integer	()		in
hlwc	tendency_of_air_temperature_due_to_longwave_heating_on_radiation_time_step_and_radiation_levels	longwave total sky heating rate	K s-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	inout
topflx	lw_fluxes_top_atmosphere	longwave total sky fluxes at the top of the atm	W m-2	topflw_type	(ccpp_constant_one:horizontal_loop_extent)	topflw_type	inout
sfcflx	surface_lw_fluxes_assuming_total_and_clear_sky_on_radiation_timestep	longwave total sky fluxes at the Earth surface	W m-2	sfcflw_type	(ccpp_constant_one:horizontal_loop_extent)	sfcflw_type	inout
cldtau	cloud_optical_depth_layers_at_10mu_band	approx 10mu band layer cloud optical depth	none	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	inout
hlw0	tendency_of_air_temperature_due_to_longwave_heating_assuming_clear_sky_on_radiation_time_step_and_radiation_levels	longwave clear sky heating rate	K s-1	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	inout
cld_lwp	cloud_liquid_water_path	cloud liquid water path	g m-2	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
cld_ref_liq	mean_effective_radius_for_liquid_cloud	mean effective radius for liquid cloud	um	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
cld_iwp	cloud_ice_water_path	cloud ice water path	g m-2	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
cld_ref_ice	mean_effective_radius_for_ice_cloud	mean effective radius for ice cloud	um	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
cld_rwp	cloud_rain_water_path	cloud ice water path	g m-2	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
cld_ref_rain	mean_effective_radius_for_rain_drop	mean effective radius for rain drop	um	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
cld_swp	cloud_snow_water_path	cloud snow water path	g m-2	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	in
cld_ref_snow	mean_effective_radius_for_snow_flake	mean effective radius for snow flake	um	real	(ccpp_constant_one:horizontal_loop_extent, ccpp_constant_one:adjusted_vertical_layer_dimension_for_radiation)	kind_phys	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

RRTMG Longwave Radiation Scheme General Algorithm