/[MITgcm]/MITgcm/pkg/kpp/KPP_PARAMS.h
ViewVC logotype

Annotation of /MITgcm/pkg/kpp/KPP_PARAMS.h

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.13 - (hide annotations) (download)
Thu May 28 22:59:22 2009 UTC (15 years ago) by dfer
Branch: MAIN
CVS Tags: checkpoint61q, checkpoint61t, checkpoint61u, checkpoint61r, checkpoint61s, checkpoint61p
Changes since 1.12: +6 -2 lines
File MIME type: text/plain
Add run-time flag to remove limit on hbl under stable conditions
(default behavior unchanged)

1 dfer 1.13 C $Header: /u/gcmpack/MITgcm/pkg/kpp/KPP_PARAMS.h,v 1.12 2007/04/23 21:09:19 dimitri Exp $
2 jmc 1.8 C $Name: $
3 adcroft 1.1
4     C /==========================================================\
5     C | KPP_PARAMS.h |
6     C | o Basic parameter header for KPP vertical mixing |
7     C | parameterization. These parameters are initialized by |
8     C | and/or read in from data.kpp file. |
9     C \==========================================================/
10    
11     C Parameters used in kpp routine arguments (needed for compilation
12     C of kpp routines even if ALLOW_KPP is not defined)
13 heimbach 1.5 C mdiff - number of diffusivities for local arrays
14     C Nrm1, Nrp1, Nrp2 - number of vertical levels
15     C imt - array dimension for local arrays
16    
17     integer mdiff, Nrm1, Nrp1, Nrp2
18 dimitri 1.11 integer imt
19 heimbach 1.5 parameter( mdiff = 3 )
20     parameter( Nrm1 = Nr-1 )
21     parameter( Nrp1 = Nr+1 )
22     parameter( Nrp2 = Nr+2 )
23     parameter( imt=(sNx+2*OLx)*(sNy+2*OLy) )
24 adcroft 1.1
25     #ifdef ALLOW_KPP
26    
27     C Time invariant parameters initialized by subroutine kmixinit
28     C nzmax (nx,ny) - Maximum number of wet levels in each column
29     C pMask - Mask relating to Pressure/Tracer point grid.
30     C 0. if P point is on land.
31     C 1. if P point is in water.
32 jmc 1.8 C Note: use now maskC since pMask is identical to maskC
33 adcroft 1.1 C zgrid (0:Nr+1) - vertical levels of tracers (<=0) (m)
34     C hwide (0:Nr+1) - layer thicknesses (>=0) (m)
35     C kpp_freq - Re-computation frequency for KPP parameters (s)
36 adcroft 1.2 C kpp_dumpFreq - KPP dump frequency. (s)
37     C kpp_taveFreq - KPP time-averaging frequency. (s)
38 heimbach 1.3
39 heimbach 1.5 INTEGER nzmax ( 1-OLx:sNx+OLx, 1-OLy:sNy+OLy, nSx, nSy )
40 dimitri 1.12 c _RL pMask ( 1-OLx:sNx+OLx, 1-OLy:sNy+OLy, Nr, nSx, nSy )
41     _RL zgrid ( 0:Nr+1 )
42     _RL hwide ( 0:Nr+1 )
43 adcroft 1.1 _RL kpp_freq
44 adcroft 1.2 _RL kpp_dumpFreq
45     _RL kpp_taveFreq
46 adcroft 1.1
47 heimbach 1.5 COMMON /kpp_i/ nzmax
48 adcroft 1.1
49 jmc 1.8 COMMON /kpp_r1/ zgrid, hwide
50 adcroft 1.1
51 heimbach 1.5 COMMON /kpp_r2/ kpp_freq, kpp_dumpFreq, kpp_taveFreq
52 adcroft 1.1
53    
54     C-----------------------------------------------------------------------
55     C
56     C KPP flags and min/max permitted values for mixing parameters
57     c
58     C KPPmixingMaps - if true, include KPP diagnostic maps in STDOUT
59     C KPPwriteState - if true, write KPP state to file
60     C minKPPhbl - KPPhbl minimum value (m)
61 jmc 1.10 C KPP_ghatUseTotalDiffus -
62     C if T : Compute the non-local term using
63     C the total vertical diffusivity ;
64     C if F (=default): use KPP vertical diffusivity
65     C Note: prior to checkpoint55h_post, was using the total Kz
66 dfer 1.13 C LimitHblStable - if TRUE (the default), limits the depth of the
67     C hbl under stable conditions.
68 adcroft 1.1 C
69     C-----------------------------------------------------------------------
70    
71 jmc 1.10 LOGICAL KPPmixingMaps, KPPwriteState, KPP_ghatUseTotalDiffus
72 dfer 1.13 LOGICAL LimitHblStable
73 adcroft 1.1 COMMON /KPP_PARM_L/
74 dfer 1.13 & KPPmixingMaps, KPPwriteState, KPP_ghatUseTotalDiffus,
75     & LimitHblStable
76 adcroft 1.1
77 dimitri 1.12 _RL minKPPhbl
78     COMMON /KPP_PARM_R/ minKPPhbl
79 adcroft 1.1
80     c====================== file "kmixcom.h" =======================
81     c
82     c-----------------------------------------------------------------------
83     c Define various parameters and common blocks for KPP vertical-
84     c mixing scheme; used in "kppmix.F" subroutines.
85     c Constants are set in subroutine "ini_parms".
86     c-----------------------------------------------------------------------
87     c
88     c-----------------------------------------------------------------------
89     c parameters for several subroutines
90     c
91     c epsln = 1.0e-20
92     c phepsi = 1.0e-10
93     c epsilon = nondimensional extent of the surface layer = 0.1
94     c vonk = von Karmans constant = 0.4
95     c dB_dz = maximum dB/dz in mixed layer hMix = 5.2e-5 s^-2
96     c conc1,conam,concm,conc2,zetam,conas,concs,conc3,zetas
97     c = scalar coefficients
98     c-----------------------------------------------------------------------
99    
100 dimitri 1.12 _RL epsln,phepsi,epsilon,vonk,dB_dz,
101 adcroft 1.1 $ conc1,
102     $ conam,concm,conc2,zetam,
103     $ conas,concs,conc3,zetas
104    
105     common /kmixcom/ epsln,phepsi,epsilon,vonk,dB_dz,
106     $ conc1,
107     $ conam,concm,conc2,zetam,
108     $ conas,concs,conc3,zetas
109    
110     c-----------------------------------------------------------------------
111     c parameters for subroutine "bldepth"
112     c
113     c
114     c to compute depth of boundary layer:
115     c
116     c Ricr = critical bulk Richardson Number = 0.3
117     c cekman = coefficient for ekman depth = 0.7
118     c cmonob = coefficient for Monin-Obukhov depth = 1.0
119     c concv = ratio of interior buoyancy frequency to
120     c buoyancy frequency at entrainment depth = 1.8
121     c hbf = fraction of bounadry layer depth to
122     c which absorbed solar radiation
123     c contributes to surface buoyancy forcing = 1.0
124     c Vtc = non-dimensional coefficient for velocity
125     c scale of turbulant velocity shear
126     c (=function of concv,concs,epsilon,vonk,Ricr)
127     c-----------------------------------------------------------------------
128    
129 dimitri 1.12 _RL Ricr,cekman,cmonob,concv,Vtc
130 heimbach 1.5 _RL hbf
131 adcroft 1.1
132 heimbach 1.5 common /kpp_bldepth1/ Ricr,cekman,cmonob,concv,Vtc
133     common /kpp_bldepth2/ hbf
134 adcroft 1.1
135     c-----------------------------------------------------------------------
136     c parameters and common arrays for subroutines "kmixinit"
137     c and "wscale"
138     c
139     c
140     c to compute turbulent velocity scales:
141     c
142     c nni = number of values for zehat in the look up table
143     c nnj = number of values for ustar in the look up table
144     c
145     c wmt = lookup table for wm, the turbulent velocity scale
146     c for momentum
147     c wst = lookup table for ws, the turbulent velocity scale
148     c for scalars
149     c deltaz = delta zehat in table
150     c deltau = delta ustar in table
151     c zmin = minimum limit for zehat in table (m3/s3)
152     c zmax = maximum limit for zehat in table
153     c umin = minimum limit for ustar in table (m/s)
154     c umax = maximum limit for ustar in table
155     c-----------------------------------------------------------------------
156    
157     integer nni , nnj
158     parameter (nni = 890, nnj = 480)
159    
160 dimitri 1.12 _RL wmt(0:nni+1,0:nnj+1), wst(0:nni+1,0:nnj+1)
161     _RL deltaz,deltau,zmin,zmax,umin,umax
162 adcroft 1.1 common /kmixcws/ wmt, wst
163     $ , deltaz,deltau,zmin,zmax,umin,umax
164    
165     c-----------------------------------------------------------------------
166     c parameters for subroutine "ri_iwmix"
167     c
168     c
169     c to compute vertical mixing coefficients below boundary layer:
170     c
171     c num_v_smooth_Ri = number of times Ri is vertically smoothed
172     c num_v_smooth_BV, num_z_smooth_sh, and num_m_smooth_sh are dummy
173     c variables kept for backward compatibility of the data file
174     c Riinfty = local Richardson Number limit for shear instability = 0.7
175     c BVSQcon = Brunt-Vaisala squared (1/s^2)
176     c difm0 = viscosity max due to shear instability (m^2/s)
177     c difs0 = tracer diffusivity .. (m^2/s)
178     c dift0 = heat diffusivity .. (m^2/s)
179     c difmcon = viscosity due to convective instability (m^2/s)
180     c difscon = tracer diffusivity .. (m^2/s)
181     c diftcon = heat diffusivity .. (m^2/s)
182     c-----------------------------------------------------------------------
183    
184 dimitri 1.12 INTEGER num_v_smooth_Ri, num_v_smooth_BV
185     INTEGER num_z_smooth_sh, num_m_smooth_sh
186 adcroft 1.1 COMMON /kmixcri_i/ num_v_smooth_Ri, num_v_smooth_BV
187     1 , num_z_smooth_sh, num_m_smooth_sh
188    
189 dimitri 1.12 _RL Riinfty, BVSQcon
190     _RL difm0 , difs0 , dift0
191     _RL difmcon, difscon, diftcon
192 adcroft 1.1 COMMON /kmixcri_r/ Riinfty, BVSQcon
193     1 , difm0, difs0, dift0
194     2 , difmcon, difscon, diftcon
195    
196     c-----------------------------------------------------------------------
197     c parameters for subroutine "ddmix"
198     c
199     c
200     c to compute additional diffusivity due to double diffusion:
201     c
202     c Rrho0 = limit for double diffusive density ratio
203     c dsfmax = maximum diffusivity in case of salt fingering (m2/s)
204     c-----------------------------------------------------------------------
205    
206 dimitri 1.12 _RL Rrho0, dsfmax
207 adcroft 1.1 common /kmixcdd/ Rrho0, dsfmax
208    
209     c-----------------------------------------------------------------------
210     c parameters for subroutine "blmix"
211     c
212     c
213     c to compute mixing within boundary layer:
214     c
215     c cstar = proportionality coefficient for nonlocal transport
216     c cg = non-dimensional coefficient for counter-gradient term
217     c-----------------------------------------------------------------------
218    
219 dimitri 1.12 _RL cstar, cg
220 adcroft 1.1 common /kmixcbm/ cstar, cg
221    
222     #endif /* ALLOW_KPP */
223 edhill 1.9
224    
225     CEH3 ;;; Local Variables: ***
226     CEH3 ;;; mode:fortran ***
227     CEH3 ;;; End: ***

  ViewVC Help
Powered by ViewVC 1.1.22