/[MITgcm]/MITgcm/model/inc/PARAMS.h
ViewVC logotype

Diff of /MITgcm/model/inc/PARAMS.h

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

revision 1.1 by cnh, Wed Apr 22 19:15:31 1998 UTC revision 1.232 by mlosch, Mon Nov 23 16:13:57 2009 UTC
# Line 1  Line 1 
1  C $Id$  C $Header$
2    C $Name$
3  C  C
4  C     /==========================================================\  
5  C     | PARAMS.h                                                 |  CBOP
6  C     | o Header file defining model "parameters".               |  C     !ROUTINE: PARAMS.h
7  C     |==========================================================|  C     !INTERFACE:
8  C     | The values from the model's standard input file are      |  C     #include PARAMS.h
9  C     | stored into the variables held here. Notes describing    |  
10  C     | the parameters can also be found here.                   |  C     !DESCRIPTION:
11  C     \==========================================================/  C     Header file defining model "parameters".  The values from the
12    C     model standard input file are stored into the variables held
13    C     here. Notes describing the parameters can also be found here.
14    
15    CEOP
16    
17    C     Macros for special grid options
18    #include "PARAMS_MACROS.h"
19    
20  C--   Contants  C--   Contants
 C     nOBands - No. of offline data time bands  
       INTEGER nOBands  
       PARAMETER ( nOBands = 12 )  
