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

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

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

-revision 1.79 by adcroft,
Thu Nov  7 21:51:15 2002 UTC
+revision 1.140 by mlosch,
Thu Dec  9 09:01:07 2004 UTC
 Line 1
  C $Header$
  C $Name$
  C
  CBOP
- C    !ROUTINE: PARAMS.h
+ C     !ROUTINE: PARAMS.h
- C    !INTERFACE:
+ C     !INTERFACE:
- C    include PARAMS.h
+ C     #include PARAMS.h
- C    !DESCRIPTION: \bv
- C     *==========================================================*
+ C     !DESCRIPTION:
- C     | PARAMS.h
+ C     Header file defining model "parameters".  The values from the
- C     | o Header file defining model "parameters".
+ C     model standard input file are stored into the variables held
- C     *==========================================================*
+ C     here. Notes describing the parameters can also be found here.
- C     | The values from the model standard input file are
- C     | stored into the variables held here. Notes describing
- C     | the parameters can also be found here.
- C     *==========================================================*
- C     \ev
  CEOP
  C     Macros for special grid options
-Line 65 
 C     thetaClimFile   :: File containing
+Line 62 
 C     thetaClimFile   :: File containing
  C                       in relaxation term -lambda(theta-theta*)
  C     saltClimFile    :: File containing salt climataology used
  C                       in relaxation term -lambda(salt-salt*)
- C     surfQfile       :: File containing surface heat flux
+ C     surfQfile       :: File containing surface heat flux, excluding SW
- C     surfQswfile     :: File containing surface shortwave radiation
+ C                        (old version, kept for backward compatibility)
+ C     surfQnetFile    :: File containing surface net heat flux
+ C     surfQswFile     :: File containing surface shortwave radiation
  C     dQdTfile        :: File containing thermal relaxation coefficient
  C     EmPmRfile       :: File containing surface fresh water flux
  C     pLoadFile       :: File containing pressure loading
  C     buoyancyRelation :: Flag used to indicate which relation to use to
  C                        get buoyancy.
  C     eosType         :: choose the equation of state:
- C                        LINEAR, POLY3, UNESCO, JMD95Z, JMD95P
+ C                        LINEAR, POLY3, UNESCO, JMD95Z, JMD95P, MDJWF, IDEALGAS
+ C     the_run_name    :: string identifying the name of the model "run"
        COMMON /PARM_C/ checkPtSuff,
       &                bathyFile, topoFile,
       &                hydrogThetaFile, hydrogSaltFile,
       &                zonalWindFile, meridWindFile, thetaClimFile,
       &                saltClimFile, buoyancyRelation,
-      &                EmPmRfile, surfQfile, surfQswfile,
+      &                EmPmRfile, surfQfile, surfQnetFile, surfQswFile,
       &                uVelInitFile, vVelInitFile, pSurfInitFile,
       &                dQdTfile, ploadFile,
-      &                eosType
+      &                eosType, pickupSuff,
+      &                mdsioLocalDir,
+      &                the_run_name
        CHARACTER*(5) checkPtSuff(maxNoChkptLev)
        CHARACTER*(MAX_LEN_FNAM) bathyFile, topoFile
        CHARACTER*(MAX_LEN_FNAM) hydrogThetaFile
-Line 92 
 C                        LINEAR, POLY3,
+Line 94 
 C                        LINEAR, POLY3,
        CHARACTER*(MAX_LEN_FNAM) thetaClimFile
        CHARACTER*(MAX_LEN_FNAM) saltClimFile
        CHARACTER*(MAX_LEN_FNAM) surfQfile
-       CHARACTER*(MAX_LEN_FNAM) surfQswfile
+       CHARACTER*(MAX_LEN_FNAM) surfQnetFile
+       CHARACTER*(MAX_LEN_FNAM) surfQswFile
        CHARACTER*(MAX_LEN_FNAM) EmPmRfile
        CHARACTER*(MAX_LEN_FNAM) buoyancyRelation
        CHARACTER*(MAX_LEN_FNAM) uVelInitFile
-Line 100 
 C                        LINEAR, POLY3,
+Line 103 
 C                        LINEAR, POLY3,
        CHARACTER*(MAX_LEN_FNAM) pSurfInitFile
        CHARACTER*(MAX_LEN_FNAM) dQdTfile
        CHARACTER*(MAX_LEN_FNAM) ploadFile
+       CHARACTER*(MAX_LEN_FNAM) mdsioLocalDir
+       CHARACTER*(MAX_LEN_FNAM) the_run_name
        CHARACTER*(6) eosType
+       CHARACTER*(10) pickupSuff
  C--   COMMON /PARM_I/ Integer valued parameters used by the model.
  C     cg2dMaxIters        :: Maximum number of iterations in the
  C                           two-dimensional con. grad solver.
  C     cg2dChkResFreq      :: Frequency with which to check residual
  C                           in con. grad solver.
