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

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

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


Revision 1.1 - (show annotations) (download)
Wed Jun 21 19:45:46 2000 UTC (23 years, 11 months ago) by adcroft
Branch: MAIN
CVS Tags: checkpoint29
File MIME type: text/plain
Packaged KPP mixing scheme.

1 C $Header: $
2
3 C /==========================================================\
4 C | KPP_PARAMS.h |
5 C | o Basic parameter header for KPP vertical mixing |
6 C | parameterization. These parameters are initialized by |
7 C | and/or read in from data.kpp file. |
8 C \==========================================================/
9
10 C Parameters used in kpp routine arguments (needed for compilation
11 C of kpp routines even if ALLOW_KPP is not defined)
12 C mdiff = number of diffusivities for local arrays
13 C imt = array dimension for local arrays
14 C Nrm1, Nrp1, Nrp2 = number of vertical levels
15
16 integer mdiff, imt, Nrm1, Nrp1, Nrp2
17 parameter (mdiff = 3)
18 #ifdef FRUGAL_KPP
19 parameter (imt = sNx*sNy)
20 #else
21 parameter (imt = (sNx+2*OLx)*(sNy+2*OLy))
22 #endif
23 parameter (Nrm1 = Nr-1)
24 parameter (Nrp1 = Nr+1)
25 parameter (Nrp2 = Nr+2)
26
27 #ifdef ALLOW_KPP
28
29 C Time invariant parameters initialized by subroutine kmixinit
30 C nzmax (nx,ny) - Maximum number of wet levels in each column
31 C pMask - Mask relating to Pressure/Tracer point grid.
32 C 0. if P point is on land.
33 C 1. if P point is in water.
34 C zgrid (0:Nr+1) - vertical levels of tracers (<=0) (m)
35 C hwide (0:Nr+1) - layer thicknesses (>=0) (m)
36 C kpp_freq - Re-computation frequency for KPP parameters (s)
37
38
39 INTEGER nzmax (1-OLx:sNx+OLx,1-OLy:sNy+OLy, nSx,nSy)
40 _RS pMask (1-OLx:sNx+OLx,1-OLy:sNy+OLy,Nr,nSx,nSy)
41 _RS zgrid (0:Nr+1)
42 _RS hwide (0:Nr+1)
43 _RL kpp_freq
44
45 COMMON /kpp_i/ nzmax
46
47 COMMON /kpp_RS/ pMask, zgrid, hwide
48
49 COMMON /kpp_RL/ kpp_freq
50
51
52 C-----------------------------------------------------------------------
53 C
54 C KPP flags and min/max permitted values for mixing parameters
55 c
56 C KPPmixingMaps - if true, include KPP diagnostic maps in STDOUT
57 C KPPwriteState - if true, write KPP state to file
58 C minKPPghat, maxKPPghat - KPP non local transport bounds (s/m^2)
59 C minKPPviscAz, maxKPPviscAz - KPP viscosity bounds (m^2/s)
60 C minKPPdiffKzT, maxKPPdiffKzT - KPP heat diffusivity bounds (m^2/s)
61 C minKPPdiffKzS, maxKPPdiffKzS - KPP tracer diffusivity bounds (m^2/s)
62 C minKPPhbl - KPPhbl minimum value (m)
63 C
64 C-----------------------------------------------------------------------
65
66 LOGICAL KPPmixingMaps, KPPwriteState
67
68 COMMON /KPP_PARM_L/
69 & KPPmixingMaps, KPPwriteState
70
71 _RS minKPPghat , maxKPPghat
72 _RS minKPPviscAz , maxKPPviscAz(Nr)
73 _RS minKPPdiffKzT, maxKPPdiffKzT
74 _RS minKPPdiffKzS, maxKPPdiffKzS, minKPPhbl
75
76 COMMON /KPP_PARM_R/
77 & minKPPghat , maxKPPghat
78 & , minKPPviscAz , maxKPPviscAz
79 & , minKPPdiffKzT, maxKPPdiffKzT
80 & , minKPPdiffKzS, maxKPPdiffKzS, minKPPhbl
81
82 c====================== file "kmixcom.h" =======================
83 c
84 c-----------------------------------------------------------------------
85 c Define various parameters and common blocks for KPP vertical-
86 c mixing scheme; used in "kppmix.F" subroutines.
87 c Constants are set in subroutine "ini_parms".
88 c-----------------------------------------------------------------------
89 c
90 c-----------------------------------------------------------------------
91 c parameters for several subroutines
92 c
93 c epsln = 1.0e-20
94 c phepsi = 1.0e-10
95 c epsilon = nondimensional extent of the surface layer = 0.1
96 c vonk = von Karmans constant = 0.4
97 c dB_dz = maximum dB/dz in mixed layer hMix = 5.2e-5 s^-2
98 c conc1,conam,concm,conc2,zetam,conas,concs,conc3,zetas
99 c = scalar coefficients
100 c-----------------------------------------------------------------------
101
102 _RS epsln,phepsi,epsilon,vonk,dB_dz,
103 $ conc1,
104 $ conam,concm,conc2,zetam,
105 $ conas,concs,conc3,zetas
106
107 common /kmixcom/ epsln,phepsi,epsilon,vonk,dB_dz,
108 $ conc1,
109 $ conam,concm,conc2,zetam,
110 $ conas,concs,conc3,zetas
111
112 c-----------------------------------------------------------------------
113 c parameters for subroutine "bldepth"
114 c
115 c
116 c to compute depth of boundary layer:
117 c
118 c Ricr = critical bulk Richardson Number = 0.3
119 c cekman = coefficient for ekman depth = 0.7
120 c cmonob = coefficient for Monin-Obukhov depth = 1.0
121 c concv = ratio of interior buoyancy frequency to
122 c buoyancy frequency at entrainment depth = 1.8
123 c hbf = fraction of bounadry layer depth to
124 c which absorbed solar radiation
125 c contributes to surface buoyancy forcing = 1.0
126 c Vtc = non-dimensional coefficient for velocity
127 c scale of turbulant velocity shear
128 c (=function of concv,concs,epsilon,vonk,Ricr)
129 c-----------------------------------------------------------------------
130
131 _RS Ricr,cekman,cmonob,concv,hbf,Vtc
132
133 common /kmixcbd/ Ricr,cekman,cmonob,concv,hbf,Vtc
134
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 _RS wmt(0:nni+1,0:nnj+1), wst(0:nni+1,0:nnj+1)
161 _RS deltaz,deltau,zmin,zmax,umin,umax
162 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 INTEGER num_v_smooth_Ri, num_v_smooth_BV
185 INTEGER num_z_smooth_sh, num_m_smooth_sh
186 _RS Riinfty, BVSQcon
187 _RS difm0 , difs0 , dift0
188 _RS difmcon, difscon, diftcon
189
190 COMMON /kmixcri_i/ num_v_smooth_Ri, num_v_smooth_BV
191 1 , num_z_smooth_sh, num_m_smooth_sh
192
193 COMMON /kmixcri_r/ Riinfty, BVSQcon
194 1 , difm0, difs0, dift0
195 2 , difmcon, difscon, diftcon
196
197 c-----------------------------------------------------------------------
198 c parameters for subroutine "ddmix"
199 c
200 c
201 c to compute additional diffusivity due to double diffusion:
202 c
203 c Rrho0 = limit for double diffusive density ratio
204 c dsfmax = maximum diffusivity in case of salt fingering (m2/s)
205 c-----------------------------------------------------------------------
206
207 _RS Rrho0, dsfmax
208 common /kmixcdd/ Rrho0, dsfmax
209
210 c-----------------------------------------------------------------------
211 c parameters for subroutine "blmix"
212 c
213 c
214 c to compute mixing within boundary layer:
215 c
216 c cstar = proportionality coefficient for nonlocal transport
217 c cg = non-dimensional coefficient for counter-gradient term
218 c-----------------------------------------------------------------------
219
220 _RS cstar, cg
221
222 common /kmixcbm/ cstar, cg
223
224 #endif /* ALLOW_KPP */

  ViewVC Help
Powered by ViewVC 1.1.22