21  C     Useful physical values  C     Useful physical values
22        Real*8 PI        Real*8 PI
23        PARAMETER ( PI    = 3.14159265358979323844D0   )        PARAMETER ( PI    = 3.14159265358979323844D0   )
# Line 20  C     Useful physical values Line 25  C     Useful physical values
25        PARAMETER ( deg2rad = 2.D0*PI/360.D0           )        PARAMETER ( deg2rad = 2.D0*PI/360.D0           )
26    
27  C--   COMMON /PARM_C/ Character valued parameters used by the model.  C--   COMMON /PARM_C/ Character valued parameters used by the model.
28  C     oBandId  - Offline dataset identifiers for different periods.  C     buoyancyRelation :: Flag used to indicate which relation to use to
29        COMMON /PARM_C/ oBandId  C                         get buoyancy.
30        CHARACTER*3 oBandId(nOBands)  C     eosType         :: choose the equation of state:
31    C                        LINEAR, POLY3, UNESCO, JMD95Z, JMD95P, MDJWF, IDEALGAS
32    C     pickupSuff      :: force to start from pickup files (even if nIter0=0)
33    C                        and read pickup files with this suffix (max 10 Char.)
34    C     mdsioLocalDir   :: read-write tiled file from/to this directory name
35    C                        (+ 4 digits Processor-Rank) instead of current dir.
36    C     tRefFile      :: File containing reference Potential Temperat.  tRef (1.D)
37    C     sRefFile      :: File containing reference salinity/spec.humid. sRef (1.D)
38    C     rhoRefFile    :: File containing reference density profile rhoRef (1.D)
39    C     delRFile      :: File containing vertical grid spacing delR  (1.D array)
40    C     delRcFile     :: File containing vertical grid spacing delRc (1.D array)
41    C     delXFile      :: File containing X-spacing grid definition (1.D array)
42    C     delYFile      :: File containing Y-spacing grid definition (1.D array)
43    C     horizGridFile :: File containing horizontal-grid definition
44    C                        (only when using curvilinear_grid)
45    C     bathyFile       :: File containing bathymetry. If not defined bathymetry
46    C                        is taken from inline function.
47    C     topoFile        :: File containing the topography of the surface (unit=m)
48    C                        (mainly used for the atmosphere = ground height).
49    C     hydrogThetaFile :: File containing initial hydrographic data (3-D)
50    C                        for potential temperature.
51    C     hydrogSaltFile  :: File containing initial hydrographic data (3-D)
52    C                        for salinity.
53    C     diffKrFile      :: File containing 3D specification of vertical diffusivity
54    C     zonalWindFile   :: File containing zonal wind data
55    C     meridWindFile   :: File containing meridional wind data
56    C     thetaClimFile   :: File containing surface theta climataology used
57    C                       in relaxation term -lambda(theta-theta*)
58    C     saltClimFile    :: File containing surface salt climataology used
59    C                       in relaxation term -lambda(salt-salt*)
60    C     surfQfile       :: File containing surface heat flux, excluding SW
61    C                        (old version, kept for backward compatibility)
62    C     surfQnetFile    :: File containing surface net heat flux
63    C     surfQswFile     :: File containing surface shortwave radiation
64    C     dQdTfile        :: File containing thermal relaxation coefficient
65    C     EmPmRfile       :: File containing surface fresh water flux
66    C           NOTE: for backward compatibility EmPmRfile is specified in
67    C                 m/s when using external_fields_load.F.  It is converted
68    C                 to kg/m2/s by multiplying by rhoConstFresh.
69    C     saltFluxFile    :: File containing surface salt flux
70    C     pLoadFile       :: File containing pressure loading
71    C     eddyPsiXFile    :: File containing zonal Eddy streamfunction data
72    C     eddyPsiYFile    :: File containing meridional Eddy streamfunction data
73    C     the_run_name    :: string identifying the name of the model "run"
74          COMMON /PARM_C/
75         &                buoyancyRelation, eosType,
76         &                pickupSuff, mdsioLocalDir,
77         &                tRefFile, sRefFile, rhoRefFile,
78         &                delRFile, delRcFile,
79         &                delXFile, delYFile, horizGridFile,
80         &                bathyFile, topoFile,
81         &                hydrogThetaFile, hydrogSaltFile, diffKrFile,
82         &                zonalWindFile, meridWindFile, thetaClimFile,
83         &                saltClimFile,
84         &                EmPmRfile, saltFluxFile,
85         &                surfQfile, surfQnetFile, surfQswFile,
86         &                lambdaThetaFile, lambdaSaltFile,
87         &                uVelInitFile, vVelInitFile, pSurfInitFile,
88         &                dQdTfile, ploadFile,
89         &                eddyPsiXFile, eddyPsiYFile,
90         &                the_run_name
91          CHARACTER*(MAX_LEN_FNAM) buoyancyRelation
92          CHARACTER*(6)  eosType
93          CHARACTER*(10) pickupSuff
94          CHARACTER*(MAX_LEN_FNAM) mdsioLocalDir
95          CHARACTER*(MAX_LEN_FNAM) tRefFile
96          CHARACTER*(MAX_LEN_FNAM) sRefFile
97          CHARACTER*(MAX_LEN_FNAM) rhoRefFile
98          CHARACTER*(MAX_LEN_FNAM) delRFile
99          CHARACTER*(MAX_LEN_FNAM) delRcFile
100          CHARACTER*(MAX_LEN_FNAM) delXFile
101          CHARACTER*(MAX_LEN_FNAM) delYFile
102          CHARACTER*(MAX_LEN_FNAM) horizGridFile
103          CHARACTER*(MAX_LEN_FNAM) bathyFile, topoFile
104          CHARACTER*(MAX_LEN_FNAM) hydrogThetaFile, hydrogSaltFile
105          CHARACTER*(MAX_LEN_FNAM) diffKrFile
106          CHARACTER*(MAX_LEN_FNAM) zonalWindFile
107          CHARACTER*(MAX_LEN_FNAM) meridWindFile
108          CHARACTER*(MAX_LEN_FNAM) thetaClimFile
109          CHARACTER*(MAX_LEN_FNAM) saltClimFile
110          CHARACTER*(MAX_LEN_FNAM) surfQfile
111          CHARACTER*(MAX_LEN_FNAM) surfQnetFile
112          CHARACTER*(MAX_LEN_FNAM) surfQswFile
113          CHARACTER*(MAX_LEN_FNAM) EmPmRfile
114          CHARACTER*(MAX_LEN_FNAM) saltFluxFile
115          CHARACTER*(MAX_LEN_FNAM) uVelInitFile
116          CHARACTER*(MAX_LEN_FNAM) vVelInitFile
117          CHARACTER*(MAX_LEN_FNAM) pSurfInitFile
118          CHARACTER*(MAX_LEN_FNAM) dQdTfile
119          CHARACTER*(MAX_LEN_FNAM) ploadFile
120          CHARACTER*(MAX_LEN_FNAM) eddyPsiXFile
121          CHARACTER*(MAX_LEN_FNAM) eddyPsiYFile
122          CHARACTER*(MAX_LEN_FNAM) lambdaThetaFile
123          CHARACTER*(MAX_LEN_FNAM) lambdaSaltFile
124          CHARACTER*(MAX_LEN_PREC/2) the_run_name
125    
126  C--   COMMON /PARM_I/ Integer valued parameters used by the model.  C--   COMMON /PARM_I/ Integer valued parameters used by the model.
127  C     cg2dMaxIters        - Maximum number of iterations in the  C     cg2dMaxIters        :: Maximum number of iterations in the
128  C                           two-dimensional con. grad solver.  C                           two-dimensional con. grad solver.
129  C     cg2dChkResFreq      - Frequency with which to check residual  C     cg2dChkResFreq      :: Frequency with which to check residual
130    C                           in con. grad solver.
131    C     cg2dPreCondFreq     :: Frequency for updating cg2d preconditioner
132    C                            (non-linear free-surf.)
133    C     cg3dMaxIters        :: Maximum number of iterations in the
134    C                           three-dimensional con. grad solver.
135    C     cg3dChkResFreq      :: Frequency with which to check residual
136  C                           in con. grad solver.  C                           in con. grad solver.
137  C     nIter0              - Start time-step number of for this run  C     nIter0              :: Start time-step number of for this run
138  C     nTimeSteps          - Number of timesteps to execute  C     nTimeSteps          :: Number of timesteps to execute
139  C     numStepsPerPickup   - For offline setup. Frequency of pickup  C     writeStatePrec      :: Precision used for writing model state.
140  C                           of flow fields.  C     writeBinaryPrec     :: Precision used for writing binary files
141    C     readBinaryPrec      :: Precision used for reading binary files
142    C     nonlinFreeSurf      :: option related to non-linear free surface
143    C                           =0 Linear free surface ; >0 Non-linear
144    C     select_rStar        :: option related to r* vertical coordinate
145    C                           =0 (default) use r coord. ; > 0 use r*
146    C     selectAddFluid      :: option to add mass source/sink of fluid in the interior
147    C                            (3-D generalisation of oceanic real-fresh water flux)
148    C                           =0 off ; =1 add fluid ; =-1 virtual flux (no mass added)
149    C     momForcingOutAB     :: =1: take momentum forcing contribution
150    C                           out of (=0: in) Adams-Bashforth time stepping.
151    C     tracForcingOutAB    :: =1: take tracer (Temp,Salt,pTracers) forcing contribution
152    C                           out of (=0: in) Adams-Bashforth time stepping.
153    C     tempAdvScheme       :: Temp. Horiz.Advection scheme selector
154    C     tempVertAdvScheme   :: Temp. Vert. Advection scheme selector
155    C     saltAdvScheme       :: Salt. Horiz.advection scheme selector
156    C     saltVertAdvScheme   :: Salt. Vert. Advection scheme selector
157    C     selectKEscheme      :: Kinetic Energy scheme selector (Vector Inv.)
158    C     selectVortScheme    :: Scheme selector for Vorticity term (Vector Inv.)
159    C     monitorSelect       :: select group of variables to monitor
160    C                            =1 : dynvars ; =2 : + vort ; =3 : + surface
161    C     debugLevel          :: debug level selector: higher -> more writing
162    
163        COMMON /PARM_I/        COMMON /PARM_I/
164       &        cg2dMaxIters,       &        cg2dMaxIters,
165       &        cg2dChkResFreq,       &        cg2dChkResFreq, cg2dPreCondFreq,
166       &        nIter0, nTimeSteps,       &        cg3dMaxIters,
167       &        numStepsPerPickup       &        cg3dChkResFreq,
168         &        nIter0, nTimeSteps, nEndIter,
169         &        writeStatePrec,
170         &        writeBinaryPrec, readBinaryPrec,
171         &        nonlinFreeSurf, select_rStar,
172         &        selectAddFluid,
173         &        momForcingOutAB, tracForcingOutAB,
174         &        tempAdvScheme, tempVertAdvScheme,
175         &        saltAdvScheme, saltVertAdvScheme,
176         &        selectKEscheme, selectVortScheme,
177         &        monitorSelect, debugLevel
178        INTEGER cg2dMaxIters        INTEGER cg2dMaxIters
179        INTEGER cg2dChkResFreq        INTEGER cg2dChkResFreq
180          INTEGER cg2dPreCondFreq
181          INTEGER cg3dMaxIters
182          INTEGER cg3dChkResFreq
183        INTEGER nIter0        INTEGER nIter0
184        INTEGER nTimeSteps        INTEGER nTimeSteps
185        INTEGER numStepsPerPickup        INTEGER nEndIter
186          INTEGER writeStatePrec
187          INTEGER writeBinaryPrec
188          INTEGER readBinaryPrec
189          INTEGER nonlinFreeSurf
190          INTEGER select_rStar
191          INTEGER selectAddFluid
192          INTEGER momForcingOutAB, tracForcingOutAB
193          INTEGER tempAdvScheme, tempVertAdvScheme
194          INTEGER saltAdvScheme, saltVertAdvScheme
195          INTEGER selectKEscheme
196          INTEGER selectVortScheme
197          INTEGER monitorSelect
198          INTEGER debugLevel
199    
200  C--   COMMON /PARM_L/ Logical valued parameters used by the model.  C--   COMMON /PARM_L/ Logical valued parameters used by the model.
201  C     usingCartesianGrid - If TRUE grid generation will be in a cartesian  C- Coordinate + Grid params:
202    C     fluidIsAir       :: Set to indicate that the fluid major constituent
203    C                        is air
204    C     fluidIsWater     :: Set to indicate that the fluid major constituent
205    C                        is water
206    C     usingPCoords     :: Set to indicate that we are working in a pressure
207    C                        type coordinate (p or p*).
208    C     usingZCoords     :: Set to indicate that we are working in a height
209    C                        type coordinate (z or z*)
210    C     useDynP_inEos_Zc :: use the dynamical pressure in EOS (with Z-coord.)
211    C                         this requires specific code for restart & exchange
212    C     usingCartesianGrid :: If TRUE grid generation will be in a cartesian
213  C                          coordinate frame.  C                          coordinate frame.
214  C     usingSphericalPolarGrid - If TRUE grid generation will be in a  C     usingSphericalPolarGrid :: If TRUE grid generation will be in a
215  C                               spherical polar frame.  C                               spherical polar frame.
216  C     momViscosity  - Flag which turns momentum friction terms on and off.  C     rotateGrid      :: rotate grid coordinates to geographical coordinates
217  C     momAdvection  - Flag which turns advection of momentum on and off.  C                        according to Euler angles phiEuler, thetaEuler, psiEuler
218  C     momForcing    - Flag which turns external forcing of momentum on  C     usingCurvilinearGrid :: If TRUE, use a curvilinear grid (to be provided)
219  C                     and off.  C     usingCylindricalGrid :: If TRUE grid generation will be Cylindrical
220  C     useCoriolis   - Flag which turns the coriolis terms on and off.  C     deepAtmosphere :: deep model (drop the shallow-atmosphere approximation)
221  C     tempDiffusion - Flag which turns diffusion of temperature on  C     setInterFDr    :: set Interface depth (put cell-Center at the middle)
222  C                     and off.  C     setCenterDr    :: set cell-Center depth (put Interface at the middle)
223  C     tempAdvection - Flag which turns advection of temperature on  C- Momentum params:
224  C                     and off.  C     no_slip_sides  :: Impose "no-slip" at lateral boundaries.
225  C     tempForcing   - Flag which turns external forcing of temperature on  C     no_slip_bottom :: Impose "no-slip" at bottom boundary.
226  C                     and off.  C     useFullLeith   :: Set to true to use full Leith viscosity(may be unstable
227  C     saltDiffusion - Flag which turns diffusion of salinit on  C                       on irregular grids)
228  C                     and off.  C     useStrainTensionVisc:: Set to true to use Strain-Tension viscous terms
229  C     saltAdvection - Flag which turns advection of salinit on  C     useAreaViscLength :: Set to true to use old scaling for viscous lengths,
230  C                     and off.  C                          e.g., L2=Raz.  May be preferable for cube sphere.
231  C     saltForcing   - Flag which turns external forcing of salinit on  C     momViscosity  :: Flag which turns momentum friction terms on and off.
232  C                     and off.  C     momAdvection  :: Flag which turns advection of momentum on and off.
233        COMMON /PARM_L/ usingCartesianGrid, usingSphericalPolarGrid,  C     momForcing    :: Flag which turns external forcing of momentum on
234       & momViscosity, momAdvection, momForcing, useCoriolis,  C                      and off.
235       & tempDiffusion, tempAdvection, tempForcing,  C     momPressureForcing :: Flag which turns pressure term in momentum equation
236       & saltDiffusion, saltAdvection, saltForcing  C                          on and off.
237    C     metricTerms   :: Flag which turns metric terms on or off.
238    C     useNHMTerms   :: If TRUE use non-hydrostatic metric terms.
239    C     useCoriolis   :: Flag which turns the coriolis terms on and off.
240    C     use3dCoriolis :: Turns the 3-D coriolis terms (in Omega.cos Phi) on - off
241    C     useConstantF  :: Coriolis parameter set to f0
242    C     useBetaPlaneF :: Coriolis parameter set to f0 + beta.y
243    C     useSphereF    :: Coriolis parameter set to 2.omega.sin(phi)
244    C     useCDscheme   :: use CD-scheme to calculate Coriolis terms.
245    C     vectorInvariantMomentum :: use Vector-Invariant form (mom_vecinv package)
246    C                                (default = F = use mom_fluxform package)
247    C     useJamartWetPoints :: Use wet-point method for Coriolis (Jamart & Ozer 1986)
248    C     useJamartMomAdv :: Use wet-point method for V.I. non-linear term
249    C     upwindVorticity :: bias interpolation of vorticity in the Coriolis term
250    C     highOrderVorticity :: use 3rd/4th order interp. of vorticity (V.I., advection)
251    C     useAbsVorticity :: work with f+zeta in Coriolis terms
252    C     upwindShear        :: use 1rst order upwind interp. (V.I., vertical advection)
253    C     momStepping    :: Turns momentum equation time-stepping off
254    C- Temp. & Salt params:
255    C     tempStepping   :: Turns temperature equation time-stepping off
256    C     saltStepping   :: Turns salinity equation time-stepping off
257    C     tempAdvection  :: Flag which turns advection of temperature on and off.
258    C     tempIsActiveTr :: Pot.Temp. is a dynamically active tracer
259    C     tempForcing    :: Flag which turns external forcing of temperature on
260    C                       and off.
261    C     saltAdvection  :: Flag which turns advection of salinity on and off.
262    C     saltIsActiveTr :: Salinity  is a dynamically active tracer
263    C     saltForcing    :: Flag which turns external forcing of salinity on
264    C                       and off.
265    C     maskIniTemp    :: apply mask to initial Pot.Temp.
266    C     maskIniSalt    :: apply mask to initial salinity
267    C     checkIniTemp   :: check for points with identically zero initial Pot.Temp.
268    C     checkIniSalt   :: check for points with identically zero initial salinity
269    C     useRealFreshWaterFlux :: if True (=Natural BCS), treats P+R-E flux
270    C                         as a real Fresh Water (=> changes the Sea Level)
271    C                         if F, converts P+R-E to salt flux (no SL effect)
272    C- Pressure solver related parameters (PARM02)
273    C     useSRCGSolver  :: Set to true to use conjugate gradient
274    C                       solver with single reduction (only one call of
275    C                       s/r mpi_allreduce), default is false
276    C- Time-stepping params:
277    C     rigidLid            :: Set to true to use rigid lid
278    C     implicitFreeSurface :: Set to true to use implicit free surface
279    C     exactConserv        :: Set to true to conserve exactly the total Volume
280    C     linFSConserveTr     :: Set to true to correct source/sink of tracer
281    C                            at the surface due to Linear Free Surface
282    C     uniformLin_PhiSurf  :: Set to true to use a uniform Bo_surf in the
283    C                            linear relation Phi_surf = Bo_surf*eta
284    C     quasiHydrostatic :: Using non-hydrostatic terms in hydrostatic algorithm
285    C     nonHydrostatic   :: Using non-hydrostatic algorithm
286    C     use3Dsolver      :: set to true to use 3-D pressure solver
287    C     implicitIntGravWave :: treat Internal Gravity Wave implicitly
288    C     staggerTimeStep   :: enable a Stagger time stepping U,V (& W) then T,S
289    C     implicitDiffusion :: Turns implicit vertical diffusion on
290    C     implicitViscosity :: Turns implicit vertical viscosity on
291    C     tempImplVertAdv :: Turns on implicit vertical advection for Temperature
292    C     saltImplVertAdv :: Turns on implicit vertical advection for Salinity
293    C     momImplVertAdv  :: Turns on implicit vertical advection for Momentum
294    C     multiDimAdvection :: Flag that enable multi-dimension advection
295    C     useMultiDimAdvec  :: True if multi-dim advection is used at least once
296    C     momDissip_In_AB   :: if False, put Dissipation tendency contribution
297    C                          out off Adams-Bashforth time stepping.
298    C     doAB_onGtGs       :: if the Adams-Bashforth time stepping is used, always
299    C                          apply AB on tracer tendencies (rather than on Tracer)
300    C- Other forcing params -
301    C     balanceEmPmR    :: substract global mean of EmPmR at every time step
302    C     balanceQnet     :: substract global mean of Qnet at every time step
303    C     balancePrintMean:: print substracted global means to STDOUT
304    C     doThetaClimRelax :: Set true if relaxation to temperature
305    C                        climatology is required.
306    C     doSaltClimRelax  :: Set true if relaxation to salinity
307    C                        climatology is required.
308    C     allowFreezing  :: Allows surface water to freeze and form ice
309    C     useOldFreezing :: use the old version (before checkpoint52a_pre, 2003-11-12)
310    C     periodicExternalForcing :: Set true if forcing is time-dependant
311    C- I/O parameters -
312    C     globalFiles    :: Selects between "global" and "tiled" files
313    C     useSingleCpuIO :: On SGI platforms, option globalFiles is either
314    C                       slow (f77) or does not work (f90).  When
315    C                       useSingleCpuIO is set, mdsio_writefield.F
316    C                       outputs from master mpi process only.
317    C     pickupStrictlyMatch :: check and stop if pickup-file do not stricly match
318    C     startFromPickupAB2 :: with AB-3 code, start from an AB-2 pickup
319    C     usePickupBeforeC54 :: start from old-pickup files, generated with code from
320    C                           before checkpoint-54a, Jul 06, 2004.
321    C     pickup_write_mdsio :: use mdsio to write pickups
322    C     pickup_read_mdsio  :: use mdsio to read  pickups
323    C     pickup_write_immed :: echo the pickup immediately (for conversion)
324    C     writePickupAtEnd   :: write pickup at the last timestep
325    C     timeave_mdsio      :: use mdsio for timeave output
326    C     snapshot_mdsio     :: use mdsio for "snapshot" (dumpfreq/diagfreq) output
327    C     monitor_stdio      :: use stdio for monitor output
328    C     dumpInitAndLast :: dumps model state to files at Initial (nIter0)
329    C                        & Last iteration, in addition multiple of dumpFreq iter.
330    
331          COMMON /PARM_L/
332         & fluidIsAir, fluidIsWater,
333         & usingPCoords, usingZCoords, useDynP_inEos_Zc,
334         & usingCartesianGrid, usingSphericalPolarGrid, rotateGrid,
335         & usingCurvilinearGrid, usingCylindricalGrid,
336         & deepAtmosphere, setInterFDr, setCenterDr,
337         & no_slip_sides, no_slip_bottom,
338         & useFullLeith, useStrainTensionVisc, useAreaViscLength,
339         & momViscosity, momAdvection, momForcing,
340         & momPressureForcing, metricTerms, useNHMTerms,
341         & useCoriolis, use3dCoriolis,
342         & useConstantF, useBetaPlaneF, useSphereF,
343         & useCDscheme, vectorInvariantMomentum,
344         & useEnergyConservingCoriolis, useJamartWetPoints, useJamartMomAdv,
345         & upwindVorticity, highOrderVorticity,
346         & useAbsVorticity, upwindShear,
347         & momStepping, tempStepping, saltStepping,
348         & tempAdvection, tempIsActiveTr, tempForcing,
349         & saltAdvection, saltIsActiveTr, saltForcing,
350         & maskIniTemp, maskIniSalt, checkIniTemp, checkIniSalt,
351         & useRealFreshWaterFlux,
352         & rigidLid, implicitFreeSurface, exactConserv, linFSConserveTr,
353         & uniformLin_PhiSurf,
354         & quasiHydrostatic, nonHydrostatic,
355         & use3Dsolver, implicitIntGravWave, staggerTimeStep,
356         & implicitDiffusion, implicitViscosity,
357         & tempImplVertAdv, saltImplVertAdv, momImplVertAdv,
358         & multiDimAdvection, useMultiDimAdvec,
359         & momDissip_In_AB, doAB_onGtGs,
360         & balanceEmPmR, balanceQnet, balancePrintMean,
361         & doThetaClimRelax, doSaltClimRelax,
362         & allowFreezing, useOldFreezing,
363         & periodicExternalForcing,
364         & globalFiles, useSingleCpuIO,
365         & pickupStrictlyMatch, usePickupBeforeC54, startFromPickupAB2,
366         & pickup_read_mdsio, pickup_write_mdsio, pickup_write_immed,
367         & writePickupAtEnd,
368         & timeave_mdsio, snapshot_mdsio, monitor_stdio,
369         & outputTypesInclusive, dumpInitAndLast, debugMode,
370         & inAdMode, inAdTrue, inAdFalse, inAdExact,
371         & useSRCGSolver
372    
373          LOGICAL fluidIsAir
374          LOGICAL fluidIsWater
375          LOGICAL usingPCoords
376          LOGICAL usingZCoords
377          LOGICAL useDynP_inEos_Zc
378        LOGICAL usingCartesianGrid        LOGICAL usingCartesianGrid
379        LOGICAL usingSphericalPolarGrid        LOGICAL usingSphericalPolarGrid, rotateGrid
380          LOGICAL usingCylindricalGrid
381          LOGICAL usingCurvilinearGrid
382          LOGICAL deepAtmosphere
383          LOGICAL setInterFDr
384          LOGICAL setCenterDr
385          LOGICAL useNHMTerms
386          LOGICAL no_slip_sides
387          LOGICAL no_slip_bottom
388        LOGICAL momViscosity        LOGICAL momViscosity
389        LOGICAL momAdvection        LOGICAL momAdvection
390        LOGICAL momForcing        LOGICAL momForcing
391          LOGICAL momPressureForcing
392        LOGICAL useCoriolis        LOGICAL useCoriolis
393        LOGICAL tempDiffusion        LOGICAL vectorInvariantMomentum
394        LOGICAL tempAdvection        LOGICAL tempAdvection
395          LOGICAL tempIsActiveTr
396        LOGICAL tempForcing        LOGICAL tempForcing
       LOGICAL saltDiffusion  