+ C     cg2dPreCondFreq     :: Frequency for updating cg2d preconditioner
+ C                            (non-linear free-surf.)
  C     cg3dMaxIters        :: Maximum number of iterations in the
  C                           three-dimensional con. grad solver.
  C     cg3dChkResFreq      :: Frequency with which to check residual
-Line 121 
 C     readBinaryPrec      :: Precision u
+Line 129 
 C     readBinaryPrec      :: Precision u
  C     nCheckLev           :: Holds current checkpoint level
  C     nonlinFreeSurf      :: option related to non-linear free surface
  C                           =0 Linear free surface ; >0 Non-linear
+ C     select_rStar        :: option related to r* vertical coordinate
+ C                           =0 (default) use r coord. ; > 0 use r*
+ C     tempAdvScheme       :: Temp. Horiz.Advection scheme selector
+ C     tempVertAdvScheme   :: Temp. Vert. Advection scheme selector
+ C     saltAdvScheme       :: Salt. Horiz.advection scheme selector
+ C     saltVertAdvScheme   :: Salt. Vert. Advection scheme selector
+ C     debugLevel          :: debug level selector: higher -> more writing
        COMMON /PARM_I/
       &        cg2dMaxIters,
-      &        cg2dChkResFreq,
+      &        cg2dChkResFreq, cg2dPreCondFreq,
       &        cg3dMaxIters,
       &        cg3dChkResFreq,
       &        nIter0, nTimeSteps, nEndIter,
       &        numStepsPerPickup,
       &        writeStatePrec, nCheckLev,
       &        writeBinaryPrec, readBinaryPrec,
-      &        nonlinFreeSurf,
+      &        nonlinFreeSurf, select_rStar,
-      &        tempAdvScheme, saltAdvScheme, tracerAdvScheme
+      &        tempAdvScheme, tempVertAdvScheme,
+      &        saltAdvScheme, saltVertAdvScheme,
+      &        debugLevel
        INTEGER cg2dMaxIters
        INTEGER cg2dChkResFreq
+       INTEGER cg2dPreCondFreq
        INTEGER cg3dMaxIters
        INTEGER cg3dChkResFreq
        INTEGER nIter0
-Line 146 
 C                           =0 Linear fr
+Line 164 
 C                           =0 Linear fr
        INTEGER readBinaryPrec
        INTEGER nCheckLev
        INTEGER nonlinFreeSurf
-       INTEGER tempAdvScheme
+       INTEGER select_rStar
-       INTEGER saltAdvScheme
+       INTEGER tempAdvScheme, tempVertAdvScheme
-       INTEGER tracerAdvScheme
+       INTEGER saltAdvScheme, saltVertAdvScheme
+       INTEGER debugLevel
+ C
+       INTEGER debLevZero
+       PARAMETER(debLevZero=0)
+       INTEGER debLevA
+       PARAMETER(debLevA=1)
+       INTEGER debLevB
+       PARAMETER(debLevB=2)
  C--   COMMON /PARM_L/ Logical valued parameters used by the model.
  C     usingCartesianGrid :: If TRUE grid generation will be in a cartesian
  C                          coordinate frame.
  C     usingSphericalPolarGrid :: If TRUE grid generation will be in a
  C                               spherical polar frame.
+ C     usingCylindricalGrid :: If TRUE grid generation will be Cylindrical
  C     no_slip_sides :: Impose "no-slip" at lateral boundaries.
  C     no_slip_bottom :: Impose "no-slip" at bottom boundary.
  C     staggerTimeStep :: enable a Stagger time stepping T,S Rho then U,V
-Line 168 
 C     metricTerms   :: Flag which turns
+Line 196 
 C     metricTerms   :: Flag which turns
  C     usingSphericalPolarMTerms :: If TRUE use spherical polar metric terms.
  C     useNHMTerms :: If TRUE use non-hydrostatic metric terms.
  C     useCoriolis   :: Flag which turns the coriolis terms on and off.
- C     tempDiffusion :: Flag which turns diffusion of temperature on
- C                     and off.
  C     tempAdvection :: Flag which turns advection of temperature on
  C                     and off.
  C     tempForcing   :: Flag which turns external forcing of temperature on
  C                     and off.
- C     saltDiffusion :: Flag which turns diffusion of salinity on
- C                     and off.
  C     saltAdvection :: Flag which turns advection of salinity on
  C                     and off.
  C     saltForcing   :: Flag which turns external forcing of salinity on
-Line 191 
 C                           linear relat
+Line 215 
 C                           linear relat
  C     momStepping   :: Turns momentum equation time-stepping off
  C     tempStepping  :: Turns temperature equation time-stepping off
  C     saltStepping  :: Turns salinity equation time-stepping off
- C     tr1Stepping   :: Turns passive tracer 1 time-stepping on/off
  C     useConstantF  :: Coriolis parameter set to f0
  C     useBetaPlaneF :: Coriolis parameter set to f0 + beta.y
  C     useSphereF    :: Coriolis parameter set to 2.omega.sin(phi)
