/[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.1 - (hide 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 adcroft 1.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