CCPP Scientific Documentation
v4.0
GFS RRTMG Longwave Module

This module includes NCEP's modifications of the RRTMG-LW radiation code from AER. More...

Detailed Description

The RRTM-LW package includes three files:

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

Argument Table

rrtmg_lw_run argument table
local_namestandard_namelong_nameunitstypedimensionskindintentoptional
plyrair_pressure_at_layer_for_radiation_in_hPaair pressure layerhPareal(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
plvlair_pressure_at_interface_for_radiation_in_hPaair pressure levelhPareal(horizontal_dimension, adjusted_vertical_level_dimension_for_radiation)kind_physinFalse
tlyrair_temperature_at_layer_for_radiationair temperature layerKreal(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
tlvlair_temperature_at_interface_for_radiationair temperature levelKreal(horizontal_dimension, adjusted_vertical_level_dimension_for_radiation)kind_physinFalse
qlyrwater_vapor_specific_humidity_at_layer_for_radiationspecific humidity layerkg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
olyrozone_concentration_at_layer_for_radiationozone concentration layerkg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_co2volume_mixing_ratio_co2volume mixing ratio co2kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_n2ovolume_mixing_ratio_n2ovolume mixing ratio no2kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_ch4volume_mixing_ratio_ch4volume mixing ratio ch4kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_o2volume_mixing_ratio_o2volume mixing ratio o2kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_covolume_mixing_ratio_covolume mixing ratio cokg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_cfc11volume_mixing_ratio_cfc11volume mixing ratio cfc11kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_cfc12volume_mixing_ratio_cfc12volume mixing ratio cfc12kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_cfc22volume_mixing_ratio_cfc22volume mixing ratio cfc22kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
gasvmr_ccl4volume_mixing_ratio_ccl4volume mixing ratio ccl4kg kg-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
icseedseed_random_numbers_lwseed for random number generation for longwave radiationnoneinteger(horizontal_dimension)inFalse
aeraodaerosol_optical_depth_for_longwave_bands_01_16aerosol optical depth for longwave bands 01-16nonereal(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation, number_of_aerosol_bands_for_longwave_radiation)kind_physinFalse
aerssaaerosol_single_scattering_albedo_for_longwave_bands_01_16aerosol single scattering albedo for longwave bands 01-16fracreal(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation, number_of_aerosol_bands_for_longwave_radiation)kind_physinFalse
sfemissurface_longwave_emissivitysurface emissivityfracreal(horizontal_dimension)kind_physinFalse
sfgtmpsurface_ground_temperature_for_radiationsurface ground temperature for radiationKreal(horizontal_dimension)kind_physinFalse
dzlyrlayer_thickness_for_radiationlayer thicknesskmreal(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
delpinlayer_pressure_thickness_for_radiationlayer pressure thicknesshPareal(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinFalse
de_lgthcloud_decorrelation_lengthcloud decorrelation lengthkmreal(horizontal_dimension)kind_physinFalse
nptshorizontal_loop_extenthorizontal dimensioncountinteger()inFalse
nlayadjusted_vertical_layer_dimension_for_radiationnumber of vertical layers for radiationcountinteger()inFalse
nlp1adjusted_vertical_level_dimension_for_radiationnumber of vertical levels for radiationcountinteger()inFalse
lprntflag_printflag to printflaglogical()inFalse
cld_cftotal_cloud_fractiontotal cloud fractionfracreal(horizontal_dimension, vertical_dimension)kind_physinFalse
lslwrflag_to_calc_lwflag to calculate LW irradiancesflaglogical()inFalse
hlwctendency_of_air_temperature_due_to_longwave_heating_on_radiation_time_steplongwave total sky heating rateK s-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinoutFalse
topflxlw_fluxes_top_atmospherelongwave total sky fluxes at the top of the atmW m-2topflw_type(horizontal_dimension)inoutFalse
sfcflxlw_fluxes_sfclongwave total sky fluxes at the Earth surfaceW m-2sfcflw_type(horizontal_dimension)inoutFalse
cldtaucloud_optical_depth_layers_at_10mu_bandapprox 10mu band layer cloud optical depthnonereal(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinoutFalse
hlw0tendency_of_air_temperature_due_to_longwave_heating_assuming_clear_sky_on_radiation_time_steplongwave clear sky heating rateK s-1real(horizontal_dimension, adjusted_vertical_layer_dimension_for_radiation)kind_physinoutTrue
cld_lwpcloud_liquid_water_pathcloud liquid water pathg m-2real(horizontal_dimension, vertical_dimension)kind_physinTrue
cld_ref_liqmean_effective_radius_for_liquid_cloudmean effective radius for liquid cloudmicronreal(horizontal_dimension, vertical_dimension)kind_physinTrue
cld_iwpcloud_ice_water_pathcloud ice water pathg m-2real(horizontal_dimension, vertical_dimension)kind_physinTrue
cld_ref_icemean_effective_radius_for_ice_cloudmean effective radius for ice cloudmicronreal(horizontal_dimension, vertical_dimension)kind_physinTrue
cld_rwpcloud_rain_water_pathcloud ice water pathg m-2real(horizontal_dimension, vertical_dimension)kind_physinTrue
cld_ref_rainmean_effective_radius_for_rain_dropmean effective radius for rain dropmicronreal(horizontal_dimension, vertical_dimension)kind_physinTrue
cld_swpcloud_snow_water_pathcloud snow water pathg m-2real(horizontal_dimension, vertical_dimension)kind_physinTrue
cld_ref_snowmean_effective_radius_for_snow_flakemean effective radius for snow flakemicronreal(horizontal_dimension, vertical_dimension)kind_physinTrue
errmsgccpp_error_messageerror message for error handling in CCPPnonecharacter()len=*outFalse
errflgccpp_error_flagerror flag for error handling in CCPPflaginteger()outFalse

RRTMG Longwave Radiation Scheme General Algorithm

Modules

module  module_radlw_parameters
 This module contains LW band parameters set up.
 
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-250 cm-1 (low - h2o; high - h2o)
 
module  module_radlw_kgb02
 This module sets up absorption coefficients for band 02: 250-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 - /)
 

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, npts, nlay, nlp1, lprnt, cld_cf, lslwr, 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 taugb02
 Band 2: 350-500 cm-1 (low key - h2o; high key - h2o) More...
 
subroutine taugb03
 Band 3: 500-630 cm-1 (low key - h2o,co2; low minor - n2o); (high key - h2o,co2; high minor - n2o) More...
 
subroutine taugb04
 Band 4: 630-700 cm-1 (low key - h2o,co2; high key - o3,co2) More...
 
subroutine taugb05
 Band 5: 700-820 cm-1 (low key - h2o,co2; low minor - o3, ccl4) (high key - o3,co2) More...
 
subroutine taugb06
 Band 6: 820-980 cm-1 (low key - h2o; low minor - co2) (high key - none; high minor - cfc11, cfc12) More...
 
subroutine taugb07
 Band 7: 980-1080 cm-1 (low key - h2o,o3; low minor - co2) (high key - o3; high minor - co2) More...
 
subroutine taugb08
 Band 8: 1080-1180 cm-1 (low key - h2o; low minor - co2,o3,n2o) (high key - o3; high minor - co2, n2o) More...
 
subroutine taugb09
 Band 9: 1180-1390 cm-1 (low key - h2o,ch4; low minor - n2o) (high key - ch4; high minor - n2o) More...
 
subroutine taugb10
 Band 10: 1390-1480 cm-1 (low key - h2o; high key - h2o) More...
 
subroutine taugb11
 Band 11: 1480-1800 cm-1 (low - h2o; low minor - o2) (high key - h2o; high minor - o2) More...
 
subroutine taugb12
 Band 12: 1800-2080 cm-1 (low - h2o,co2; high - nothing) More...
 
subroutine taugb13
 Band 13: 2080-2250 cm-1 (low key-h2o,n2o; high minor-o3 minor) More...
 
subroutine taugb14
 Band 14: 2250-2380 cm-1 (low - co2; high - co2) More...
 
subroutine taugb15
 Band 15: 2380-2600 cm-1 (low - n2o,co2; low minor - n2) (high - nothing) More...
 
subroutine taugb16
 Band 16: 2600-3250 cm-1 (low key- h2o,ch4; high key - ch4) More...
 
subroutine, public rrtmg_lw::rlwinit (me)
 This subroutine performs calculations necessary for the initialization of the longwave model, which includes non-varying model variables, conversion factors, and look-up tables. More...
 
subroutine rrtmg_lw::cldprop (cfrac, cliqp, reliq, cicep, reice, cdat1, cdat2, cdat3, cdat4, nlay, nlp1, ipseed, dz, de_lgth, cldfmc, taucld )
 This subroutine computes the cloud optical depth(s) for each cloudy layer and g-point interval. More...
 
subroutine rrtmg_lw::mcica_subcol (cldf, nlay, ipseed, dz, de_lgth, lcloudy )
 This suroutine computes sub-colum cloud profile flag array. More...
 
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. More...
 
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. More...
 
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. More...
 
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. More...
 
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. More...
 
subroutine taugb01
 band 1: 10-350 cm-1 (low key - h2o; low minor - n2); (high key - h2o; high minor - n2) More...