+ C     useCDscheme   :: use CD-scheme to calculate Coriolis terms.
  C     useJamartWetPoints :: Use wet-point method for Coriolis (Jamart and Ozer, 1986)
+ C     useJamartMomAdv :: Use wet-point method for V.I. non-linear term
+ C     SadournyCoriolis :: use the enstrophy conserving scheme by Sadourny
+ C     upwindVorticity :: bias interpolation of vorticity in the Coriolis term
+ C     highOrderVorticity :: use 3rd/4th order interp. of vorticity in Coriolis
+ C     useAbsVorticity :: work with f+zeta in Coriolis terms
  C     implicitDiffusion :: Turns implicit vertical diffusion on
  C     implicitViscosity :: Turns implicit vertical viscosity on
+ C     tempImplVertAdv :: Turns on implicit vertical advection for Temperature
+ C     saltImplVertAdv :: Turns on implicit vertical advection for Salinity
+ C     momImplVertAdv  :: Turns on implicit vertical advection for Momentum
  C     multiDimAdvection :: Flag that enable multi-dimension advection
+ C     useMultiDimAdvec  :: True if multi-dim advection is used at least once
  C     forcing_In_AB :: if False, put forcing (Temp,Salt,Tracers) contribution
  C                      out off Adams-Bashforth time stepping.
  C     doThetaClimRelax :: Set true if relaxation to temperature
-Line 206 
 C                        climatology is
+Line 239 
 C                        climatology is
  C     doSaltClimRelax  :: Set true if relaxation to salinity
  C                        climatology is required.
  C     periodicExternalForcing :: Set true if forcing is time-dependant
- C     usingPCoords     :: Set to indicate that we are working in pressure
+ C     usingPCoords     :: Set to indicate that we are working in a pressure
- C                        coords.
+ C                        type coordinate (p or p*).
- C     usingZCoords     :: Set to indicate that we are working in height
+ C     usingZCoords     :: Set to indicate that we are working in a height
- C                        coords.
+ C                        type coordinate (z or z*)
+ C     fluidIsAir       :: Set to indicate that the fluid major constituent
+ C                        is air
+ C     fluidIsWater     :: Set to indicate that the fluid major constituent
+ C                        is water
+ C     useDynP_inEos_Zc :: use the dynamical pressure in EOS (with Z-coord.)
+ C                         this requires specific code for restart & exchange
  C     setCenterDr    :: set cell Center depth and put Interface at the middle
  C     nonHydrostatic :: Using non-hydrostatic terms
  C     quasiHydrostatic :: Using non-hydrostatic terms in hydrostatic algorithm
  C     globalFiles    :: Selects between "global" and "tiled" files
- C     allowFreezing  :: Allows water to freeze and form ice
+ C     useSingleCpuIO :: On SGI platforms, option globalFiles is either
+ C                       slow (f77) or does not work (f90).  When
+ C                       useSingleCpuIO is set, mdsio_writefield.F
+ C                       outputs from master mpi process only.
+ C     allowFreezing  :: Allows surface water to freeze and form ice
+ C     useOldFreezing :: use the old version (before checkpoint52a_pre, 2003-11-12)
  C     groundAtK1  :: put the surface(k=1) at the Lower Boundary (=ground)
+ C     pickup_write_mdsio :: use mdsio to write pickups
+ C     pickup_read_mdsio  :: use mdsio to read  pickups
+ C     pickup_write_immed :: echo the pickup immediately (for conversion)
+ C     timeave_mdsio      :: use mdsio for timeave output
+ C     snapshot_mdsio     :: use mdsio for "snapshot" (dumpfreq/diagfreq) output
+ C     monitor_stdio      :: use stdio for monitor output
        COMMON /PARM_L/ usingCartesianGrid, usingSphericalPolarGrid,
-      & usingCurvilinearGrid,
+      & usingCurvilinearGrid, usingCylindricalGrid,
       & no_slip_sides,no_slip_bottom,
       & staggerTimeStep,
       & momViscosity, momAdvection, momForcing, useCoriolis,
       & momPressureForcing, vectorInvariantMomentum,
-      & tempDiffusion, tempAdvection, tempForcing,
+      & tempAdvection, tempForcing,
-      & saltDiffusion, saltAdvection, saltForcing,
+      & saltAdvection, saltForcing,
       & useRealFreshWaterFlux,
       & rigidLid, implicitFreeSurface, exactConserv, uniformLin_PhiSurf,
-      & momStepping, tempStepping, saltStepping, tr1Stepping,
+      & momStepping, tempStepping, saltStepping,
       & metricTerms, usingSphericalPolarMTerms, useNHMTerms,
       & useConstantF, useBetaPlaneF, useSphereF,
-      & useEnergyConservingCoriolis, useJamartWetPoints,
+      & useCDscheme,
+      & useEnergyConservingCoriolis, useJamartWetPoints, useJamartMomAdv,
+      & SadournyCoriolis, upwindVorticity, highOrderVorticity,
+      & useAbsVorticity,
       & implicitDiffusion, implicitViscosity,
