 |
CCPP Scientific Documentation
v5.0.0
|
|
|
CCPP Scientific Documentation
v5.0.0
|
|
The subroutine contains the main driver for Chikira-Sugiyama convective scheme. More...
History:
Arakawa-Wu implemtation: for background, consult An Introduction to the General Circulation of the Atmosphere, Randall, chapter six. Traditional parameterizations compute tendencies like those in eq 103, 105 and 106. Because Arakawa-Wu applies different functions to different components to the terms within these equations, it requires the terms used in alternate eqns 91 - 93. The code required to compute these terms is added within, and the appropriate functions of updraft area fraction (sigma) are applied. Thus, AW requires three steps:
application of functions of sigma to the alternative tendency terms here, and in gbphys to the large-scale microphysics tendencies.
The bulk of AW is implemented within subroutine CS_CUMLUS(), and the routines it calls.
JLS NOTE: The convective mass fluxes (dt_mf, dd_mf and ud_mf) passed in and out of cs_conv have not been multiplied by the timestep (kg/m2/sec) as they are in all other convective schemes. EMC is aware of this problem, and in the future will be fixing this discrepancy. In the meantime, CCPP will use the same mass flux standard_name and long_name as the other convective schemes, where the units are in kg/m2. (Aug 2018)
| local_name | standard_name | long_name | units | type | dimensions | kind | intent | optional |
|---|---|---|---|---|---|---|---|---|
| ijsdim | horizontal_loop_extent | horizontal loop extent | count | integer | () | in | False | |
| kmax | vertical_dimension | number of veritcal levels | count | integer | () | in | False | |
| ntracp1 | number_of_tracers_plus_one | number of tracers plus one | count | integer | () | in | False | |
| nn | number_of_tracers_for_convective_transport | number of tracers for convective transport (used to dimension clw) | count | integer | () | in | False | |
| ntr | number_of_tracers_for_CS | number of convectively transported tracers in Chikira-Sugiyama deep conv. scheme | count | integer | () | in | False | |
| nctp | number_of_cloud_types_CS | number of cloud types in Chikira-Sugiyama scheme | count | integer | () | in | False | |
| otspt | flag_convective_tracer_transport | flag to enable tracer transport by updrafts/downdrafts[(:,1)] or subsidence [(:,2)] | flag | logical | (number_of_tracers_plus_one, 2) | in | False | |
| lat | latitude_index_in_debug_printouts | latitude index in debug printouts | index | integer | () | in | False | |
| kdt | index_of_time_step | current forecast iteration | index | integer | () | in | False | |
| t | air_temperature_updated_by_physics | mid-layer temperature | K | real | (horizontal_dimension, vertical_dimension) | kind_phys | inout | False |
| q | water_vapor_specific_humidity_updated_by_physics | mid-layer specific humidity of water vapor | kg kg-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | inout | False |
| rain1 | lwe_thickness_of_deep_convective_precipitation_amount | deep convective rainfall amount on physics timestep | m | real | (horizontal_dimension) | kind_phys | out | False |
| clw | convective_transportable_tracers | array to contain cloud water and other convective trans. tracers | kg kg-1 | real | (horizontal_dimension, vertical_dimension, number_of_tracers_for_convective_transport) | kind_phys | inout | False |
| zm | geopotential | mid-layer geopotential | m2 s-2 | real | (horizontal_dimension, vertical_dimension) | kind_phys | in | False |
| zi | geopotential_at_interface | interface geopotential | m2 s-2 | real | (horizontal_dimension, vertical_dimension_plus_one) | kind_phys | in | False |
| pap | air_pressure | mid-layer pressure | Pa | real | (horizontal_dimension, vertical_dimension) | kind_phys | in | False |
| paph | air_pressure_at_interface | interface pressure | Pa | real | (horizontal_dimension, vertical_dimension_plus_one) | kind_phys | in | False |
| delta | time_step_for_physics | physics time step | s | real | () | kind_phys | in | False |
| delti | time_step_for_dynamics | dynamics time step | s | real | () | kind_phys | in | False |
| ud_mf | instantaneous_atmosphere_updraft_convective_mass_flux | (updraft mass flux) * delt | kg m-2 | real | (horizontal_dimension, vertical_dimension) | kind_phys | inout | False |
| dd_mf | instantaneous_atmosphere_downdraft_convective_mass_flux | (downdraft mass flux) * delt | kg m-2 | real | (horizontal_dimension, vertical_dimension) | kind_phys | inout | False |
| dt_mf | instantaneous_atmosphere_detrainment_convective_mass_flux | (detrainment mass flux) * delt | kg m-2 | real | (horizontal_dimension, vertical_dimension) | kind_phys | inout | False |
| u | x_wind_updated_by_physics | mid-layer zonal wind | m s-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | inout | False |
| v | y_wind_updated_by_physics | mid-layer meridional wind | m s-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | inout | False |
| fscav | fraction_of_tracer_scavenged | fraction of the tracer (aerosols) that is scavenged by convection | km-1 | real | (number_of_tracers_scavenged) | kind_phys | in | False |
| fswtr | fraction_of_cloud_top_water_scavenged | fraction of the tracer (cloud top water) that is scavenged by convection | km-1 | real | (number_of_tracers_scavenged) | kind_phys | in | False |
| cbmfx | cloud_base_mass_flux | cloud base mass flux | kg m-2 s-1 | real | (horizontal_dimension, number_of_cloud_types_CS) | kind_phys | inout | False |
| mype | mpi_rank | current MPI rank | index | integer | () | in | False | |
| wcbmaxm | maximum_updraft_velocity_at_cloud_base | maximum updraft velocity at cloud base | m s-1 | real | (horizontal_dimension) | kind_phys | in | False |
| precz0in | detrainment_and_precipitation_tunable_parameter_3_CS | partition water between detrainment and precipitation (decrease for more precipitation) | m | real | () | kind_phys | in | False |
| preczhin | detrainment_and_precipitation_tunable_parameter_4_CS | partition water between detrainment and precipitation (decrease for more precipitation) | m | real | () | kind_phys | in | False |
| clmdin | entrainment_efficiency_tunable_parameter_9_CS | entrainment efficiency | none | real | () | kind_phys | in | False |
| sigma | convective_updraft_area_fraction_at_model_interfaces | convective updraft area fraction at model interfaces | frac | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| do_aw | flag_for_Arakawa_Wu_adjustment | flag for Arakawa Wu scale-aware adjustment | flag | logical | () | in | False | |
| do_awdd | flag_arakawa_wu_downdraft | flag to enable treating convective tendencies following Arakwaw-Wu for downdrafts (2013) | flag | logical | () | in | False | |
| flx_form | flag_flux_form_CS | flag to enable using the flux form of the equations in CS scheme | flag | logical | () | in | False | |
| lprnt | flag_print | control flag for diagnostic print out | flag | logical | () | in | False | |
| ipr | horizontal_index_of_printed_column | horizontal index of printed column | index | integer | () | in | False | |
| kcnv | flag_deep_convection | flag indicating whether convection occurs in column | flag | integer | (horizontal_dimension) | inout | False | |
| qlcn | mass_fraction_of_convective_cloud_liquid_water | mass fraction of convective cloud liquid water | kg kg-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| qicn | mass_fraction_of_convective_cloud_ice | mass fraction of convective cloud ice water | kg kg-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| w_upi | vertical_velocity_for_updraft | vertical velocity for updraft | m s-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| cf_upi | convective_cloud_fraction_for_microphysics | convective cloud fraction for microphysics | frac | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| cnv_mfd | detrained_mass_flux | detrained mass flux | kg m-2 s-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| cnv_dqldt | tendency_of_cloud_water_due_to_convective_microphysics | tendency of cloud water due to convective microphysics | kg m-2 s-1 | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| clcn | convective_cloud_volume_fraction | convective cloud volume fraction | frac | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| cnv_fice | ice_fraction_in_convective_tower | ice fraction in convective tower | frac | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| cnv_ndrop | number_concentration_of_cloud_liquid_water_particles_for_detrainment | droplet number concentration in convective detrainment | m-3 | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| cnv_nice | number_concentration_of_ice_crystals_for_detrainment | crystal number concentration in convective detrainment | m-3 | real | (horizontal_dimension, vertical_dimension) | kind_phys | out | False |
| mp_phys | flag_for_microphysics_scheme | flag for microphysics scheme | flag | integer | () | in | False | |
| errmsg | ccpp_error_message | error message for error handling in CCPP | none | character | () | len=* | out | False |
| errflg | ccpp_error_flag | error flag for error handling in CCPP | flag | integer | () | out | False |
Functions/Subroutines | |
| subroutine, public | cs_conv_aw_adj::cs_conv_aw_adj_run (im, levs, do_cscnv, do_aw, do_shoc, ntrac, ncld, ntcw, ntclamt, nncl, con_g, sigmafrac, gt0, gq0, save_t, save_q, prsi, cldfrac, subcldfrac, prcp, imp_physics, imp_physics_mg, errmsg, errflg) |
| This subroutine adjusts surface rainrate for conservation. More... | |
| subroutine, public | cs_conv::cs_conv_run ( IJSDIM, KMAX , ntracp1, NN, NTR , nctp , otspt, lat , kdt , t , q , rain1 , clw , zm , zi , pap , paph , delta, delti, ud_mf , dd_mf , dt_mf, u , v , fscav , fswtr, cbmfx, mype , wcbmaxm, precz0in, preczhin, clmdin, sigma, do_aw , do_awdd, flx_form, lprnt, ipr, kcnv, QLCN, QICN, w_upi, cf_upi, CNV_MFD, CNV_DQLDT, CLCN, CNV_FICE, CNV_NDROP, CNV_NICE, mp_phys, errmsg, errflg) |
| subroutine | cs_conv::cumbas (IJSDIM, KMAX, KB , GCYM, KBMX, ntr , ntrq, GCHB, GCWB, GCUB, GCVB, GCIB, gctrb, GDH , GDW , GDHS, GDQS, GDQI, GDU , GDV , GDZM, GDPM, FDQS, GAM , lprnt, ipr, ISTS, IENS, gctbl, gcqbl, gdq, gcwbl, gcqlbl, gcqibl, gctrbl ) |
| This subroutine calculates cloud base properties. More... | |
| subroutine | cs_conv::cumup (IJSDIM, KMAX , NTR , ntrq , ACWF , GCLZ , GCIZ , GPRCIZ, GSNWIZ, GCYT , GCHT , GCQT , GCLT , GCIT , GTPRT, GCUT , GCVT , gctrt, KT , KTMX , GCYM , wcv , GCHB , GCWB , GCUB , GCVB , GCIB , gctrb, GDU , GDV , GDH , GDW , GDHS , GDQS , GDT , GDTM , GDQ , GDQI , GDZ , GDZM , GDPM , FDQS , GAM , GDZTR, CPRES, WCB , |
| This subroutine calculates in-cloud properties. More... | |
| subroutine | cs_conv::cumbmx (IJSDIM, KMAX, CBMFX, ACWF, GCYT, GDZM, GDW , GDQS, DELP, KT , KTMX, KB , DELT, ISTS, IENS ) |
| This subroutine computes cloud base mass flux. More... | |
| subroutine | cs_conv::cumflx (IM , IJSDIM, KMAX, GMFLX, GPRCI, GSNWI, CMDET, QLIQ, QICE, GTPRC0, CBMFX, GCYM, GPRCIZ, GSNWIZ, GTPRT, GCLZ, GCIZ, GCYT, KB , KT , KTMX, ISTS, IENS ) |
| This subroutine computes cloud mass flux & precip. More... | |
| subroutine | cs_conv::cumdet (im , IJSDIM, KMAX , NTR , ntrq , GTT , GTQ , GTU , GTV , GDH , GDQ , GDU , GDV , |
| This subroutine calculates cloud detrainment heating. More... | |
| subroutine | cs_conv::cumsbh (IM , IJSDIM, KMAX, NTR, ntrq, GTT , GTQ , GTU , GTV , GDH , GDQ , GDQI, GDU , GDV , DELPI, GMFLX, GMFX0, KTMX, CPRES, KB, ISTS, IENS) |
| subroutine | cs_conv::cumsbw (IM , IJSDIM, KMAX, GTU , GTV , GDU , GDV , DELPI, GMFLX, GMFX0, KTMX, CPRES, KB, ISTS, IENS) |
| This subroutine calculate cloud subsidence heating. More... | |
| subroutine | cs_conv::cumdwn (IM , IJSDIM, KMAX, NTR , ntrq, GTT , GTQ , GTU , GTV , GMFLX, GPRCP, GSNWP, GTEVP, GMDD, GPRCI, GSNWI, GDH , GDW , GDQ , GDQI, GDQS, GDS , GDHS, GDT , GDU , GDV , GDZ , GDZM, FDQS, DELP, DELPI, sigmad, do_aw, do_awdd, flx_form, gtmelt, gtevap, gtsubl, dtdwn, dqvdwn, dqldwn, dqidwn, dtrdwn, KB , KTMX, ISTS, IENS ) |
| This subroution calculates freeze, melt and evaporation in cumulus downdraft. More... | |
| subroutine | cs_conv::cumcld (IJSDIM, KMAX, CUMCLW, QLIQ, QICE, FLIQC, CUMFRC, GMFLX, KTMX, ISTS, IENS ) |
| This subroutine computes cumulus cloudiness. More... | |
| subroutine | cs_conv::cumupr (im , IJSDIM, KMAX, NTR , GTR , GPRCC, GDR , CBMFX, GCYM, GCYT, GCQT, GCLT, GCIT, GTPRT, GTEVP, GTPRC0, KB , KBMX, KT , KTMX, KTMXT, DELPI, OTSPT, ISTS, IENS, fscav, fswtr, nctp) |
| This subroutine calculates. More... | |
| subroutine | cs_conv::cumdnr (IM , IJSDIM, KMAX, NTR , GTR , GDR , GMDD, DELPI, KTMX, OTSPT, ISTS, IENS) |
| subroutine | cs_conv::cumsbr (IM , IJSDIM, KMAX, NTR , GTR , GDR , DELPI, GMFLX, KTMX, OTSPT, ISTS, IENS) |
| subroutine | cs_conv::cumfxr (IM , IJSDIM, KMAX, NTR , GTR , GDR , DELP, DELTA, KTMX, IMFXR, ISTS, IENS ) |
| This subroutine calculates tracer mass fixer without detrainment. More... | |
| subroutine | cs_conv::cumfxr1 (IM , IJSDIM, KMAX, GTR , GDR , DELP, DELTA, KTMX, IMFXR, ISTS, IENS ) |
| subroutine | cs_conv::cumchk (IJSDIM, KMAX, NTR , GTT , GTQ , GTU , GTV , GTCFRC, GPRCC, GSNWC, CUMCLW, CUMFRC, FLIQC, GTPRP, ISTS, IENS ) |
| subroutine | cs_conv::cs_cumlus (im , IJSDIM, KMAX, NTR , otspt1, otspt2, lprnt, ipr , GTT , GTQ , GTU , GTV , CMDET, GTPRP, GSNWP, GMFX0, GMFX1, CAPE, KT , CBMFX, GDT , GDQ , GDU , GDV , GDTM, GDP , GDPM, GDZ , GDZM, delp, delpi, DELTA, DELTI, ISTS, IENS, mype, fscav, fswtr, wcbmaxm, nctp, sigma, vverti, do_aw, do_awdd, flx_form) |
| Main subroutine for the cumulus parameterization with state-dependent entrainment rate developed by Minoru Chikira. More... | |
1.8.11