Common Community Physics Package (CCPP) Scientific Documentation  Version 2.0
GFS radlw Main

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

local_name standard_name long_name units rank type kind intent optional
plyr air_pressure_at_layer_for_radiation_in_hPa air pressure layer hPa 2 real kind_phys in F
plvl air_pressure_at_interface_for_radiation_in_hPa air pressure level hPa 2 real kind_phys in F
tlyr air_temperature_at_layer_for_radiation air temperature layer K 2 real kind_phys in F
tlvl air_temperature_at_interface_for_radiation air temperature level K 2 real kind_phys in F
qlyr water_vapor_specific_humidity_at_layer_for_radiation specific humidity layer kg kg-1 2 real kind_phys in F
olyr ozone_concentration_at_layer_for_radiation ozone concentration layer kg kg-1 2 real kind_phys in F
gasvmr_co2 volume_mixing_ratio_co2 volume mixing ratio co2 kg kg-1 2 real kind_phys in F
gasvmr_n2o volume_mixing_ratio_n2o volume mixing ratio no2 kg kg-1 2 real kind_phys in F
gasvmr_ch4 volume_mixing_ratio_ch4 volume mixing ratio ch4 kg kg-1 2 real kind_phys in F
gasvmr_o2 volume_mixing_ratio_o2 volume mixing ratio o2 kg kg-1 2 real kind_phys in F
gasvmr_co volume_mixing_ratio_co volume mixing ratio co kg kg-1 2 real kind_phys in F
gasvmr_cfc11 volume_mixing_ratio_cfc11 volume mixing ratio cfc11 kg kg-1 2 real kind_phys in F
gasvmr_cfc12 volume_mixing_ratio_cfc12 volume mixing ratio cfc12 kg kg-1 2 real kind_phys in F
gasvmr_cfc22 volume_mixing_ratio_cfc22 volume mixing ratio cfc22 kg kg-1 2 real kind_phys in F
gasvmr_ccl4 volume_mixing_ratio_ccl4 volume mixing ratio ccl4 kg kg-1 2 real kind_phys in F
icseed seed_random_numbers_lw seed for random number generation for longwave radiation none 1 integer in F
aeraod aerosol_optical_depth_for_longwave_bands_01-16 aerosol optical depth for longwave bands 01-16 none 3 real kind_phys in F
aerssa aerosol_single_scattering_albedo_for_longwave_bands_01-16 aerosol single scattering albedo for longwave bands 01-16 frac 3 real kind_phys in F
sfemis surface_longwave_emissivity surface emissivity frac 1 real kind_phys in F
sfgtmp surface_ground_temperature_for_radiation surface ground temperature for radiation K 1 real kind_phys in F
npts horizontal_loop_extent horizontal dimension count 0 integer in F
nlay adjusted_vertical_layer_dimension_for_radiation number of vertical layers for radiation count 0 integer in F
nlp1 adjusted_vertical_level_dimension_for_radiation number of vertical levels for radiation count 0 integer in F
lprnt flag_print flag to print flag 0 logical in F
cld_cf total_cloud_fraction total cloud fraction frac 2 real kind_phys in F
lslwr flag_to_calc_lw flag to calculate LW irradiances flag 0 logical in F
hlwc tendency_of_air_temperature_due_to_longwave_heating_on_radiation_time_step longwave total sky heating rate K s-1 2 real kind_phys inout F
topflx lw_fluxes_top_atmosphere longwave total sky fluxes at the top of the atm W m-2 1 topflw_type inout F
sfcflx lw_fluxes_sfc longwave total sky fluxes at the Earth surface W m-2 1 sfcflw_type inout F
hlw0 tendency_of_air_temperature_due_to_longwave_heating_assuming_clear_sky_on_radiation_time_step longwave clear sky heating rate K s-1 2 real kind_phys inout T
hlwb lw_heating_rate_spectral longwave total sky heating rate (spectral) K s-1 3 real kind_phys inout T
flxprf lw_fluxes lw fluxes total sky / csk and up / down at levels W m-2 2 proflw_type inout T
cld_lwp cloud_liquid_water_path cloud liquid water path g m-2 2 real kind_phys in T
cld_ref_liq mean_effective_radius_for_liquid_cloud mean effective radius for liquid cloud micron 2 real kind_phys in T
cld_iwp cloud_ice_water_path cloud ice water path g m-2 2 real kind_phys in T
cld_ref_ice mean_effective_radius_for_ice_cloud mean effective radius for ice cloud micron 2 real kind_phys in T
cld_rwp cloud_rain_water_path cloud ice water path g m-2 2 real kind_phys in T
cld_ref_rain mean_effective_radius_for_rain_drop mean effective radius for rain drop micron 2 real kind_phys in T
cld_swp cloud_snow_water_path cloud snow water path g m-2 2 real kind_phys in T
cld_ref_snow mean_effective_radius_for_snow_flake mean effective radius for snow flake micron 2 real kind_phys in T
cld_od_total cloud_optical_depth_weighted cloud optical depth, weighted none 2 real kind_phys in T
cld_od_layer cloud_optical_depth_layers_678 cloud optical depth, from bands 6,7,8 none 2 real kind_phys out T
cld_od cloud_optical_depth cloud optical depth none 2 real kind_phys in T
errmsg ccpp_error_message error message for error handling in CCPP none 0 character len=* out F
errflg ccpp_error_flag error flag for error handling in CCPP flag 0 integer out F

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, npts, nlay, nlp1, lprnt, cld_cf, lslwr, hlwc, topflx, sfcflx, 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_total, cld_od_layer, 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, 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, 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...