-      & multiDimAdvection, forcing_In_AB,
+      & tempImplVertAdv, saltImplVertAdv, momImplVertAdv,
+      & multiDimAdvection, useMultiDimAdvec, forcing_In_AB,
       & doThetaClimRelax, doSaltClimRelax, doTr1ClimRelax,
       & periodicExternalForcing,
-      & usingPCoords, usingZCoords, setCenterDr,
+      & fluidIsAir, fluidIsWater,
-      & nonHydrostatic, quasiHydrostatic, globalFiles,
+      & usingPCoords, usingZCoords, useDynP_inEos_Zc, setCenterDr,
-      & allowFreezing, groundAtK1,
+      & nonHydrostatic, quasiHydrostatic, globalFiles, useSingleCpuIO,
-      & usePickupBeforeC35, debugMode,
+      & allowFreezing, useOldFreezing, groundAtK1,
-      & readPickupWithTracer, writePickupWithTracer
+      & usePickupBeforeC35, usePickupBeforeC54, debugMode,
+      & readPickupWithTracer, writePickupWithTracer,
+      & pickup_read_mdsio, pickup_write_mdsio, pickup_write_immed,
+      & timeave_mdsio, snapshot_mdsio, monitor_stdio,
+      & outputTypesInclusive
        LOGICAL usingCartesianGrid
        LOGICAL usingSphericalPolarGrid
+       LOGICAL usingCylindricalGrid
        LOGICAL usingCurvilinearGrid
        LOGICAL usingSphericalPolarMTerms
        LOGICAL useNHMTerms
