/[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.2 by cnh, Fri Apr 24 02:11:37 1998 UTC revision 1.65.2.8 by dimitri, Fri May 2 14:25:29 2003 UTC
# Line 1  Line 1 
1  C $Header$  C $Header$
2    C $Name$
3  C  C
4  C     /==========================================================\  CBOP
5  C     | PARAMS.h                                                 |  C    !ROUTINE: PARAMS.h
6  C     | o Header file defining model "parameters".               |  C    !INTERFACE:
7  C     |==========================================================|  C    include PARAMS.h
8  C     | The values from the model's standard input file are      |  C    !DESCRIPTION: \bv
9  C     | stored into the variables held here. Notes describing    |  C     *==========================================================*
10  C     | the parameters can also be found here.                   |  C     | PARAMS.h                                                  
11  C     \==========================================================/  C     | o Header file defining model "parameters".                
12    C     *==========================================================*
13    C     | The values from the model standard input file are        
14    C     | stored into the variables held here. Notes describing    
15    C     | the parameters can also be found here.                    
16    C     *==========================================================*
17    C     \ev
18    CEOP
19    
20    C     Macros for special grid options
21    #include "PARAMS_MACROS.h"
22    
23  C--   Contants  C--   Contants
 C     nOBands - No. of offline data time bands  
       INTEGER nOBands  
       PARAMETER ( nOBands = 12 )  
24  C     Useful physical values  C     Useful physical values
25        Real*8 PI        Real*8 PI
26        PARAMETER ( PI    = 3.14159265358979323844D0   )        PARAMETER ( PI    = 3.14159265358979323844D0   )
27        Real*8 deg2rad        Real*8 deg2rad
28        PARAMETER ( deg2rad = 2.D0*PI/360.D0           )        PARAMETER ( deg2rad = 2.D0*PI/360.D0           )
29    
30    C     Symbolic values
31    C     precXXXX :: Used to indicate what precision to use for
32    C                dumping model state.
33          INTEGER precFloat32
34          PARAMETER ( precFloat32 = 32 )
35          INTEGER precFloat64
36          PARAMETER ( precFloat64 = 64 )
37    C     UNSET_xxx :: Used to indicate variables that have not been given a value
38          Real*8 UNSET_FLOAT8
39          PARAMETER ( UNSET_FLOAT8 = 1.234567D5 )
40          Real*4 UNSET_FLOAT4
41          PARAMETER ( UNSET_FLOAT4 = 1.234567E5 )
42          _RL    UNSET_RL    
43          PARAMETER ( UNSET_RL     = 1.234567D5 )
44          _RS    UNSET_RS    
45          PARAMETER ( UNSET_RS     = 1.234567E5 )
46          INTEGER UNSET_I
47          PARAMETER ( UNSET_I      = 123456789  )
48    
49    C     Checkpoint data
50          INTEGER maxNoChkptLev
51          PARAMETER ( maxNoChkptLev = 2 )
52    
53  C--   COMMON /PARM_C/ Character valued parameters used by the model.  C--   COMMON /PARM_C/ Character valued parameters used by the model.
54  C     oBandId  - Offline dataset identifiers for different periods.  C     checkPtSuff :: List of checkpoint file suffices
55        COMMON /PARM_C/ oBandId  C     bathyFile   :: File containing bathymetry. If not defined bathymetry
56        CHARACTER*3 oBandId(nOBands)  C                   is taken from inline function.
57    C     topoFile    :: File containing the topography of the surface (unit=m)
58    C                   (mainly used for the atmosphere = ground height).
59    C     hydrogThetaFile :: File containing initial hydrographic data for potential
60    C                       temperature.
61    C     hydrogSaltFile  :: File containing initial hydrographic data for salinity.
62    C     zonalWindFile   :: File containing zonal wind data
63    C     meridWindFile   :: File containing meridional wind data
64    C     thetaClimFile   :: File containing theta climataology used
65    C                       in relaxation term -lambda(theta-theta*)
66    C     saltClimFile    :: File containing salt climataology used
67    C                       in relaxation term -lambda(salt-salt*)
68    C     surfQfile       :: File containing surface heat flux
69    C     surfQswfile     :: File containing surface shortwave radiation
70    C     dQdTfile        :: File containing thermal relaxation coefficient
71    C     EmPmRfile       :: File containing surface fresh water flux
72    C     buoyancyRelation :: Flag used to indicate which relation to use to
73    C                        get buoyancy.
74          COMMON /PARM_C/ checkPtSuff,
75         &                bathyFile, topoFile,
76         &                hydrogThetaFile, hydrogSaltFile,
77         &                zonalWindFile, meridWindFile, thetaClimFile,
78         &                saltClimFile, buoyancyRelation,
79         &                EmPmRfile, surfQfile, surfQswfile,
80         &                uVelInitFile, vVelInitFile, pSurfInitFile,
81         &                dQdTfile
82          CHARACTER*(5) checkPtSuff(maxNoChkptLev)
83          CHARACTER*(MAX_LEN_FNAM) bathyFile, topoFile
84          CHARACTER*(MAX_LEN_FNAM) hydrogThetaFile
85          CHARACTER*(MAX_LEN_FNAM) hydrogSaltFile
86          CHARACTER*(MAX_LEN_FNAM) zonalWindFile
87          CHARACTER*(MAX_LEN_FNAM) meridWindFile
88          CHARACTER*(MAX_LEN_FNAM) thetaClimFile
89          CHARACTER*(MAX_LEN_FNAM) saltClimFile
90          CHARACTER*(MAX_LEN_FNAM) surfQfile
91          CHARACTER*(MAX_LEN_FNAM) surfQswfile
92          CHARACTER*(MAX_LEN_FNAM) EmPmRfile
93          CHARACTER*(MAX_LEN_FNAM) buoyancyRelation
94          CHARACTER*(MAX_LEN_FNAM) uVelInitFile
95          CHARACTER*(MAX_LEN_FNAM) vVelInitFile
96          CHARACTER*(MAX_LEN_FNAM) pSurfInitFile
97          CHARACTER*(MAX_LEN_FNAM) dQdTfile
98    
99  C--   COMMON /PARM_I/ Integer valued parameters used by the model.  C--   COMMON /PARM_I/ Integer valued parameters used by the model.
100  C     cg2dMaxIters        - Maximum number of iterations in the  C     cg2dMaxIters        :: Maximum number of iterations in the
101  C                           two-dimensional con. grad solver.  C                           two-dimensional con. grad solver.
102  C     cg2dChkResFreq      - Frequency with which to check residual  C     cg2dChkResFreq      :: Frequency with which to check residual
103    C                           in con. grad solver.
104    C     cg3dMaxIters        :: Maximum number of iterations in the
105    C                           three-dimensional con. grad solver.
106    C     cg3dChkResFreq      :: Frequency with which to check residual
107  C                           in con. grad solver.  C                           in con. grad solver.
108  C     nIter0              - Start time-step number of for this run  C     nIter0              :: Start time-step number of for this run
109  C     nTimeSteps          - Number of timesteps to execute  C     nTimeSteps          :: Number of timesteps to execute
110  C     numStepsPerPickup   - For offline setup. Frequency of pickup  C     numStepsPerPickup   :: For offline setup. Frequency of pickup
111  C                           of flow fields.  C                           of flow fields.
112    C     writeStatePrec      :: Precision used for writing model state.
113    C     writeBinaryPrec     :: Precision used for writing binary files
114    C     readBinaryPrec      :: Precision used for reading binary files
115    C     nCheckLev           :: Holds current checkpoint level
116    C     nonlinFreeSurf      :: option related to non-linear free surface
117    C                           =0 Linear free surface ; >0 Non-linear
118    
119        COMMON /PARM_I/        COMMON /PARM_I/
120       &        cg2dMaxIters,       &        cg2dMaxIters,
121       &        cg2dChkResFreq,       &        cg2dChkResFreq,
122       &        nIter0, nTimeSteps,       &        cg3dMaxIters,
123       &        numStepsPerPickup       &        cg3dChkResFreq,
124         &        nIter0, nTimeSteps, nEndIter,
125         &        numStepsPerPickup,
126         &        writeStatePrec, nCheckLev,
127         &        writeBinaryPrec, readBinaryPrec,
128         &        nonlinFreeSurf,
129         &        tempAdvScheme, saltAdvScheme, tracerAdvScheme
130        INTEGER cg2dMaxIters        INTEGER cg2dMaxIters
131        INTEGER cg2dChkResFreq        INTEGER cg2dChkResFreq
132          INTEGER cg3dMaxIters
133          INTEGER cg3dChkResFreq
134        INTEGER nIter0        INTEGER nIter0
135        INTEGER nTimeSteps        INTEGER nTimeSteps
136          INTEGER nEndIter
137        INTEGER numStepsPerPickup        INTEGER numStepsPerPickup
138          INTEGER writeStatePrec
139          INTEGER writeBinaryPrec
140          INTEGER readBinaryPrec
141          INTEGER nCheckLev
142          INTEGER nonlinFreeSurf
143          INTEGER tempAdvScheme
144          INTEGER saltAdvScheme
145          INTEGER tracerAdvScheme
146    
147  C--   COMMON /PARM_L/ Logical valued parameters used by the model.  C--   COMMON /PARM_L/ Logical valued parameters used by the model.
148  C     usingCartesianGrid - If TRUE grid generation will be in a cartesian  C     usingCartesianGrid :: If TRUE grid generation will be in a cartesian
149  C                          coordinate frame.  C                          coordinate frame.
150  C     usingSphericalPolarGrid - If TRUE grid generation will be in a  C     usingSphericalPolarGrid :: If TRUE grid generation will be in a
151  C                               spherical polar frame.  C                               spherical polar frame.
152  C     momViscosity  - Flag which turns momentum friction terms on and off.  C     no_slip_sides :: Impose "no-slip" at lateral boundaries.
153  C     momAdvection  - Flag which turns advection of momentum on and off.  C     no_slip_bottom :: Impose "no-slip" at bottom boundary.
154  C     momForcing    - Flag which turns external forcing of momentum on  C     staggerTimeStep :: enable a Stagger time stepping T,S Rho then U,V
155    C     momViscosity  :: Flag which turns momentum friction terms on and off.
156    C     momAdvection  :: Flag which turns advection of momentum on and off.
157    C     momForcing    :: Flag which turns external forcing of momentum on
158  C                     and off.  C                     and off.
159  C     useCoriolis   - Flag which turns the coriolis terms on and off.  C     momPressureForcing :: Flag which turns pressure term in momentum equation
160  C     tempDiffusion - Flag which turns diffusion of temperature on  C                          on and off.
161    C     metricTerms   :: Flag which turns metric terms on or off.
162    C     usingSphericalPolarMTerms :: If TRUE use spherical polar metric terms.
163    C     useCoriolis   :: Flag which turns the coriolis terms on and off.
164    C     tempDiffusion :: Flag which turns diffusion of temperature on
165  C                     and off.  C                     and off.
166  C     tempAdvection - Flag which turns advection of temperature on  C     tempAdvection :: Flag which turns advection of temperature on
167  C                     and off.  C                     and off.
168  C     tempForcing   - Flag which turns external forcing of temperature on  C     tempForcing   :: Flag which turns external forcing of temperature on
169  C                     and off.  C                     and off.
170  C     saltDiffusion - Flag which turns diffusion of salinit on  C     saltDiffusion :: Flag which turns diffusion of salinity on
171  C                     and off.  C                     and off.
172  C     saltAdvection - Flag which turns advection of salinit on  C     saltAdvection :: Flag which turns advection of salinity on
173  C                     and off.  C                     and off.
174  C     saltForcing   - Flag which turns external forcing of salinit on  C     saltForcing   :: Flag which turns external forcing of salinity on
175  C                     and off.  C                     and off.
176    C     useRealFreshWaterFlux :: if true (=Natural BCS), treats P+R-E flux
177    C                         as a real Fresh Water (=> changes the seal level)
178    C                              if false, converts P+R-E to virtual salt flux
179    C     rigidLid            :: Set to true to use rigid lid
180    C     implicitFreeSurface :: Set to true to use implcit free surface
181    C     exactConserv        :: Set to true to conserve exactly the total Volume
182    C     uniformLin_PhiSurf  :: Set to true to use a uniform Bo_surf in the
183    C                           linear relation Phi_surf = Bo_surf*eta
184    C     momStepping   :: Turns momentum equation time-stepping off
185    C     tempStepping  :: Turns temperature equation time-stepping off
186    C     saltStepping  :: Turns salinity equation time-stepping off
187    C     tr1Stepping   :: Turns passive tracer 1 time-stepping on/off
188    C     useConstantF  :: Coriolis parameter set to f0
189    C     useBetaPlaneF :: Coriolis parameter set to f0 + beta.y
190    C     useSphereF    :: Coriolis parameter set to 2.omega.sin(phi)
191    C     implicitDiffusion :: Turns implicit vertical diffusion on
192    C     implicitViscosity :: Turns implicit vertical viscosity on
193    C     doThetaClimRelax :: Set true if relaxation to temperature
194    C                        climatology is required.
195    C     doSaltClimRelax  :: Set true if relaxation to salinity
196    C                        climatology is required.
197    C     periodicExternalForcing :: Set true if forcing is time-dependant
198    C     usingPCoords     :: Set to indicate that we are working in pressure
199    C                        coords.
200    C     usingZCoords     :: Set to indicate that we are working in height
201    C                        coords.
202    C     nonHydrostatic :: Using non-hydrostatic terms
203    C     globalFiles    :: Selects between "global" and "tiled" files
204    C     useSingleCpuIO :: On SGI platforms, option globalFiles is either
205    C                       slow (f77) or does not work (f90).  When
206    C                       useSingleCpuIO is set, mdsio_writefield.F
207    C                       outputs from master mpi process only.
208    C     allowFreezing  :: Allows water to freeze and form ice
209    C     groundAtK1  :: put the surface(k=1) at the Lower Boundary (=ground)
210    C     useJamartWetPoints :: Use wet-point method for Coriolis (Jamart and Ozer, 1986)
211        COMMON /PARM_L/ usingCartesianGrid, usingSphericalPolarGrid,        COMMON /PARM_L/ usingCartesianGrid, usingSphericalPolarGrid,
212       & momViscosity, momAdvection, momForcing, useCoriolis,       & usingCurvilinearGrid,
213         & no_slip_sides,no_slip_bottom,
214         & staggerTimeStep,
215         & momViscosity, momAdvection, momForcing, useCoriolis,
216         & momPressureForcing, vectorInvariantMomentum,
217       & tempDiffusion, tempAdvection, tempForcing,       & tempDiffusion, tempAdvection, tempForcing,
218       & saltDiffusion, saltAdvection, saltForcing       & saltDiffusion, saltAdvection, saltForcing,
219         & useRealFreshWaterFlux,
220         & rigidLid, implicitFreeSurface, exactConserv, uniformLin_PhiSurf,
221         & momStepping, tempStepping, saltStepping, tr1Stepping,
222         & metricTerms, usingSphericalPolarMTerms,
223         & useConstantF, useBetaPlaneF, useSphereF,
224         & implicitDiffusion, implicitViscosity,
225         & doThetaClimRelax, doSaltClimRelax, doTr1ClimRelax,
226         & periodicExternalForcing, usingPCoords, usingZCoords,
227         & nonHydrostatic, globalFiles, useSingleCpuIO,
228         & allowFreezing, groundAtK1,
229         & usePickupBeforeC35, debugMode,
230         & readPickupWithTracer, writePickupWithTracer,
231         & multiDimAdvection, useEnergyConservingCoriolis,
232         & useJamartWetPoints
233        LOGICAL usingCartesianGrid        LOGICAL usingCartesianGrid
234        LOGICAL usingSphericalPolarGrid        LOGICAL usingSphericalPolarGrid
235          LOGICAL usingCurvilinearGrid
236          LOGICAL usingSphericalPolarMTerms
237          LOGICAL no_slip_sides
238          LOGICAL no_slip_bottom
239          LOGICAL staggerTimeStep
240        LOGICAL momViscosity        LOGICAL momViscosity
241        LOGICAL momAdvection        LOGICAL momAdvection
242        LOGICAL momForcing        LOGICAL momForcing
243          LOGICAL momPressureForcing
244        LOGICAL useCoriolis        LOGICAL useCoriolis
245          LOGICAL vectorInvariantMomentum
246        LOGICAL tempDiffusion        LOGICAL tempDiffusion
247        LOGICAL tempAdvection        LOGICAL tempAdvection
248        LOGICAL tempForcing        LOGICAL tempForcing
249        LOGICAL saltDiffusion        LOGICAL saltDiffusion
250        LOGICAL saltAdvection        LOGICAL saltAdvection
251        LOGICAL saltForcing        LOGICAL saltForcing
252          LOGICAL useRealFreshWaterFlux
253          LOGICAL rigidLid
254          LOGICAL implicitFreeSurface
255          LOGICAL exactConserv
256          LOGICAL uniformLin_PhiSurf
257          LOGICAL momStepping
258          LOGICAL tempStepping
259          LOGICAL saltStepping
260          LOGICAL tr1Stepping
261          LOGICAL metricTerms
262          LOGICAL useConstantF
263          LOGICAL useBetaPlaneF
264          LOGICAL useSphereF
265          LOGICAL implicitDiffusion
266          LOGICAL implicitViscosity
267          LOGICAL doThetaClimRelax
268          LOGICAL doSaltClimRelax
269          LOGICAL doTr1ClimRelax
270          LOGICAL periodicExternalForcing
271          LOGICAL usingPCoords
272          LOGICAL usingZCoords
273          LOGICAL nonHydrostatic
274          LOGICAL globalFiles
275          LOGICAL useSingleCpuIO
276          LOGICAL allowFreezing
277          LOGICAL groundAtK1
278          LOGICAL usePickupBeforeC35
279          LOGICAL debugMode
280          LOGICAL readPickupWithTracer
281          LOGICAL writePickupWithTracer
282          LOGICAL multiDimAdvection
283          LOGICAL useEnergyConservingCoriolis
284          LOGICAL useJamartWetPoints
285    
286  C--   COMMON /PARM_R/ "Real" valued parameters used by the model.  C--   COMMON /PARM_R/ "Real" valued parameters used by the model.
287  C     cg2dTargetResidual  C     gg2dTargetResidual
288  C               - Target residual for cg2d solver.  C          :: Target residual for cg2d solver; no unit (RHS normalisation)
289  C     delZ      - Vertical grid spacing (Pa) - delZ is the distance  C     cg2dTargetResWunit
290  C                 between "w" surfaces.  C          :: Target residual for cg2d solver; W unit (No RHS normalisation)
291  C     delX      - Separation between cell faces (m) or (deg), depending  C     cg3dTargetResidual
292    C               :: Target residual for cg3d solver.
293    C     cg2dpcOffDFac :: Averaging weight for preconditioner off-diagonal.
294    C     Note. 20th May 1998
295    C           I made a weird discovery! In the model paper we argue
296    C           for the form of the preconditioner used here ( see
297    C           A Finite-volume, Incompressible Navier-Stokes Model
298    C           ...., Marshall et. al ). The algebra gives a simple
299    C           0.5 factor for the averaging of ac and aCw to get a
300    C           symmettric pre-conditioner. By using a factor of 0.51
301    C           i.e. scaling the off-diagonal terms in the
302    C           preconditioner down slightly I managed to get the
303    C           number of iterations for convergence in a test case to
304    C           drop form 192 -> 134! Need to investigate this further!
305    C           For now I have introduced a parameter cg2dpcOffDFac which
306    C           defaults to 0.51 but can be set at runtime.
307    C     delP      :: Vertical grid spacing ( Pa ).
308    C     delZ      :: Vertical grid spacing ( m  ).
309    C     delR      :: Vertical grid spacing ( units of r ).
310    C     delX      :: Separation between cell faces (m) or (deg), depending
311  C     delY        on input flags.  C     delY        on input flags.
312  C     gravity   - Accel. due to gravity ( m/s^2 )  C     gravity   :: Accel. due to gravity ( m/s^2 )
313  C     ronil     - Reference density  C     recip_gravity and its inverse
314  C     startTime - Start time for model  C     gBaro     :: Accel. due to gravity used in barotropic equation ( m/s^2 )
315  C     oBandBeg  - Offline bands start and end times.  C     ronil     :: Reference density
316  C     oBandEnd  C     rhoConst  :: Vertically constant reference density
317  C     oPeriodLength - Lenght of offline period.  C     startTime :: Start time for model ( s )
318  C     phiMin    - Latitude of southern most cell face.  C     phiMin    :: Latitude of southern most cell face.
319  C     thetaMin  - Longitude of western most cell face (this  C     thetaMin  :: Longitude of western most cell face (this
320  C                 is an "inert" parameter but it is included  C                 is an "inert" parameter but it is included
321  C                 to make geographical references simple.)  C                 to make geographical references simple.)
322  C     rSphere   - Radius of sphere for a spherical polar grid.  C     rSphere   :: Radius of sphere for a spherical polar grid ( m ).
323  C     f0        - Reference coriolis parameter ( 1/s )  C     recip_RSphere  :: Reciprocal radius of sphere ( m ).
324    C     f0        :: Reference coriolis parameter ( 1/s )
325  C                 ( Southern edge f for beta plane )  C                 ( Southern edge f for beta plane )
326  C     beta      - df/dy ( s^-1.m^-1 )  C     beta      :: df/dy ( s^-1.m^-1 )
327  C     viscAh    - Eddy viscosity coeff. for mixing of  C     omega     :: Angular velocity ( rad/s )
328    C     viscAh    :: Eddy viscosity coeff. for mixing of
329  C                 momentum laterally ( m^2/s )  C                 momentum laterally ( m^2/s )
330  C     viscAz    - Eddy viscosity coeff. for mixing of  C     viscAz    :: Eddy viscosity coeff. for mixing of
331  C                 momentum vertically ( m^2/s )  C                 momentum vertically ( m^2/s )
332  C     viscA4    - Biharmonic viscosity coeff. for mixing of  C     viscAp    :: Eddy viscosity coeff. for mixing of
333    C                 momentum vertically ( Pa^2/s )
334    C     viscAr    :: Eddy viscosity coeff. for mixing of
335    C                 momentum vertically ( units of r^2/s )
336    C     viscA4    :: Biharmonic viscosity coeff. for mixing of
337  C                 momentum laterally ( m^4/s )  C                 momentum laterally ( m^4/s )
338  C     diffKhT   - Laplacian diffusion coeff. for mixing of  C     diffKhT   :: Laplacian diffusion coeff. for mixing of
339  C                 heat laterally ( m^2/s )  C                 heat laterally ( m^2/s )
340  C     diffKzT   - Laplacian diffusion coeff. for mixing of  C     diffKzT   :: Laplacian diffusion coeff. for mixing of
341  C                 heat vertically ( m^2/s )  C                 heat vertically ( m^2/s )
342  C     diffK4T   - Biharmonic diffusion coeff. for mixing of  C     diffKpT   :: Laplacian diffusion coeff. for mixing of
343    C                 heat vertically ( Pa^2/s )
344    C     diffKrT   :: Laplacian diffusion coeff. for mixing of
345    C                 heat vertically ( units of r^2/s )
346    C     diffK4T   :: Biharmonic diffusion coeff. for mixing of
347  C                 heat laterally ( m^4/s )  C                 heat laterally ( m^4/s )
348  C     diffKhS  -  Laplacian diffusion coeff. for mixing of  C     diffKhS  ::  Laplacian diffusion coeff. for mixing of
349  C                 salt laterally ( m^2/s )  C                 salt laterally ( m^2/s )
350  C     diffKzS   - Laplacian diffusion coeff. for mixing of  C     diffKzS   :: Laplacian diffusion coeff. for mixing of
351  C                 salt vertically ( m^2/s )  C                 salt vertically ( m^2/s )
352  C     diffK4S   - Biharmonic diffusion coeff. for mixing of  C     diffKpS   :: Laplacian diffusion coeff. for mixing of
353    C                 salt vertically ( Pa^2/s )
354    C     diffKrS   :: Laplacian diffusion coeff. for mixing of
355    C                 salt vertically ( units of r^2/s )
356    C     diffK4S   :: Biharmonic diffusion coeff. for mixing of
357  C                 salt laterally ( m^4/s )  C                 salt laterally ( m^4/s )
358  C     delt      - Timestep ( s )  C     deltaT    :: Default timestep ( s )
359  C     tauCD     - CD scheme coupling timescale ( 1/s )  C     deltaTClock  :: Timestep used as model "clock". This determines the
360  C     rCD       - CD scheme normalised coupling parameter ( 0-1 )  C                    IO frequencies and is used in tagging output. It can
361  C     startTime - Starting time for this integration ( s ).  C                    be totally different to the dynamical time. Typically
362  C     endTime   - Ending time for this integration ( s ).  C                    it will be the deep-water timestep for accelerated runs.
363  C     chkPtFreq - Frequency of check pointing ( s ).  C                    Frequency of checkpointing and dumping of the model state
364  C     dumpFreq  - Frequency with which model state is written to  C                    are referenced to this clock. ( s )
365  C                 post-processing files ( s ).  C     deltaTMom    :: Timestep for momemtum equations ( s )
366        COMMON /PARM_R/ cg2dTargetResidual, delZ, delX, delY,  C     deltaTtracer :: Timestep for tracer equations ( s )
367       & deltaTmom, deltaTtracer, abeps, startTime, oBandBeg, oBandEnd,  C     freesurfFac  :: Parameter to turn implicit free surface term on or off
368       & oPeriodLength, phiMin, thetaMin, rSphere, f0, fCori, beta,  C                    freesurfac = 1. uses implicit free surface
369       & viscAh, viscAz, viscA4, diffKhT, diffKzT, diffK4T,  C                    freesurfac = 0. uses rigid lid
370       & diffKhS, diffKzS, diffK4S, delT, tauCD, rCD,  C     implicSurfPress :: parameter of the Crank-Nickelson time stepping :
371       & tAlpha, sBeta, gravity, rhonil, tRef, sRef,  C                     Implicit part of Surface Pressure Gradient ( 0-1 )
372       & endTime, chkPtFreq, dumpFreq  C     implicDiv2Dflow :: parameter of the Crank-Nickelson time stepping :
373        REAL cg2dTargetResidual  C                     Implicit part of barotropic flow Divergence ( 0-1 )
374        REAL delZ(Nz)  C     hFacMin      :: Minimum fraction size of a cell (affects hFacC etc...)
375        REAL delX(Nx)  C     hFacMinDz    :: Minimum dimesional size of a cell (affects hFacC etc..., m)
376        REAL delY(Ny)  C     hFacMinDp    :: Minimum dimesional size of a cell (affects hFacC etc..., Pa)
377        REAL deltaTmom  C     hFacMinDr    :: Minimum dimesional size of a cell (affects hFacC etc..., units of r)
378        REAL deltaTtracer  C     hFacInf      :: Threshold (inf and sup) for fraction size of surface cell
379        REAL abeps  C     hFacSup        that control vanishing and creating levels
380        REAL oBandBeg(nOBands),oBandEnd(nOBands)  C     tauCD        :: CD scheme coupling timescale ( 1/s )
381        REAL oPeriodLength  C     rCD          :: CD scheme normalised coupling parameter ( 0-1 )
382        REAL phiMin  C     startTime     :: Starting time for this integration ( s ).
383        REAL thetaMin  C     endTime       :: Ending time for this integration ( s ).
384        REAL rSphere  C     chkPtFreq     :: Frequency of rolling check pointing ( s ).
385        REAL f0  C     pChkPtFreq    :: Frequency of permanent check pointing ( s ).
386        _RL  beta  C     dumpFreq      :: Frequency with which model state is written to
387        REAL viscAh  C                     post-processing files ( s ).
388        REAL viscAz  C     tr1dumpFreq   :: dumpFreq for passive tracer field (s)
389        REAL viscA4  C     diagFreq      :: Frequency with which model writes diagnostic output
390        REAL diffKhT  C                     of intermediate quantities.
391        REAL diffKzT  C     afFacMom      :: Advection of momentum term tracer parameter
392        REAL diffK4T  C     vfFacMom      :: Momentum viscosity tracer parameter
393        REAL diffKhS  C     pfFacMom      :: Momentum pressure forcing tracer parameter
394        REAL diffKzS  C     cfFacMom      :: Coriolis term tracer parameter
395        REAL diffK4S  C     foFacMom      :: Momentum forcing tracer parameter
396        REAL delt  C     mtFacMom      :: Metric terms tracer parameter
397        REAL tauCD  C     cosPower      :: Power of cosine of latitude to multiply viscosity
398        REAL rCD  C     cAdjFreq      :: Frequency of convective adjustment
399        REAL tAlpha  C
400        REAL sBeta  C     taveFreq      :: Frequency with which time-averaged model state is written to
401        REAL gravity  C                     post-processing files ( s ).
402        REAL rhonil  C     tauThetaClimRelax :: Relaxation to climatology time scale ( s ).
403        REAL tRef(Nz)  C     lambdaThetaClimRelax :: Inverse time scale for relaxation ( 1/s ).
404        REAL sRef(Nz)  C     tauSaltClimRelax :: Relaxation to climatology time scale ( s ).
405        real Fcori(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)  C     lambdaSaltClimRelax :: Inverse time scale for relaxation ( 1/s ).
406        REAL startTime  C     externForcingPeriod :: Is the period of which forcing varies (eg. 1 month)
407        REAL endTime  C     externForcingCycle :: Is the repeat time of the forcing (eg. 1 year)
408        REAL chkPtFreq  C                          (note: externForcingCycle must be an integer
409        REAL dumpFreq  C                           number times externForcingPeriod)
410        COMMON /PARM_A/ HeatCapacity_Cp,  C     convertFW2Salt :: salinity, used to convert Fresh-Water Flux to Salt Flux
411    C                       (use model surface (local) value if set to -1)
412    C     temp_EvPrRn :: temperature of Rain & Evap.
413    C     salt_EvPrRn :: salinity of Rain & Evap.
414    C     trac_EvPrRn :: tracer concentration in Rain & Evap.
415    C        (notes: a) tracer content of Rain/Evap only used if both
416    C                     NonLin_FrSurf & useRealFreshWater are set.
417    C                b) use model surface (local) value if set to UNSET_RL)
418    C     horiVertRatio      :: Ratio on units in vertical to units in horizontal.
419    C     recip_horiVertRatio  ( 1 if horiz in m and vertical in m ).
420    C                          ( g*rho if horiz in m and vertical in Pa ).
421    C     Ro_SeaLevel        :: standard position of Sea-Level in "R" coordinate, used as
422    C                          starting value (k=1) for vertical coordinate (rf(1)=Ro_SeaLevel)
423    C     bottomDragLinear   :: Drag coefficient built in to core dynamics
424    C      --"-"--  Quadratic  ( linear: 1/s, quadratic: 1/m )
425          COMMON /PARM_R/ cg2dTargetResidual, cg2dTargetResWunit,
426         & cg2dpcOffDFac, cg3dTargetResidual,
427         & delP, delZ, delR, delX, delY,
428         & deltaT,deltaTmom, deltaTtracer, deltaTClock,abeps, startTime,
429         & phiMin, thetaMin, rSphere, recip_RSphere, f0, beta,
430         & fCori, fCoriG,
431         & viscAh,  viscAz,  viscA4,  viscAr, viscAstrain, viscAtension,
432         & diffKhT, diffKzT, diffK4T, diffKrT,
433         & diffKhS, diffKzS, diffK4S, diffKrS,
434         & delT, tauCD, rCD, freeSurfFac, implicSurfPress, implicDiv2Dflow,
435         & hFacMin, hFacMinDz, hFacInf, hFacSup,
436         & gravity, recip_Gravity, gBaro, rhonil, recip_rhonil,
437         & recip_rhoConst, rhoConst, tRef, sRef,
438         & endTime, chkPtFreq, pchkPtFreq, dumpFreq, tr1dumpFreq,
439         & diagFreq, taveFreq, monitorFreq,
440         & afFacMom, vfFacMom, pfFacMom, cfFacMom, foFacMom, mtFacMom,
441         & cosPower, cAdjFreq, omega,
442         & tauThetaClimRelax, lambdaThetaClimRelax,
443         & tauSaltClimRelax, lambdaSaltClimRelax,
444         & tauTr1ClimRelax, lambdaTr1ClimRelax,
445         & externForcingCycle, externForcingPeriod,
446         & convertFW2Salt, temp_EvPrRn, salt_EvPrRn, trac_EvPrRn,
447         & viscAp, diffKpT, diffKpS, hFacMinDr, hFacMinDp,
448         & horiVertRatio, recip_horiVertRatio,
449         & ivdc_kappa, Ro_SeaLevel,
450         & bottomDragLinear,bottomDragQuadratic
451    
452          _RL cg2dTargetResidual
453          _RL cg2dTargetResWunit
454          _RL cg3dTargetResidual
455          _RL cg2dpcOffDFac
456          _RL delZ(Nr)
457          _RL delP(Nr)
458          _RL delR(Nr)
459          _RL delX(Nx)
460          _RL delY(Ny)
461          _RL deltaT
462          _RL deltaTClock
463          _RL deltaTmom
464          _RL deltaTtracer
465          _RL abeps
466          _RL phiMin
467          _RL thetaMin
468          _RL rSphere
469          _RL recip_RSphere
470          _RL f0
471          _RL freeSurfFac
472          _RL implicSurfPress
473          _RL implicDiv2Dflow
474          _RL hFacMin
475          _RL hFacMinDz
476          _RL hFacMinDp
477          _RL hFacMinDr
478          _RL hFacInf
479          _RL hFacSup
480          _RL beta
481          _RL viscAh
482          _RL viscAstrain
483          _RL viscAtension
484          _RL viscAz
485          _RL viscAp
486          _RL viscAr
487          _RL viscA4
488          _RL diffKhT
489          _RL diffKrT
490          _RL diffKzT
491          _RL diffKpT
492          _RL diffK4T
493          _RL diffKhS
494          _RL diffKrS
495          _RL diffKzS
496          _RL diffKpS
497          _RL diffK4S
498          _RL delt
499          _RL tauCD
500          _RL rCD
501          _RL gravity
502          _RL recip_gravity
503          _RL gBaro
504          _RL rhonil
505          _RL recip_rhonil
506          _RL rhoConst
507          _RL recip_rhoConst
508          _RL tRef(Nr)
509          _RL sRef(Nr)
510          _RS fCori(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
511          _RS fCoriG(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
512          _RL startTime
513          _RL endTime
514          _RL chkPtFreq
515          _RL pChkPtFreq
516          _RL dumpFreq
517          _RL tr1dumpFreq
518          _RL diagFreq
519          _RL taveFreq
520          _RL monitorFreq
521          _RL afFacMom
522          _RL vfFacMom
523          _RL pfFacMom
524          _RL cfFacMom
525          _RL foFacMom
526          _RL mTFacMom
527          _RL cosPower
528          _RL cAdjFreq
529          _RL omega
530          _RL tauThetaClimRelax
531          _RL lambdaThetaClimRelax
532          _RL tauSaltClimRelax
533          _RL lambdaSaltClimRelax
534          _RL tauTr1ClimRelax
535          _RL lambdaTr1ClimRelax
536          _RL externForcingCycle
537          _RL externForcingPeriod
538          _RL convertFW2Salt
539          _RL temp_EvPrRn
540          _RL salt_EvPrRn
541          _RL trac_EvPrRn
542          _RL horiVertRatio
543          _RL recip_horiVertRatio
544          _RL ivdc_kappa
545          _RL Ro_SeaLevel
546          _RL bottomDragLinear
547          _RL bottomDragQuadratic
548    
549          COMMON /PARM_A/ HeatCapacity_Cp,recip_Cp,
550       &                Lamba_theta       &                Lamba_theta
551        REAL HeatCapacity_Cp        _RL HeatCapacity_Cp
552        REAL Lamba_theta        _RL Lamba_theta
553          _RL recip_Cp
554    
555    C Equation of State (polynomial coeffients)
556          COMMON /PARM_EOS_NL/ eosC,eosSig0,eosRefT,eosRefS
557          _RL eosC(9,Nr+1),eosSig0(Nr+1),eosRefT(Nr+1),eosRefS(Nr+1)
558    C Linear equation of state
559    C     tAlpha    :: Linear EOS thermal expansion coefficient ( 1/degree ).
560    C     sBeta     :: Linear EOS haline contraction coefficient.
561          COMMON /PARM_EOS_LIN/ tAlpha,sBeta,eosType
562          _RL tAlpha
563          _RL sBeta
564          character*(6) eosType
565    
566    C Atmospheric physical parameters (Ideal Gas EOS, ...)
567    C     atm_po    :: standard reference pressure
568    C     atm_cp    :: specific heat (Cp) of the (dry) air at constant pressure
569    C     atm_kappa :: kappa = R/Cp (R: constant of Ideal Gas EOS)
570    C     Integr_GeoPot :: option to select the way we integrate the geopotential
571    C                     (still a subject of discussions ...)
572          COMMON /PARM_ATM/ atm_cp, atm_kappa, atm_po,
573         &                  Integr_GeoPot
574          _RL atm_cp, atm_kappa, atm_po
575          INTEGER Integr_GeoPot
576    
577    C Logical flags for selecting packages
578          LOGICAL useKPP
579          LOGICAL useGMRedi
580          LOGICAL useOBCS
581          LOGICAL useAIM
582          LOGICAL useGrdchk
583          LOGICAL useECCO
584          LOGICAL useSHAP_FILT
585          LOGICAL useZONAL_FILT
586          LOGICAL useFLT
587          LOGICAL useSBO
588          LOGICAL useSEAICE
589          LOGICAL useDirectSolver
590          COMMON /PARM_PACKAGES/
591         &        useKPP, useGMRedi, useOBCS, useAIM, useECCO,
592         &        useSHAP_FILT, useZONAL_FILT, useGrdchk, useFLT,
593         &        useSBO, useSEAICE, useDirectSolver

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.65.2.8

  ViewVC Help
Powered by ViewVC 1.1.22