atm_phys/old_doc/lscale_cond.html

672ec4d5cf Jean*0001 <HTML>
                0002 <TITLE>module lscale_cond</TITLE>
                0003 <BODY BGCOLOR="#AABBCC" TEXT="#332211" >
                0004
                0005 <DIV ALIGN="CENTER"> <FONT SIZE=1>
                0006 <A HREF="#INTERFACE">PUBLIC INTERFACE</A> /
                0007 <A HREF="#ROUTINES">ROUTINES</A> /
                0008 <A HREF="#NAMELIST">NAMELIST</A> /
                0009 <A HREF="#CHANGES">CHANGES</A> /
                0010 <A HREF="#ERRORS">ERRORS</A> /
                0011 <A HREF="#REFERENCES">REFERENCES</A> /
                0012 <A HREF="#NOTES">NOTES</A>
                0013 </FONT>
                0014 <BR><BR></DIV><HR>
                0015
                0016
                0017 <H2>module lscale_cond</H2>
                0018 <A NAME="HEADER">
                0019 <PRE>
                0020      <B>Contact:</B>
                0021      <B>Reviewers:</B>
                0022
                0023      <B><A HREF=".doc.log#lscale_cond.f90">Tags/Status</A></B>
                0024 </PRE>
                0025 </A><!-- END HEADER -->
                0026 <!--------------------------------------------------------------------->
                0027 <A NAME="OVERVIEW">
                0028 <HR>
                0029 <H4>OVERVIEW</H4>
                0030 <!-- BEGIN OVERVIEW -->
                0031 <PRE>
                0032
                0033     Computes large-scale condensation and precipitation.
                0034
                0035     Temperature and specific humidity adjustments are computed in model layers
                0036     where the relative humidity exceeds a threshold relative humidity.
                0037
                0038 </PRE>
                0039 </A><!-- END OVERVIEW -->
                0040 <!--------------------------------------------------------------------->
                0041 <A NAME="DESCRIPTION">
                0042 <!-- BEGIN DESCRIPTION -->
                0043 <PRE>
                0044
                0045    The features include:
                0046
                0047     1) option for the re-evaporation of falling precipitation
                0048     2) energetically consistent adjustment with precipitation type
                0049
                0050     Reference: Manabe, S., (1969). Mon. Wea. Rev. 97, 739-798.
                0051
                0052 </PRE>
                0053 </A><!-- END DESCRIPTION -->
                0054 <!--------------------------------------------------------------------->
                0055 <A NAME="MODULES_USED">
                0056 <HR>
                0057 <H4>OTHER MODULES USED</H4>
                0058 <!-- BEGIN MODULES_USED -->
                0059 <PRE>
                0060
                0061     sat_vapor_pres_mod
                0062          utilities_mod
                0063          constants_mod
                0064
                0065 </PRE>
                0066 </A><!-- END MODULES_USED -->
                0067 <!--------------------------------------------------------------------->
                0068 <A NAME="INTERFACE">
                0069 <HR>
                0070 <H4>PUBLIC INTERFACE</H4>
                0071 <!-- BEGIN INTERFACE -->
                0072 <PRE>
                0073
                0074 use lscale_cond_mod [, only: lscale_cond_init, lscale_cond ]
                0075
                0076    lscale_cond_init:  Must be called before lscale_cond to initialize
                0077                       the module, namelist, and constants.
                0078
                0079    lscale_cond:  Computes the large-scale condensation adjustments for
                0080                  temperature and specific humidity, and returns the
                0081                  mass of rain and snow that reach the ground (in an
                0082                  energetically consistent way).
                0083
                0084 </PRE>
                0085 </A><!-- END INTERFACE -->
                0086 <!--------------------------------------------------------------------->
                0087 <A NAME="ROUTINES">
                0088 <HR>
                0089 <H4>PUBLIC ROUTINES</H4>
                0090 <!-- BEGIN ROUTINES -->
                0091 <PRE>
                0092
                0093 <b>call lscale_cond_init</b> ( )
                0094
                0095    There are no arguments.
                0096
                0097 ----------------------------------------------------
                0098
                0099 <b>call lscale_cond</b> ( tin, qin, pfull, phalf, coldt,
                0100                    rain, snow, tdel, qdel, mask, conv )
                0101
                0102   Input
                0103
                0104      tin      temperature (deg k) at full model levels
                0105                  [real, dimension(:,:,nlev)]
                0106
                0107      qin      specific humidity of water vapor at full model levels
                0108                  [real, dimension(:,:,nlev)]
                0109
                0110      pfull    pressure (pascals) at full model levels
                0111                  [real, dimension(:,:,nlev)]
                0112
                0113      phalf    pressure (pascals) at half (interface) model levels
                0114                  [real, dimension(:,:,nlev+1)]
                0115
                0116      coldt    should precipitation be snow at this point?
                0117                  [logical, dimension(:,:)]
                0118
                0119   Input (optional)
                0120
                0121      mask     optional mask (0 or 1.)
                0122                  [real, dimension(:,:,nlev)]
                0123
                0124      conv     logical flag; if true then no large-scale adjustment
                0125               is performed at that grid-point's level
                0126                  [real, dimension(:,:,nlev)]
                0127
                0128   Output
                0129
                0130      rain     liquid precipitation (kg/m2)
                0131                  [real, dimension(:,:)]
                0132
                0133      snow     frozen precipitation (kg/m2)
                0134                  [real, dimension(:,:)]
                0135
                0136      tdel     temperature tendency at full model levels
                0137                  [real, dimension(:,:,nlev)]
                0138
                0139      qdel     specific humidity tendency (of water vapor) at
                0140                 full model levels
                0141                  [real, dimension(:,:,nlev)]
                0142
                0143 </PRE>
                0144 </A><!-- END ROUTINES -->
                0145 <!--------------------------------------------------------------------->
                0146 <A NAME="NAMELIST">
                0147 <HR>
                0148 <H4>NAMELIST</H4>
                0149 <!-- BEGIN NAMELIST -->
                0150 <PRE>
                0151
                0152 <b>&lscale_cond_nml</b>
                0153
                0154    hc         relative humidity at which large scale condensation
                0155               occurs, where 0 <= hc <= 1
                0156                  [real, default: hc=1.]
                0157
                0158    do_evap    flag for the re-evaporation of moisture in
                0159               sub-saturated layers below, if do_evap=.true. then
                0160               re-evaporation is performed
                0161                  [logical, default: do_evap=.false.]
                0162
                0163 </PRE>
                0164 </A><!-- END NAMELIST -->
                0165 <!--------------------------------------------------------------------->
                0166 <A NAME="CHANGES">
                0167 <HR>
                0168 <H4>CHANGE HISTORY</H4>
                0169 <!-- BEGIN CHANGES -->
                0170 <PRE>
                0171 <B><A HREF=".doc.log#lscale_cond.f90">Revision history</A></B>
                0172
                0173 <b>Prior changes</b>
                0174
                0175      MPP version created. Minor changes for open_file, error_mesg,
                0176      and Fortran write statements. Answers should reproduce the
                0177      previous version.
                0178
                0179 <b>Prior changes</b>
                0180
                0181   * logical input argument added that specifies whether frozen
                0182     precipitation should be computed for the column
                0183     (note: the adjustment is now done energetically consistent
                0184      for the type of precip)
                0185
                0186   * output arguments for column integrated rain and snow replace
                0187     the argument for total precip
                0188
                0189 </PRE>
                0190 </A><!-- END CHANGES -->
                0191 <!--------------------------------------------------------------------->
                0192 <A NAME="ERRORS">
                0193 <HR>
                0194 <H4>ERROR MESSAGES</H4>
                0195 <!-- BEGIN ERRORS -->
                0196 <PRE>
                0197
                0198 <b>Fatal Error in lscale_cond</b>
                0199
                0200     <b>lscale_cond_init has not been called</b>
                0201         The initialization for this module must be called before
                0202         calling routine lscale_cond.
                0203
                0204 </PRE>
                0205 </A><!-- END ERRORS -->
                0206 <!--------------------------------------------------------------------->
                0207 <A NAME="REFERENCES">
                0208 <HR>
                0209 <H4>REFERENCES</H4>
                0210 <!-- BEGIN REFERENCES -->
                0211 <PRE>
                0212
                0213      Manabe, S., (1969). Mon. Wea. Rev. 97, 739-798.
                0214
                0215 </PRE>
                0216 </A><!-- END REFERENCES -->
                0217 <!--------------------------------------------------------------------->
                0218 <A NAME="BUGS">
                0219 <HR>
                0220 <H4>KNOWN BUGS</H4>
                0221 <!-- BEGIN BUGS -->
                0222 <PRE>
                0223
                0224      None.
                0225
                0226 </PRE>
                0227 </A><!-- END BUGS -->
                0228 <!--------------------------------------------------------------------->
                0229 <A NAME="NOTES">
                0230 <HR>
                0231 <H4>NOTES</H4>
                0232 <!-- BEGIN NOTES -->
                0233 <PRE>
                0234
                0235      None.
                0236
                0237 </PRE>
                0238 </A><!-- END NOTES -->
                0239 <!--------------------------------------------------------------------->
                0240 <A NAME="PLANS">
                0241 <HR>
                0242 <H4>FUTURE PLANS</H4>
                0243 <!-- BEGIN PLANS -->
                0244 <PRE>
                0245
                0246      Routine lscale_cond_init could be called automatically by the
                0247      main routine lscale_cond. This would remove the current fatal error
                0248      that would occur.
                0249
                0250 </PRE>
                0251 </A><!-- END PLANS -->
                0252 <!--------------------------------------------------------------------->
                0253
                0254 <HR>
                0255 </BODY>
                0256 </HTML>