-Line 253 
 C     groundAtK1  :: put the surface(k=1
+Line 313 
 C     groundAtK1  :: put the surface(k=1
        LOGICAL momPressureForcing
        LOGICAL useCoriolis
        LOGICAL vectorInvariantMomentum
-       LOGICAL tempDiffusion
        LOGICAL tempAdvection
        LOGICAL tempForcing
-       LOGICAL saltDiffusion
        LOGICAL saltAdvection
        LOGICAL saltForcing
        LOGICAL useRealFreshWaterFlux
-Line 267 
 C     groundAtK1  :: put the surface(k=1
+Line 325 
 C     groundAtK1  :: put the surface(k=1
        LOGICAL momStepping
        LOGICAL tempStepping
        LOGICAL saltStepping
-       LOGICAL tr1Stepping
        LOGICAL metricTerms
        LOGICAL useConstantF
        LOGICAL useBetaPlaneF
        LOGICAL useSphereF
+       LOGICAL useCDscheme
        LOGICAL useEnergyConservingCoriolis
        LOGICAL useJamartWetPoints
+       LOGICAL useJamartMomAdv
+       LOGICAL SadournyCoriolis
+       LOGICAL upwindVorticity
+       LOGICAL highOrderVorticity
+       LOGICAL useAbsVorticity
        LOGICAL implicitDiffusion
        LOGICAL implicitViscosity
+       LOGICAL tempImplVertAdv
+       LOGICAL saltImplVertAdv
+       LOGICAL momImplVertAdv
        LOGICAL multiDimAdvection
+       LOGICAL useMultiDimAdvec
        LOGICAL forcing_In_AB
        LOGICAL doThetaClimRelax
        LOGICAL doSaltClimRelax
        LOGICAL doTr1ClimRelax
        LOGICAL periodicExternalForcing
+       LOGICAL fluidIsAir
+       LOGICAL fluidIsWater
        LOGICAL usingPCoords
        LOGICAL usingZCoords
+       LOGICAL useDynP_inEos_Zc
        LOGICAL setCenterDr
        LOGICAL nonHydrostatic
        LOGICAL quasiHydrostatic
        LOGICAL globalFiles
+       LOGICAL useSingleCpuIO
        LOGICAL allowFreezing
+       LOGICAL useOldFreezing
        LOGICAL groundAtK1
        LOGICAL usePickupBeforeC35
+       LOGICAL usePickupBeforeC54
        LOGICAL debugMode
        LOGICAL readPickupWithTracer
        LOGICAL writePickupWithTracer
+       LOGICAL pickup_read_mdsio, pickup_write_mdsio
+       LOGICAL pickup_write_immed
+       LOGICAL timeave_mdsio, snapshot_mdsio, monitor_stdio
+       LOGICAL outputTypesInclusive
  C--   COMMON /PARM_R/ "Real" valued parameters used by the model.
- C     gg2dTargetResidual
+ C     cg2dTargetResidual
  C          :: Target residual for cg2d solver; no unit (RHS normalisation)
  C     cg2dTargetResWunit
  C          :: Target residual for cg2d solver; W unit (No RHS normalisation)
-Line 316 
 C           number of iterations for con
+Line 393 
 C           number of iterations for con
  C           drop form 192 -> 134! Need to investigate this further!
  C           For now I have introduced a parameter cg2dpcOffDFac which
  C           defaults to 0.51 but can be set at runtime.
- C     delP      :: Vertical grid spacing ( Pa ).
- C     delZ      :: Vertical grid spacing ( m  ).
  C     delR      :: Vertical grid spacing ( units of r ).
  C     delRc     :: Vertical grid spacing between cell centers (r unit).
  C     delX      :: Separation between cell faces (m) or (deg), depending
-Line 328 
 C     gBaro     :: Accel. due to gravity
+Line 403 
 C     gBaro     :: Accel. due to gravity
  C     rhoNil    :: Reference density for the linear equation of state
  C     rhoConst  :: Vertically constant reference density
  C     rhoConstFresh :: Constant reference density for fresh water (rain)
+ C     tRef      :: reference vertical profile for potential temperature
+ C     sRef      :: reference vertical profile for salinity/specific humidity
  C     startTime :: Start time for model ( s )
  C     phiMin    :: Latitude of southern most cell face.
  C     thetaMin  :: Longitude of western most cell face (this
-Line 339 
 C     f0        :: Reference coriolis pa
+Line 416 
 C     f0        :: Reference coriolis pa
  C                 ( Southern edge f for beta plane )
  C     beta      :: df/dy ( s^-1.m^-1 )
  C     omega     :: Angular velocity ( rad/s )
+ C     rotationPeriod :: Rotation period (s) (= 2.pi/omega)
  C     viscAh    :: Eddy viscosity coeff. for mixing of
  C                 momentum laterally ( m^2/s )
- C     viscAz    :: Eddy viscosity coeff. for mixing of
+ C     viscAhW   :: Eddy viscosity coeff. for mixing of vertical
- C                 momentum vertically ( m^2/s )
+ C                 momentum laterally, no effect for hydrostatic
- C     viscAp    :: Eddy viscosity coeff. for mixing of
+ C                 model, defaults to viscAh if unset ( m^2/s )
- C                 momentum vertically ( Pa^2/s )
  C     viscAr    :: Eddy viscosity coeff. for mixing of
  C                 momentum vertically ( units of r^2/s )
  C     viscA4    :: Biharmonic viscosity coeff. for mixing of
  C                 momentum laterally ( m^4/s )
+ C     viscA4W   :: Biharmonic viscosity coeff. for mixing of vertical
+ C                 momentum laterally, no effect for hydrostatic
+ C                 model, defaults to viscA4 if unset ( m^2/s )
+ C     viscAhD   :: Eddy viscosity coeff. for mixing of momentum laterally
+ C                  (act on Divergence part) ( m^2/s )
+ C     viscAhZ   :: Eddy viscosity coeff. for mixing of momentum laterally
+ C                  (act on Vorticity  part) ( m^2/s )
+ C     viscA4D   :: Biharmonic viscosity coeff. for mixing of momentum laterally
+ C                  (act on Divergence part) ( m^4/s )
+ C     viscA4Z   :: Biharmonic viscosity coeff. for mixing of momentum laterally
+ C                  (act on Vorticity  part) ( m^4/s )
+ C     viscC2leith :: Leith non-dimensional viscosity factor
+ C     viscAhMax :: Maximum eddy viscosity coeff. for mixing of
+ C                 momentum laterally ( m^2/s )
+ C     viscA4Max :: Maximum biharmonic viscosity coeff. for mixing of
+ C                 momentum laterally ( m^4/s )
+ C     viscAhGrid:: non-dimensional grid-size dependent viscosity
+ C     viscA4Grid:: non-dimensional grid-size dependent bi-harmonic viscosity
+ C     viscA4GridMax:: maximum and minimum biharmonic viscosity coefficients ...
+ C     viscA4GridMin::  in terms of non-dimensional grid-size dependent viscosity
+ C     viscC4leith :: Leith non-dimensional viscosity factor
  C     diffKhT   :: Laplacian diffusion coeff. for mixing of
  C                 heat laterally ( m^2/s )
- C     diffKzT   :: Laplacian diffusion coeff. for mixing of
+ C     diffKrNrT :: vertical profile of Laplacian diffusion coeff.
- C                 heat vertically ( m^2/s )
+ C                 for mixing of heat vertically ( units of r^2/s )
- C     diffKpT   :: Laplacian diffusion coeff. for mixing of
- C                 heat vertically ( Pa^2/s )
- C     diffKrT   :: Laplacian diffusion coeff. for mixing of
- C                 heat vertically ( units of r^2/s )
  C     diffK4T   :: Biharmonic diffusion coeff. for mixing of
  C                 heat laterally ( m^4/s )
  C     diffKhS  ::  Laplacian diffusion coeff. for mixing of
  C                 salt laterally ( m^2/s )
- C     diffKzS   :: Laplacian diffusion coeff. for mixing of
+ C     diffKrNrS :: vertical profile of Laplacian diffusion coeff.
- C                 salt vertically ( m^2/s )
+ C                 for mixing of salt vertically ( units of r^2/s ),
- C     diffKpS   :: Laplacian diffusion coeff. for mixing of
- C                 salt vertically ( Pa^2/s )
- C     diffKrS   :: Laplacian diffusion coeff. for mixing of
- C                 salt vertically ( units of r^2/s )
  C     diffK4S   :: Biharmonic diffusion coeff. for mixing of
  C                 salt laterally ( m^4/s )
+ C     diffKrBL79surf :: T/S surface diffusivity (m^2/s) Bryan and Lewis, 1979
+ C     diffKrBL79deep :: T/S deep diffusivity (m^2/s) Bryan and Lewis, 1979
+ C     diffKrBL79scl  :: depth scale for arctan fn (m) Bryan and Lewis, 1979
+ C     diffKrBL79Ho   :: depth offset for arctan fn (m) Bryan and Lewis, 1979
  C     deltaT    :: Default timestep ( s )
  C     deltaTClock  :: Timestep used as model "clock". This determines the
  C                    IO frequencies and is used in tagging output. It can
-Line 377 
 C                    it will be the deep
+Line 471 
 C                    it will be the deep
  C                    Frequency of checkpointing and dumping of the model state
  C                    are referenced to this clock. ( s )
  C     deltaTMom    :: Timestep for momemtum equations ( s )
- C     deltaTtracer :: Timestep for tracer equations ( s )
+ C     dTtracerLev  :: Timestep for tracer equations ( s ), function of level k
  C     deltaTfreesurf :: Timestep for free-surface equation ( s )
  C     freesurfFac  :: Parameter to turn implicit free surface term on or off
  C                    freesurfac = 1. uses implicit free surface
-Line 420 
 C     tauThetaClimRelax :: Relaxation to
+Line 514 
 C     tauThetaClimRelax :: Relaxation to
  C     lambdaThetaClimRelax :: Inverse time scale for relaxation ( 1/s ).
  C     tauSaltClimRelax :: Relaxation to climatology time scale ( s ).
  C     lambdaSaltClimRelax :: Inverse time scale for relaxation ( 1/s ).
+ C     latBandClimRelax :: latitude band where Relaxation to Clim. is applied,
+ C                         i.e. where |yC| <= latBandClimRelax
  C     externForcingPeriod :: Is the period of which forcing varies (eg. 1 month)
  C     externForcingCycle :: Is the repeat time of the forcing (eg. 1 year)
  C                          (note: externForcingCycle must be an integer
-Line 428 
 C     convertFW2Salt :: salinity, used t
+Line 524 
 C     convertFW2Salt :: salinity, used t
  C                       (use model surface (local) value if set to -1)
  C     temp_EvPrRn :: temperature of Rain & Evap.
  C     salt_EvPrRn :: salinity of Rain & Evap.
- C     trac_EvPrRn :: tracer concentration in Rain & Evap.
  C        (notes: a) tracer content of Rain/Evap only used if both
  C                     NonLin_FrSurf & useRealFreshWater are set.
  C                b) use model surface (local) value if set to UNSET_RL)
-Line 441 
 C     bottomDragLinear   :: Drag coeffic
+Line 536 
 C     bottomDragLinear   :: Drag coeffic
  C      --"-"--  Quadratic  ( linear: 1/s, quadratic: 1/m )
        COMMON /PARM_R/ cg2dTargetResidual, cg2dTargetResWunit,
       & cg2dpcOffDFac, cg3dTargetResidual,
-      & delP, delZ, delR, delRc, delX, delY,
+      & delR, delRc, delX, delY,
-      & deltaT, deltaTmom, deltaTtracer, deltaTfreesurf, deltaTClock,
+      & deltaT, deltaTmom, dTtracerLev, deltaTfreesurf, deltaTClock,
       & abeps, startTime,
       & phiMin, thetaMin, rSphere, recip_RSphere, f0, beta,
       & fCori, fCoriG, fCoriCos,
-      & viscAh,  viscAz,  viscA4,  viscAr, viscAstrain, viscAtension,
+      & viscAh, viscAhW, viscAhMax, viscAhGrid, viscC2leith,
-      & diffKhT, diffKzT, diffK4T, diffKrT,
+      & viscAhD, viscAhZ, viscA4D, viscA4Z,
-      & diffKhS, diffKzS, diffK4S, diffKrS,
+      & viscA4, viscA4W,
+      & viscA4Max, viscA4Grid, viscA4GridMax, viscA4GridMin,
+      & viscC4leith, viscAr, viscAstrain, viscAtension,
+      & diffKhT, diffK4T, diffKrNrT,
+      & diffKhS, diffK4S, diffKrNrS,
+      & diffKrBL79surf, diffKrBL79deep, diffKrBL79scl, diffKrBL79Ho,
       & delT, tauCD, rCD, freeSurfFac, implicSurfPress, implicDiv2Dflow,
       & hFacMin, hFacMinDz, hFacInf, hFacSup,
       & gravity, recip_Gravity, gBaro, rhonil, recip_rhonil,
       & recip_rhoConst, rhoConst,
       & rhoConstFresh, convertEmP2rUnit, tRef, sRef,
-      & endTime, chkPtFreq, pchkPtFreq, dumpFreq,
+      & endTime, chkPtFreq, pchkPtFreq, dumpFreq, adjDumpFreq,
       & diagFreq, taveFreq, tave_lastIter, monitorFreq,
       & afFacMom, vfFacMom, pfFacMom, cfFacMom, foFacMom, mtFacMom,
-      & cosPower, cAdjFreq, omega,
+      & cosPower, cAdjFreq, omega, rotationPeriod,
       & tauThetaClimRelax, lambdaThetaClimRelax,
       & tauSaltClimRelax, lambdaSaltClimRelax,
-      & tauTr1ClimRelax, lambdaTr1ClimRelax,
+      & tauTr1ClimRelax, lambdaTr1ClimRelax, latBandClimRelax,
       & externForcingCycle, externForcingPeriod,
-      & convertFW2Salt, temp_EvPrRn, salt_EvPrRn, trac_EvPrRn,
+      & convertFW2Salt, temp_EvPrRn, salt_EvPrRn,
-      & viscAp, diffKpT, diffKpS, hFacMinDr, hFacMinDp,
+      & hFacMinDr, hFacMinDp,
       & horiVertRatio, recip_horiVertRatio,
       & ivdc_kappa, Ro_SeaLevel,
-      & bottomDragLinear,bottomDragQuadratic
+      & bottomDragLinear,bottomDragQuadratic,
+      & tCyl
        _RL cg2dTargetResidual
        _RL cg2dTargetResWunit
        _RL cg3dTargetResidual
        _RL cg2dpcOffDFac
-       _RL delZ(Nr)
-       _RL delP(Nr)
        _RL delR(Nr)
        _RL delRc(Nr+1)
        _RL delX(Nx)
-Line 481 
 C      --"-"--  Quadratic  ( linear: 1/s
+Line 580 
 C      --"-"--  Quadratic  ( linear: 1/s
        _RL deltaT
        _RL deltaTClock
        _RL deltaTmom
-       _RL deltaTtracer
+       _RL dTtracerLev(Nr)
        _RL deltaTfreesurf
        _RL abeps
        _RL phiMin
-Line 500 
 C      --"-"--  Quadratic  ( linear: 1/s
+Line 599 
 C      --"-"--  Quadratic  ( linear: 1/s
        _RL hFacSup
        _RL beta
        _RL viscAh
+       _RL viscAhW
+       _RL viscAhD
+       _RL viscAhZ
+       _RL viscAhMax
+       _RL viscAhGrid
+       _RL viscC2leith
        _RL viscAstrain
        _RL viscAtension
-       _RL viscAz
-       _RL viscAp
        _RL viscAr
        _RL viscA4
+       _RL viscA4W
+       _RL viscA4D
+       _RL viscA4Z
+       _RL viscA4Max
+       _RL viscA4Grid, viscA4GridMax, viscA4GridMin
+       _RL viscC4leith
        _RL diffKhT
-       _RL diffKrT
+       _RL diffKrNrT(Nr)
-       _RL diffKzT
-       _RL diffKpT
        _RL diffK4T
        _RL diffKhS
-       _RL diffKrS
+       _RL diffKrNrS(Nr)
-       _RL diffKzS
-       _RL diffKpS
        _RL diffK4S
+       _RL diffKrBL79surf
+       _RL diffKrBL79deep
+       _RL diffKrBL79scl
+       _RL diffKrBL79Ho
        _RL delt
        _RL tauCD
        _RL rCD
-Line 538 
 C      --"-"--  Quadratic  ( linear: 1/s
+Line 647 
 C      --"-"--  Quadratic  ( linear: 1/s
        _RL chkPtFreq
        _RL pChkPtFreq
        _RL dumpFreq
+       _RL adjDumpFreq
        _RL diagFreq
        _RL taveFreq
        _RL tave_lastIter
-Line 551 
 C      --"-"--  Quadratic  ( linear: 1/s
+Line 661 
 C      --"-"--  Quadratic  ( linear: 1/s
        _RL cosPower
        _RL cAdjFreq
        _RL omega
+       _RL rotationPeriod
        _RL tauThetaClimRelax
        _RL lambdaThetaClimRelax
        _RL tauSaltClimRelax
        _RL lambdaSaltClimRelax
        _RL tauTr1ClimRelax
        _RL lambdaTr1ClimRelax
+       _RL latBandClimRelax
        _RL externForcingCycle
        _RL externForcingPeriod
        _RL convertFW2Salt
        _RL temp_EvPrRn
        _RL salt_EvPrRn
-       _RL trac_EvPrRn
        _RL horiVertRatio
        _RL recip_horiVertRatio
        _RL ivdc_kappa
        _RL Ro_SeaLevel
        _RL bottomDragLinear
        _RL bottomDragQuadratic
+       _RL tCyl
-       COMMON /PARM_A/ HeatCapacity_Cp,recip_Cp,
+ C--   COMMON /PARM_A/ Thermodynamics constants ?
-      &                Lamba_theta
+       COMMON /PARM_A/ HeatCapacity_Cp,recip_Cp
        _RL HeatCapacity_Cp
-       _RL Lamba_theta
        _RL recip_Cp
- CmlC Equation of State (polynomial coeffients)
+ C--   COMMON /PARM_ATM/ Atmospheric physical parameters (Ideal Gas EOS, ...)
- Cml      COMMON /PARM_EOS_NL/ eosC,eosSig0,eosRefT,eosRefS
+ C     celsius2K :: convert centigrade (Celsius) degree to Kelvin
- Cml      _RL eosC(9,Nr+1),eosSig0(Nr+1),eosRefT(Nr+1),eosRefS(Nr+1)
+ C     atm_Po    :: standard reference pressure
- CmlC Linear equation of state
+ C     atm_Cp    :: specific heat (Cp) of the (dry) air at constant pressure
- CmlC     tAlpha    :: Linear EOS thermal expansion coefficient ( 1/degree ).
+ C     atm_Rd    :: gas constant for dry air
- CmlC     sBeta     :: Linear EOS haline contraction coefficient.
- Cml      COMMON /PARM_EOS_LIN/ tAlpha,sBeta,eosType
- Cml      _RL tAlpha
- Cml      _RL sBeta
- C Atmospheric physical parameters (Ideal Gas EOS, ...)
- C     atm_po    :: standard reference pressure
- C     atm_cp    :: specific heat (Cp) of the (dry) air at constant pressure
  C     atm_kappa :: kappa = R/Cp (R: constant of Ideal Gas EOS)
- C     Integr_GeoPot :: option to select the way we integrate the geopotential
+ C     atm_Rq    :: water vapour specific volume anomaly relative to dry air
+ C                  (e.g. typical value = (29/18 -1) 10^-3 with q [g/kg])
+ C     integr_GeoPot :: option to select the way we integrate the geopotential
  C                     (still a subject of discussions ...)
-       COMMON /PARM_ATM/ atm_cp, atm_kappa, atm_po,
+ C     selectFindRoSurf :: select the way surf. ref. pressure (=Ro_surf) is
-      &                  Integr_GeoPot
+ C             derived from the orography. Implemented: 0,1 (see INI_P_GROUND)
-       _RL atm_cp, atm_kappa, atm_po
+       COMMON /PARM_ATM/
-       INTEGER Integr_GeoPot
+      &            celsius2K,
+      &            atm_Cp, atm_Rd, atm_kappa, atm_Rq, atm_Po,
+      &            integr_GeoPot, selectFindRoSurf
+       _RL celsius2K
+       _RL atm_Po, atm_Cp, atm_Rd, atm_kappa, atm_Rq
+       INTEGER integr_GeoPot, selectFindRoSurf
  C Logical flags for selecting packages
+       LOGICAL useOPPS
+       LOGICAL usePP81
+       LOGICAL useMY82
+       LOGICAL useGGL90
        LOGICAL useKPP
        LOGICAL useGMRedi
        LOGICAL useOBCS
        LOGICAL useAIM
+       LOGICAL useLand
        LOGICAL useGrdchk
        LOGICAL useECCO
        LOGICAL useSHAP_FILT
        LOGICAL useZONAL_FILT
        LOGICAL useFLT
        LOGICAL usePTRACERS
+       LOGICAL useGCHEM
+       LOGICAL useSBO
+       LOGICAL useSEAICE
+       LOGICAL useBulkForce
+       LOGICAL useThSIce
+       LOGICAL usefizhi
+       LOGICAL usegridalt
+       LOGICAL usediagnostics
+       LOGICAL useEBM
+       LOGICAL useMNC
        COMMON /PARM_PACKAGES/
-      &        useKPP, useGMRedi, useOBCS, useAIM, useECCO,
+      &        useKPP, useGMRedi, useOBCS, useAIM, useLand, useECCO,
       &        useSHAP_FILT, useZONAL_FILT, useGrdchk, useFLT,
-      &        usePTRACERS
+      &        usePTRACERS, useGCHEM,
+      &        useSBO, useSEAICE, useThSIce, useBulkForce,
+      &        usefizhi, usegridalt, usediagnostics, useEBM, useMNC,
+      &        usePP81, useMY82, useOPPS, useGGL90
+ CEH3 ;;; Local Variables: ***
+ CEH3 ;;; mode:fortran ***
+ CEH3 ;;; End: ***

 Legend:



Removed from v.1.79
 


changed lines


 
Added in v.1.140
 Legend:



Removed from v.1.79
 


changed lines


 
Added in v.1.140
-Removed from v.1.79
+Added in v.1.140

	ViewVC Help
Powered by ViewVC 1.1.22