397        LOGICAL saltAdvection        LOGICAL saltAdvection
398          LOGICAL saltIsActiveTr
399        LOGICAL saltForcing        LOGICAL saltForcing
400          LOGICAL maskIniTemp
401          LOGICAL maskIniSalt
402          LOGICAL checkIniTemp
403          LOGICAL checkIniSalt
404          LOGICAL useRealFreshWaterFlux
405          LOGICAL useFullLeith
406          LOGICAL useStrainTensionVisc
407          LOGICAL useAreaViscLength
408          LOGICAL rigidLid
409          LOGICAL implicitFreeSurface
410          LOGICAL exactConserv
411          LOGICAL linFSConserveTr
412          LOGICAL uniformLin_PhiSurf
413          LOGICAL quasiHydrostatic
414          LOGICAL nonHydrostatic
415          LOGICAL use3Dsolver
416          LOGICAL implicitIntGravWave
417          LOGICAL staggerTimeStep
418          LOGICAL momStepping
419          LOGICAL tempStepping
420          LOGICAL saltStepping
421          LOGICAL metricTerms
422          LOGICAL useConstantF
423          LOGICAL useBetaPlaneF
424          LOGICAL useSphereF
425          LOGICAL use3dCoriolis
426          LOGICAL useCDscheme
427          LOGICAL useEnergyConservingCoriolis
428          LOGICAL useJamartWetPoints
429          LOGICAL useJamartMomAdv
430          LOGICAL upwindVorticity
431          LOGICAL highOrderVorticity
432          LOGICAL useAbsVorticity
433          LOGICAL upwindShear
434          LOGICAL implicitDiffusion
435          LOGICAL implicitViscosity
436          LOGICAL tempImplVertAdv
437          LOGICAL saltImplVertAdv
438          LOGICAL momImplVertAdv
439          LOGICAL multiDimAdvection
440          LOGICAL useMultiDimAdvec
441          LOGICAL momDissip_In_AB
442          LOGICAL doAB_onGtGs
443          LOGICAL balanceEmPmR
444          LOGICAL balanceQnet
445          LOGICAL balancePrintMean
446          LOGICAL doThetaClimRelax
447          LOGICAL doSaltClimRelax
448          LOGICAL allowFreezing
449          LOGICAL useOldFreezing
450          LOGICAL periodicExternalForcing
451          LOGICAL globalFiles
452          LOGICAL useSingleCpuIO
453          LOGICAL pickupStrictlyMatch
454          LOGICAL usePickupBeforeC54
455          LOGICAL startFromPickupAB2
456          LOGICAL pickup_read_mdsio, pickup_write_mdsio
457          LOGICAL pickup_write_immed, writePickupAtEnd
458          LOGICAL timeave_mdsio, snapshot_mdsio, monitor_stdio
459          LOGICAL outputTypesInclusive
460          LOGICAL dumpInitAndLast
461          LOGICAL debugMode
462          LOGICAL inAdMode, inAdTrue, inAdFalse, inAdExact
463          LOGICAL useSRCGSolver
464    
465  C--   COMMON /PARM_R/ "Real" valued parameters used by the model.  C--   COMMON /PARM_R/ "Real" valued parameters used by the model.
466  C     cg2dTargetResidual  C     cg2dTargetResidual
467  C               - Target residual for cg2d solver.  C          :: Target residual for cg2d solver; no unit (RHS normalisation)
468  C     delZ      - Vertical grid spacing (Pa) - delZ is the distance  C     cg2dTargetResWunit
469  C                 between "w" surfaces.  C          :: Target residual for cg2d solver; W unit (No RHS normalisation)
470  C     delX      - Separation between cell faces (m) or (deg), depending  C     cg3dTargetResidual
471    C               :: Target residual for cg3d solver.
472    C     cg2dpcOffDFac :: Averaging weight for preconditioner off-diagonal.
473    C     Note. 20th May 1998
474    C           I made a weird discovery! In the model paper we argue
475    C           for the form of the preconditioner used here ( see
476    C           A Finite-volume, Incompressible Navier-Stokes Model
477    C           ...., Marshall et. al ). The algebra gives a simple
478    C           0.5 factor for the averaging of ac and aCw to get a
479    C           symmettric pre-conditioner. By using a factor of 0.51
480    C           i.e. scaling the off-diagonal terms in the
481    C           preconditioner down slightly I managed to get the
482    C           number of iterations for convergence in a test case to
483    C           drop form 192 -> 134! Need to investigate this further!
484    C           For now I have introduced a parameter cg2dpcOffDFac which
485    C           defaults to 0.51 but can be set at runtime.
486    C     delR      :: Vertical grid spacing ( units of r ).
487    C     delRc     :: Vertical grid spacing between cell centers (r unit).
488    C     delX      :: Separation between cell faces (m) or (deg), depending
489  C     delY        on input flags.  C     delY        on input flags.
490  C     gravity   - Accel. due to gravity ( m/s^2 )  C     gravity   :: Accel. due to gravity ( m/s^2 )
491  C     ronil     - Reference density  C     recip_gravity and its inverse
492  C     startTime - Start time for model  C     gBaro     :: Accel. due to gravity used in barotropic equation ( m/s^2 )
493  C     oBandBeg  - Offline bands start and end times.  C     rhoNil    :: Reference density for the linear equation of state
494  C     oBandEnd  C     rhoConst  :: Vertically constant reference density
495  C     oPeriodLength - Lenght of offline period.  C     rhoFacC   :: normalized (by rhoConst) reference density at cell-Center
496  C     phiMin    - Latitude of southern most cell face.  C     rhoFacF   :: normalized (by rhoConst) reference density at cell-interFace
497  C     thetaMin  - Longitude of western most cell face (this  C     rhoConstFresh :: Constant reference density for fresh water (rain)
498  C                 is an "inert" parameter but it is included  C     rho1Ref   :: reference vertical profile for density
499  C                 to make geographical references simple.)  C     tRef      :: reference vertical profile for potential temperature
500  C     rSphere   - Radius of sphere for a spherical polar grid.  C     sRef      :: reference vertical profile for salinity/specific humidity
501  C     f0        - Reference coriolis parameter ( 1/s )  C     phiRef    :: reference potential (pressure/rho, geopotential) profile
502  C                 ( Southern edge f for beta plane )  C     dBdrRef   :: vertical gradient of reference boyancy  [(m/s/r)^2)]:
503  C     beta      - df/dy ( s^-1.m^-1 )  C               :: z-coord: = N^2_ref = Brunt-Vaissala frequency [s^-2]
504  C     viscAh    - Eddy viscosity coeff. for mixing of  C               :: p-coord: = -(d.alpha/dp)_ref          [(m^2.s/kg)^2]
505  C                 momentum laterally ( m^2/s )  C     rVel2wUnit :: units conversion factor (Non-Hydrostatic code),
506  C     viscAz    - Eddy viscosity coeff. for mixing of  C                :: from r-coordinate vertical velocity to vertical velocity [m/s].
507  C                 momentum vertically ( m^2/s )  C                :: z-coord: = 1 ; p-coord: wSpeed [m/s] = rVel [Pa/s] * rVel2wUnit
508  C     viscA4    - Biharmonic viscosity coeff. for mixing of  C     wUnit2rVel :: units conversion factor (Non-Hydrostatic code),
509  C                 momentum laterally ( m^4/s )  C                :: from vertical velocity [m/s] to r-coordinate vertical velocity.
510  C     diffKhT   - Laplacian diffusion coeff. for mixing of  C                :: z-coord: = 1 ; p-coord: rVel [Pa/s] = wSpeed [m/s] * wUnit2rVel
511    C     mass2rUnit :: units conversion factor (surface forcing),
512    C                :: from mass per unit area [kg/m2] to vertical r-coordinate unit.
513    C                :: z-coord: = 1/rhoConst ( [kg/m2] / rho = [m] ) ;
514    C                :: p-coord: = gravity    ( [kg/m2] *  g = [Pa] ) ;
515    C     rUnit2mass :: units conversion factor (surface forcing),
516    C                :: from vertical r-coordinate unit to mass per unit area [kg/m2].
517    C                :: z-coord: = rhoConst  ( [m] * rho = [kg/m2] ) ;
518    C                :: p-coord: = 1/gravity ( [Pa] /  g = [kg/m2] ) ;
519    C     xgOrigin   :: Origin of the X-axis (Cartesian Grid) / Longitude of Western
520    C                :: most cell face (Lat-Lon grid) (Note: this is an "inert"
521    C                :: parameter but it makes geographical references simple.)
522    C     ygOrigin   :: Origin of the Y-axis (Cartesian Grid) / Latitude of Southern
523    C                :: most face (Lat-Lon grid).
524    C     rSphere    :: Radius of sphere for a spherical polar grid ( m ).
525    C     recip_rSphere  :: Reciprocal radius of sphere ( m ).
526    C     f0         :: Reference coriolis parameter ( 1/s )
527    C                   ( Southern edge f for beta plane )
528    C     beta       :: df/dy ( s^-1.m^-1 )
529    C     omega      :: Angular velocity ( rad/s )
530    C     rotationPeriod :: Rotation period (s) (= 2.pi/omega)
531    C     viscArNr   :: vertical profile of Eddy viscosity coeff.
532    C                   for vertical mixing of momentum ( units of r^2/s )
533    C     viscAh     :: Eddy viscosity coeff. for mixing of
534    C                   momentum laterally ( m^2/s )
535    C     viscAhW    :: Eddy viscosity coeff. for mixing of vertical
536    C                   momentum laterally, no effect for hydrostatic
537    C                   model, defaults to viscAh if unset ( m^2/s )
538    C                   Not used if variable horiz. viscosity is used.
539    C     viscA4     :: Biharmonic viscosity coeff. for mixing of
540    C                   momentum laterally ( m^4/s )
541    C     viscA4W    :: Biharmonic viscosity coeff. for mixing of vertical
542    C                   momentum laterally, no effect for hydrostatic
543    C                   model, defaults to viscA4 if unset ( m^2/s )
544    C                   Not used if variable horiz. viscosity is used.
545    C     viscAhD    :: Eddy viscosity coeff. for mixing of momentum laterally
546    C                   (act on Divergence part) ( m^2/s )
547    C     viscAhZ    :: Eddy viscosity coeff. for mixing of momentum laterally
548    C                   (act on Vorticity  part) ( m^2/s )
549    C     viscA4D    :: Biharmonic viscosity coeff. for mixing of momentum laterally
550    C                   (act on Divergence part) ( m^4/s )
551    C     viscA4Z    :: Biharmonic viscosity coeff. for mixing of momentum laterally
552    C                   (act on Vorticity  part) ( m^4/s )
553    C     viscC2leith  :: Leith non-dimensional viscosity factor (grad(vort))
554    C     viscC2leithD :: Modified Leith non-dimensional visc. factor (grad(div))
555    C     viscC4leith  :: Leith non-dimensional viscosity factor (grad(vort))
556    C     viscC4leithD :: Modified Leith non-dimensional viscosity factor (grad(div))
557    C     viscC2smag   :: Smagorinsky non-dimensional viscosity factor (harmonic)
558    C     viscC4smag   :: Smagorinsky non-dimensional viscosity factor (biharmonic)
559    C     viscAhMax    :: Maximum eddy viscosity coeff. for mixing of
560    C                    momentum laterally ( m^2/s )
561    C     viscAhReMax  :: Maximum gridscale Reynolds number for eddy viscosity
562    C                     coeff. for mixing of momentum laterally (non-dim)
563    C     viscAhGrid   :: non-dimensional grid-size dependent viscosity
564    C     viscAhGridMax:: maximum and minimum harmonic viscosity coefficients ...
565    C     viscAhGridMin::  in terms of non-dimensional grid-size dependent visc.
566    C     viscA4Max    :: Maximum biharmonic viscosity coeff. for mixing of
567    C                     momentum laterally ( m^4/s )
568    C     viscA4ReMax  :: Maximum Gridscale Reynolds number for
569    C                     biharmonic viscosity coeff. momentum laterally (non-dim)
570    C     viscA4Grid   :: non-dimensional grid-size dependent bi-harmonic viscosity
571    C     viscA4GridMax:: maximum and minimum biharmonic viscosity coefficients ...
572    C     viscA4GridMin::  in terms of non-dimensional grid-size dependent viscosity
573    C     diffKhT   :: Laplacian diffusion coeff. for mixing of
574  C                 heat laterally ( m^2/s )  C                 heat laterally ( m^2/s )
575  C     diffKzT   - Laplacian diffusion coeff. for mixing of  C     diffKrNrT :: vertical profile of Laplacian diffusion coeff.
576  C                 heat vertically ( m^2/s )  C                 for mixing of heat vertically ( units of r^2/s )
577  C     diffK4T   - Biharmonic diffusion coeff. for mixing of  C     diffK4T   :: Biharmonic diffusion coeff. for mixing of
578  C                 heat laterally ( m^4/s )  C                 heat laterally ( m^4/s )
579  C     diffKhS  -  Laplacian diffusion coeff. for mixing of  C     diffKhS  ::  Laplacian diffusion coeff. for mixing of
580  C                 salt laterally ( m^2/s )  C                 salt laterally ( m^2/s )
581  C     diffKzS   - Laplacian diffusion coeff. for mixing of  C     diffKrNrS :: vertical profile of Laplacian diffusion coeff.
582  C                 salt vertically ( m^2/s )  C                 for mixing of salt vertically ( units of r^2/s ),
583  C     diffK4S   - Biharmonic diffusion coeff. for mixing of  C     diffK4S   :: Biharmonic diffusion coeff. for mixing of
584  C                 salt laterally ( m^4/s )  C                 salt laterally ( m^4/s )
585  C     delt      - Timestep ( s )  C     diffKrBL79surf :: T/S surface diffusivity (m^2/s) Bryan and Lewis, 1979
586  C     tauCD     - CD scheme coupling timescale ( 1/s )  C     diffKrBL79deep :: T/S deep diffusivity (m^2/s) Bryan and Lewis, 1979
587  C     rCD       - CD scheme normalised coupling parameter ( 0-1 )  C     diffKrBL79scl  :: depth scale for arctan fn (m) Bryan and Lewis, 1979
588  C     startTime - Starting time for this integration ( s ).  C     diffKrBL79Ho   :: depth offset for arctan fn (m) Bryan and Lewis, 1979
589  C     endTime   - Ending time for this integration ( s ).  C     BL79LatVary    :: polarwise of this latitude diffKrBL79 is applied with
590  C     chkPtFreq - Frequency of check pointing ( s ).  C                       gradual transition to diffKrBLEQ towards Equator
591  C     dumpFreq  - Frequency with which model state is written to  C     diffKrBLEQsurf :: same as diffKrBL79surf but at Equator
592  C                 post-processing files ( s ).  C     diffKrBLEQdeep :: same as diffKrBL79deep but at Equator
593        COMMON /PARM_R/ cg2dTargetResidual, delZ, delX, delY,  C     diffKrBLEQscl  :: same as diffKrBL79scl but at Equator
594       & deltaTmom, deltaTtracer, abeps, startTime, oBandBeg, oBandEnd,  C     diffKrBLEQHo   :: same as diffKrBL79Ho but at Equator
595       & oPeriodLength, phiMin, thetaMin, rSphere, f0, fCori, beta,  C     deltaT    :: Default timestep ( s )
596       & viscAh, viscAz, viscA4, diffKhT, diffKzT, diffK4T,  C     deltaTClock  :: Timestep used as model "clock". This determines the
597       & diffKhS, diffKzS, diffK4S, delT, tauCD, rCD,  C                    IO frequencies and is used in tagging output. It can
598       & tAlpha, sBeta, gravity, rhonil, tRef, sRef,  C                    be totally different to the dynamical time. Typically
599       & endTime, chkPtFreq, dumpFreq  C                    it will be the deep-water timestep for accelerated runs.
600        REAL cg2dTargetResidual  C                    Frequency of checkpointing and dumping of the model state
601        REAL delZ(Nz)  C                    are referenced to this clock. ( s )
602        REAL delX(Nx)  C     deltaTMom    :: Timestep for momemtum equations ( s )
603        REAL delY(Ny)  C     dTtracerLev  :: Timestep for tracer equations ( s ), function of level k
604        REAL deltaTmom  C     deltaTfreesurf :: Timestep for free-surface equation ( s )
605        REAL deltaTtracer  C     freesurfFac  :: Parameter to turn implicit free surface term on or off
606        REAL abeps  C                    freesurfac = 1. uses implicit free surface
607        REAL oBandBeg(nOBands),oBandEnd(nOBands)  C                    freesurfac = 0. uses rigid lid
608        REAL oPeriodLength  C     abEps        :: Adams-Bashforth-2 stabilizing weight
609        REAL phiMin  C     alph_AB      :: Adams-Bashforth-3 primary factor
610        REAL thetaMin  C     beta_AB      :: Adams-Bashforth-3 secondary factor
611        REAL rSphere  C     implicSurfPress :: parameter of the Crank-Nickelson time stepping :
612        REAL f0  C                     Implicit part of Surface Pressure Gradient ( 0-1 )
613        _RL  beta  C     implicDiv2Dflow :: parameter of the Crank-Nickelson time stepping :
614        REAL viscAh  C                     Implicit part of barotropic flow Divergence ( 0-1 )
615        REAL viscAz  C     hFacMin      :: Minimum fraction size of a cell (affects hFacC etc...)
616        REAL viscA4  C     hFacMinDz    :: Minimum dimensional size of a cell (affects hFacC etc..., m)
617        REAL diffKhT  C     hFacMinDp    :: Minimum dimensional size of a cell (affects hFacC etc..., Pa)
618        REAL diffKzT  C     hFacMinDr    :: Minimum dimensional size of a cell (-> hFacC etc..., r units)
619        REAL diffK4T  C     hFacInf      :: Threshold (inf and sup) for fraction size of surface cell
620        REAL diffKhS  C     hFacSup          that control vanishing and creating levels
621        REAL diffKzS  C     tauCD         :: CD scheme coupling timescale ( s )
622        REAL diffK4S  C     rCD           :: CD scheme normalised coupling parameter (= 1 - deltaT/tauCD)
623        REAL delt  C     epsAB_CD      :: Adams-Bashforth-2 stabilizing weight used in CD scheme
624        REAL tauCD  C     baseTime      :: model base time (time origin) = time @ iteration zero
625        REAL rCD  C     startTime     :: Starting time for this integration ( s ).
626        REAL tAlpha  C     endTime       :: Ending time for this integration ( s ).
627        REAL sBeta  C     chkPtFreq     :: Frequency of rolling check pointing ( s ).
628        REAL gravity  C     pChkPtFreq    :: Frequency of permanent check pointing ( s ).
629        REAL rhonil  C     dumpFreq      :: Frequency with which model state is written to
630        REAL tRef(Nz)  C                     post-processing files ( s ).
631        REAL sRef(Nz)  C     diagFreq      :: Frequency with which model writes diagnostic output
632        real Fcori(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)  C                     of intermediate quantities.
633        REAL startTime  C     afFacMom      :: Advection of momentum term tracer parameter
634        REAL endTime  C     vfFacMom      :: Momentum viscosity tracer parameter
635        REAL chkPtFreq  C     pfFacMom      :: Momentum pressure forcing tracer parameter
636        REAL dumpFreq  C     cfFacMom      :: Coriolis term tracer parameter
637        COMMON /PARM_A/ HeatCapacity_Cp,  C     foFacMom      :: Momentum forcing tracer parameter
638       &                Lamba_theta  C     mtFacMom      :: Metric terms tracer parameter
639        REAL HeatCapacity_Cp  C     cosPower      :: Power of cosine of latitude to multiply viscosity
640        REAL Lamba_theta  C     cAdjFreq      :: Frequency of convective adjustment
641    C
642    C     taveFreq      :: Frequency with which time-averaged model state
643    C                      is written to post-processing files ( s ).
644    C     tave_lastIter :: (for state variable only) fraction of the last time
645    C                      step (of each taveFreq period) put in the time average.
646    C                      (fraction for 1rst iter = 1 - tave_lastIter)
647    C     tauThetaClimRelax :: Relaxation to climatology time scale ( s ).
648    C     tauSaltClimRelax :: Relaxation to climatology time scale ( s ).
649    C     latBandClimRelax :: latitude band where Relaxation to Clim. is applied,
650    C                         i.e. where |yC| <= latBandClimRelax
651    C     externForcingPeriod :: Is the period of which forcing varies (eg. 1 month)
652    C     externForcingCycle :: Is the repeat time of the forcing (eg. 1 year)
653    C                          (note: externForcingCycle must be an integer
654    C                           number times externForcingPeriod)
655    C     convertFW2Salt :: salinity, used to convert Fresh-Water Flux to Salt Flux
656    C                       (use model surface (local) value if set to -1)
657    C     temp_EvPrRn :: temperature of Rain & Evap.
658    C     salt_EvPrRn :: salinity of Rain & Evap.
659    C        (notes: a) tracer content of Rain/Evap only used if both
660    C                     NonLin_FrSurf & useRealFreshWater are set.
661    C                b) use model surface (local) value if set to UNSET_RL)
662    C     hMixCriteria:: criteria for mixed-layer diagnostic
663    C     dRhoSmall   :: parameter for mixed-layer diagnostic
664    C     hMixSmooth  :: Smoothing parameter for mixed-layer diag (default=0=no smoothing)
665    C     ivdc_kappa  :: implicit vertical diffusivity for convection [m^2/s]
666    C     Ro_SeaLevel :: standard position of Sea-Level in "R" coordinate, used as
667    C                    starting value (k=1) for vertical coordinate (rf(1)=Ro_SeaLevel)
668    C     sideDragFactor     :: side-drag scaling factor (used only if no_slip_sides)
669    C                           (default=2: full drag ; =1: gives half-slip BC)
670    C     bottomDragLinear    :: Linear    bottom-drag coefficient (units of [r]/s)
671    C     bottomDragQuadratic :: Quadratic bottom-drag coefficient (units of [r]/m)
672    C               (if using zcoordinate, units becomes linear: m/s, quadratic: [-])
673    C     smoothAbsFuncRange :: 1/2 of interval around zero, for which FORTRAN ABS
674    C                           is to be replace by a smoother function
675    C                           (affects myabs, mymin, mymax)
676    C     nh_Am2        :: scales the non-hydrostatic terms and changes internal scales
677    C                      (i.e. allows convection at different Rayleigh numbers)
678    C     phiEuler      :: Euler angle, rotation about original z-axis
679    C     thetaEuler    :: Euler angle, rotation about new x-axis
680    C     psiEuler      :: Euler angle, rotation about new z-axis
681          COMMON /PARM_R/ cg2dTargetResidual, cg2dTargetResWunit,
682         & cg2dpcOffDFac, cg3dTargetResidual,
683         & delR, delRc, delX, delY,
684         & deltaT, deltaTmom, dTtracerLev, deltaTfreesurf, deltaTClock,
685         & abEps, alph_AB, beta_AB,
686         & xgOrigin, ygOrigin, rSphere, recip_RSphere, f0, beta,
687         & viscAh, viscAhW, viscAhMax,
688         & viscAhGrid, viscAhGridMax, viscAhGridMin,
689         & viscC2leith, viscC2leithD,
690         & viscC2smag, viscC4smag,
691         & viscAhD, viscAhZ, viscA4D, viscA4Z,
692         & viscA4, viscA4W, viscA4Max,
693         & viscA4Grid, viscA4GridMax, viscA4GridMin,
694         & viscAhReMax, viscA4ReMax,
695         & viscC4leith, viscC4leithD, viscArNr,
696         & diffKhT, diffK4T, diffKrNrT,
697         & diffKhS, diffK4S, diffKrNrS,
698         & diffKrBL79surf, diffKrBL79deep, diffKrBL79scl, diffKrBL79Ho,
699         & BL79LatVary,
700         & diffKrBLEQsurf, diffKrBLEQdeep, diffKrBLEQscl, diffKrBLEQHo,
701         & tauCD, rCD, epsAB_CD,
702         & freeSurfFac, implicSurfPress, implicDiv2Dflow,
703         & hFacMin, hFacMinDz, hFacInf, hFacSup,
704         & gravity, recip_gravity, gBaro,
705         & rhonil, recip_rhonil, rhoConst, recip_rhoConst,
706         & rhoFacC, recip_rhoFacC, rhoFacF, recip_rhoFacF,
707         & rhoConstFresh, rho1Ref, tRef, sRef, phiRef, dBdrRef,
708         & rVel2wUnit, wUnit2rVel, mass2rUnit, rUnit2mass,
709         & baseTime, startTime, endTime,
710         & chkPtFreq, pChkPtFreq, dumpFreq, adjDumpFreq,
711         & diagFreq, taveFreq, tave_lastIter, monitorFreq, adjMonitorFreq,
712         & afFacMom, vfFacMom, pfFacMom, cfFacMom, foFacMom, mtFacMom,
713         & cosPower, cAdjFreq, omega, rotationPeriod,
714         & tauThetaClimRelax, tauSaltClimRelax, latBandClimRelax,
715         & externForcingCycle, externForcingPeriod,
716         & convertFW2Salt, temp_EvPrRn, salt_EvPrRn,
717         & hFacMinDr, hFacMinDp,
718         & ivdc_kappa, hMixCriteria, dRhoSmall, hMixSmooth, Ro_SeaLevel,
719         & sideDragFactor, bottomDragLinear, bottomDragQuadratic, nh_Am2,
720         & smoothAbsFuncRange,
721         & tCylIn, tCylOut,
722         & phiEuler, thetaEuler, psiEuler
723    
724          _RL cg2dTargetResidual
725          _RL cg2dTargetResWunit
726          _RL cg3dTargetResidual
727          _RL cg2dpcOffDFac
728          _RL delR(Nr)
729          _RL delRc(Nr+1)
730          _RL delX(Nx)
731          _RL delY(Ny)
732          _RL deltaT
733          _RL deltaTClock
734          _RL deltaTmom
735          _RL dTtracerLev(Nr)
736          _RL deltaTfreesurf
737          _RL abEps, alph_AB, beta_AB
738          _RL xgOrigin
739          _RL ygOrigin
740          _RL rSphere
741          _RL recip_rSphere
742          _RL f0
743          _RL freeSurfFac
744          _RL implicSurfPress
745          _RL implicDiv2Dflow
746          _RL hFacMin
747          _RL hFacMinDz
748          _RL hFacMinDp
749          _RL hFacMinDr
750          _RL hFacInf
751          _RL hFacSup
752          _RL beta
753          _RL viscArNr(Nr)
754          _RL viscAh
755          _RL viscAhW
756          _RL viscAhD
757          _RL viscAhZ
758          _RL viscAhMax
759          _RL viscAhReMax
760          _RL viscAhGrid, viscAhGridMax, viscAhGridMin
761          _RL viscC2leith
762          _RL viscC2leithD
763          _RL viscC2smag
764          _RL viscA4
765          _RL viscA4W
766          _RL viscA4D
767          _RL viscA4Z
768          _RL viscA4Max
769          _RL viscA4ReMax
770          _RL viscA4Grid, viscA4GridMax, viscA4GridMin
771          _RL viscC4leith
772          _RL viscC4leithD
773          _RL viscC4smag
774          _RL diffKhT
775          _RL diffKrNrT(Nr)
776          _RL diffK4T
777          _RL diffKhS
778          _RL diffKrNrS(Nr)
779          _RL diffK4S
780          _RL diffKrBL79surf
781          _RL diffKrBL79deep
782          _RL diffKrBL79scl
783          _RL diffKrBL79Ho
784          _RL BL79LatVary
785          _RL diffKrBLEQsurf
786          _RL diffKrBLEQdeep
787          _RL diffKrBLEQscl
788          _RL diffKrBLEQHo
789          _RL tauCD, rCD, epsAB_CD
790          _RL gravity
791          _RL recip_gravity
792          _RL gBaro
793          _RL rhonil,        recip_rhonil
794          _RL rhoConst,      recip_rhoConst
795          _RL rhoFacC(Nr),   recip_rhoFacC(Nr)
796          _RL rhoFacF(Nr+1), recip_rhoFacF(Nr+1)
797          _RL rhoConstFresh
798          _RL rho1Ref(Nr)
799          _RL tRef(Nr)
800          _RL sRef(Nr)
801          _RL phiRef(2*Nr+1)
802          _RL dBdrRef(Nr)
803          _RL rVel2wUnit(Nr+1), wUnit2rVel(Nr+1)
804          _RL mass2rUnit, rUnit2mass
805          _RL baseTime
806          _RL startTime
807          _RL endTime
808          _RL chkPtFreq
809          _RL pChkPtFreq
810          _RL dumpFreq
811          _RL adjDumpFreq
812          _RL diagFreq
813          _RL taveFreq
814          _RL tave_lastIter
815          _RL monitorFreq
816          _RL adjMonitorFreq
817          _RL afFacMom
818          _RL vfFacMom
819          _RL pfFacMom
820          _RL cfFacMom
821          _RL foFacMom
822          _RL mtFacMom
823          _RL cosPower
824          _RL cAdjFreq
825          _RL omega
826          _RL rotationPeriod
827          _RL tauThetaClimRelax
828          _RL tauSaltClimRelax
829          _RL latBandClimRelax
830          _RL externForcingCycle
831          _RL externForcingPeriod
832          _RL convertFW2Salt
833          _RL temp_EvPrRn
834          _RL salt_EvPrRn
835          _RL ivdc_kappa
836          _RL hMixCriteria
837          _RL dRhoSmall
838          _RL hMixSmooth
839          _RL Ro_SeaLevel
840          _RL sideDragFactor
841          _RL bottomDragLinear
842          _RL bottomDragQuadratic
843          _RL smoothAbsFuncRange
844          _RL nh_Am2
845          _RL tCylIn
846          _RL tCylOut
847          _RL phiEuler, thetaEuler, psiEuler
848    
849    C--   COMMON /PARM_A/ Thermodynamics constants ?
850          COMMON /PARM_A/ HeatCapacity_Cp,recip_Cp
851          _RL HeatCapacity_Cp
852          _RL recip_Cp
853    
854    C--   COMMON /PARM_ATM/ Atmospheric physical parameters (Ideal Gas EOS, ...)
855    C     celsius2K :: convert centigrade (Celsius) degree to Kelvin
856    C     atm_Po    :: standard reference pressure
857    C     atm_Cp    :: specific heat (Cp) of the (dry) air at constant pressure
858    C     atm_Rd    :: gas constant for dry air
859    C     atm_kappa :: kappa = R/Cp (R: constant of Ideal Gas EOS)
860    C     atm_Rq    :: water vapour specific volume anomaly relative to dry air
861    C                  (e.g. typical value = (29/18 -1) 10^-3 with q [g/kg])
862    C     integr_GeoPot :: option to select the way we integrate the geopotential
863    C                     (still a subject of discussions ...)
864    C     selectFindRoSurf :: select the way surf. ref. pressure (=Ro_surf) is
865    C             derived from the orography. Implemented: 0,1 (see INI_P_GROUND)
866          COMMON /PARM_ATM/
867         &            celsius2K,
868         &            atm_Cp, atm_Rd, atm_kappa, atm_Rq, atm_Po,
869         &            integr_GeoPot, selectFindRoSurf
870          _RL celsius2K
871          _RL atm_Po, atm_Cp, atm_Rd, atm_kappa, atm_Rq
872          INTEGER integr_GeoPot, selectFindRoSurf
873    
874    C Logical flags for selecting packages
875          LOGICAL useGAD
876          LOGICAL useOBCS
877          LOGICAL useSHAP_FILT
878          LOGICAL useZONAL_FILT
879          LOGICAL useOPPS
880          LOGICAL usePP81
881          LOGICAL useMY82
882          LOGICAL useGGL90
883          LOGICAL useKPP
884          LOGICAL useGMRedi
885          LOGICAL useDOWN_SLOPE
886          LOGICAL useCAL
887          LOGICAL useEXF
888          LOGICAL useBulkForce
889          LOGICAL useEBM
890          LOGICAL useCheapAML
891          LOGICAL useGrdchk
892          LOGICAL useSMOOTH
893          LOGICAL useECCO
894          LOGICAL useSBO
895          LOGICAL useFLT
896          LOGICAL usePTRACERS
897          LOGICAL useGCHEM
898          LOGICAL useRBCS
899          LOGICAL useOffLine
900          LOGICAL useMATRIX
901          LOGICAL useSEAICE
902          LOGICAL useSALT_PLUME
903          LOGICAL useShelfIce
904          LOGICAL useThSIce
905          LOGICAL useATM2d
906          LOGICAL useAIM
907          LOGICAL useLand
908          LOGICAL useFizhi
909          LOGICAL useGridAlt
910          LOGICAL useDiagnostics
911          LOGICAL useREGRID
912          LOGICAL useLayers
913          LOGICAL useMNC
914          LOGICAL useRunClock
915          LOGICAL useEMBED_FILES
916          LOGICAL useMYPACKAGE
917          COMMON /PARM_PACKAGES/
918         &        useGAD, useOBCS, useSHAP_FILT, useZONAL_FILT,
919         &        useOPPS, usePP81, useMY82, useGGL90, useKPP,
920         &        useGMRedi, useDOWN_SLOPE,
921         &        useCAL, useEXF, useBulkForce, useEBM, useCheapAML,
922         &        useGrdchk, useSMOOTH, useECCO, useSBO, useFLT,
923         &        usePTRACERS, useGCHEM, useRBCS, useOffLine, useMATRIX,
924         &        useSEAICE, useSALT_PLUME, useShelfIce, useThSIce,
925         &        useATM2D, useAIM, useLand, useFizhi, useGridAlt,
926         &        useDiagnostics, useREGRID, useLayers, useMNC,
927         &        useRunClock, useEMBED_FILES,
928         &        useMYPACKAGE
929    CEH3 ;;; Local Variables: ***
930    CEH3 ;;; mode:fortran ***
931    CEH3 ;;; End: ***

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.232

  ViewVC Help
Powered by ViewVC 1.1.22