/[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.18 by cnh,
Mon Jun 15 05:13:55 1998 UTC
+revision 1.46 by adcroft,
Fri Feb  2 21:04:47 2001 UTC
 Line 4 
 C     /=================================
  C     | PARAMS.h                                                 |
  C     | o Header file defining model "parameters".               |
  C     |==========================================================|
- C     | The values from the model's standard input file are      |
+ 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     \==========================================================/
 Line 23 
 C     Symbolic values
  C     precXXXX - Used to indicate what precision to use for
  C                dumping model state.
        INTEGER precFloat32
-       PARAMETER ( precFloat32 = 0 )
+       PARAMETER ( precFloat32 = 32 )
        INTEGER precFloat64
-       PARAMETER ( precFloat64 = 1 )
+       PARAMETER ( precFloat64 = 64 )
+ C     UNSET_xxx - Used to indicate variables that have not been given a value
+       Real*8 UNSET_FLOAT8
+       PARAMETER ( UNSET_FLOAT8 = 1.234567D5 )
+       Real*4 UNSET_FLOAT4
+       PARAMETER ( UNSET_FLOAT4 = 1.234567E5 )
+       _RL    UNSET_RL
+       PARAMETER ( UNSET_RL     = 1.234567D5 )
+       _RS    UNSET_RS
+       PARAMETER ( UNSET_RS     = 1.234567E5 )
+       INTEGER UNSET_I
+       PARAMETER ( UNSET_I      = 123456789  )
  C     Checkpoint data
        INTEGER maxNoChkptLev
-Line 44 
 C     thetaClimFile   - File containing
+Line 55 
 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     surfQswfile     - File containing surface shortwave radiation
+ C     EmPmRfile       - File containing surface fresh water flux
+ C     buoyancyRelation - Flag used to indicate which relation to use to
+ C                        get buoyancy.
        COMMON /PARM_C/ checkPtSuff,
       &                bathyFile, hydrogThetaFile, hydrogSaltFile,
       &                zonalWindFile, meridWindFile, thetaClimFile,
-      &                saltClimFile
+      &                saltClimFile, buoyancyRelation,
+      &                EmPmRfile, surfQfile, surfQswfile,
+      &                uVelInitFile, vVelInitFile, pSurfInitFile
        CHARACTER*(5) checkPtSuff(maxNoChkptLev)
        CHARACTER*(MAX_LEN_FNAM) bathyFile
        CHARACTER*(MAX_LEN_FNAM) hydrogThetaFile
-Line 56 
 C                       in relaxation te
+Line 74 
 C                       in relaxation te
        CHARACTER*(MAX_LEN_FNAM) meridWindFile
        CHARACTER*(MAX_LEN_FNAM) thetaClimFile
        CHARACTER*(MAX_LEN_FNAM) saltClimFile
+       CHARACTER*(MAX_LEN_FNAM) surfQfile
+       CHARACTER*(MAX_LEN_FNAM) surfQswfile
+       CHARACTER*(MAX_LEN_FNAM) EmPmRfile
+       CHARACTER*(MAX_LEN_FNAM) buoyancyRelation
+       CHARACTER*(MAX_LEN_FNAM) uVelInitFile
+       CHARACTER*(MAX_LEN_FNAM) vVelInitFile
+       CHARACTER*(MAX_LEN_FNAM) pSurfInitFile
  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     cg3dMaxIters        - Maximum number of iterations in the
+ C                           three-dimensional con. grad solver.
+ C     cg3dChkResFreq      - Frequency with which to check residual
+ C                           in con. grad solver.
  C     nIter0              - Start time-step number of for this run
  C     nTimeSteps          - Number of timesteps to execute
  C     numStepsPerPickup   - For offline setup. Frequency of pickup
-Line 70 
 C     writeStatePrec      - Precision us
+Line 99 
 C     writeStatePrec      - Precision us
  C     writeBinaryPrec     - Precision used for writing binary files
  C     readBinaryPrec      - Precision used for reading binary files
  C     nCheckLev           - Holds current checkpoint level
+ C     nShap               - "Order" of shapiro filter to apply to
+ C                           model prognositic fields.
+ C                           nShap == 1 => del2
+ C                           nShap == 2 => del4
+ C                           nShap == 3 => del6
+ C                           etc...
        COMMON /PARM_I/
       &        cg2dMaxIters,
       &        cg2dChkResFreq,
-      &        nIter0, nTimeSteps,
+      &        cg3dMaxIters,
+      &        cg3dChkResFreq,
+      &        nIter0, nTimeSteps, nEndIter,
       &        numStepsPerPickup,
       &        writeStatePrec, nCheckLev,
-      &        writeBinaryPrec, readBinaryPrec
+      &        writeBinaryPrec, readBinaryPrec,
+      &        nShap, zonal_filt_sinpow, zonal_filt_cospow
        INTEGER cg2dMaxIters
        INTEGER cg2dChkResFreq
+       INTEGER cg3dMaxIters
+       INTEGER cg3dChkResFreq
        INTEGER nIter0
        INTEGER nTimeSteps
+       INTEGER nEndIter
        INTEGER numStepsPerPickup
        INTEGER writeStatePrec
        INTEGER writeBinaryPrec
        INTEGER readBinaryPrec
        INTEGER nCheckLev
+       INTEGER nShap
+       INTEGER zonal_filt_sinpow
+       INTEGER zonal_filt_cospow
  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     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
  C     momViscosity  - Flag which turns momentum friction terms on and off.
  C     momAdvection  - Flag which turns advection of momentum on and off.
  C     momForcing    - Flag which turns external forcing of momentum on
-Line 122 
 C     useConstantF  - Coriolis parameter
+Line 170 
 C     useConstantF  - Coriolis parameter
  C     useBetaPlaneF - Coriolis parameter set to f0 + beta.y
  C     useSphereF    - Coriolis parameter set to 2.omega.sin(phi)
  C     implicitDiffusion - Turns implicit vertical diffusion on
+ C     implicitViscosity - Turns implicit vertical viscosity on
  C     doThetaClimRelax - Set true if relaxation to temperature
  C                        climatology is required.
  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                        coords.
+ C     usingZCoords     - Set to indicate that we are working in height
+ C                        coords.
+ C     nonHydrostatic - Using non-hydrostatic terms
+ C     globalFiles    - Selects between "global" and "tiled" files
+ C     allowFreezing  - Allows water to freeze and form ice
+ C     groundAtK1  - put the surface(k=1) at the Lower Boundary (=ground)
        COMMON /PARM_L/ usingCartesianGrid, usingSphericalPolarGrid,
-      & momViscosity, momAdvection, momForcing, useCoriolis, momPressureForcing,
+      & no_slip_sides,no_slip_bottom,
-      & tempDiffusion, tempAdvection, tempForcing,
+      & staggerTimeStep,
+      & momViscosity, momAdvection, momForcing, useCoriolis,
+      & momPressureForcing,tempDiffusion, tempAdvection, tempForcing,
       & saltDiffusion, saltAdvection, saltForcing,
       & implicitFreeSurface, rigidLid,
       & momStepping, tempStepping, saltStepping,
       & metricTerms, usingSphericalPolarMTerms,
       & useConstantF, useBetaPlaneF, useSphereF,
-      & implicitDiffusion, doThetaClimRelax, doSaltClimRelax
+      & implicitDiffusion, implicitViscosity,
+      & doThetaClimRelax, doSaltClimRelax,
+      & periodicExternalForcing, usingPCoords, usingZCoords,
+      & nonHydrostatic, globalFiles,
+      & allowFreezing, groundAtK1
        LOGICAL usingCartesianGrid
        LOGICAL usingSphericalPolarGrid
        LOGICAL usingSphericalPolarMTerms
+       LOGICAL no_slip_sides
+       LOGICAL no_slip_bottom
+       LOGICAL staggerTimeStep
        LOGICAL momViscosity
        LOGICAL momAdvection
        LOGICAL momForcing
-Line 159 
 C                        climatology is
+Line 226 
 C                        climatology is
        LOGICAL useBetaPlaneF
        LOGICAL useSphereF
        LOGICAL implicitDiffusion
+       LOGICAL implicitViscosity
        LOGICAL doThetaClimRelax
        LOGICAL doSaltClimRelax
+       LOGICAL periodicExternalForcing
+       LOGICAL usingPCoords
+       LOGICAL usingZCoords
+       LOGICAL nonHydrostatic
+       LOGICAL globalFiles
+       LOGICAL allowFreezing
+       LOGICAL groundAtK1
  C--   COMMON /PARM_R/ "Real" valued parameters used by the model.
  C     cg2dTargetResidual
  C               - Target residual for cg2d solver.
+ C     cg3dTargetResidual
+ C               - Target residual for cg3d solver.
  C     cg2dpcOffDFac - Averaging weight for preconditioner off-diagonal.
  C     Note. 20th May 1998
  C           I made a weird discovery! In the model paper we argue
-Line 179 
 C           number of iterations for con
+Line 256 
 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     delZ      - Vertical grid spacing ( m ) - delZ is the distance
+ C     delP      - Vertical grid spacing ( Pa ).
- C                 between "w" surfaces.
+ C     delZ      - Vertical grid spacing ( m  ).
+ C     delR      - Vertical grid spacing ( units of r ).
  C     delX      - Separation between cell faces (m) or (deg), depending
  C     delY        on input flags.
  C     gravity   - Accel. due to gravity ( m/s^2 )
+ C     recip_gravity and its inverse
  C     gBaro     - Accel. due to gravity used in barotropic equation ( m/s^2 )
  C     ronil     - Reference density
+ C     rhoConst  - Vertically constant reference density
  C     startTime - Start time for model ( s )
  C     phiMin    - Latitude of southern most cell face.
  C     thetaMin  - Longitude of western most cell face (this
  C                 is an "inert" parameter but it is included
  C                 to make geographical references simple.)
  C     rSphere   - Radius of sphere for a spherical polar grid ( m ).
- C     rRSphere  - Reciprocal radius of sphere for a spherical polar grid ( m ).
+ C     recip_RSphere  - Reciprocal radius of sphere ( m ).
  C     f0        - Reference coriolis parameter ( 1/s )
  C                 ( Southern edge f for beta plane )
  C     beta      - df/dy ( s^-1.m^-1 )
-Line 201 
 C     viscAh    - Eddy viscosity coeff.
+Line 281 
 C     viscAh    - Eddy viscosity coeff.
  C                 momentum laterally ( m^2/s )
  C     viscAz    - Eddy viscosity coeff. for mixing of
  C                 momentum vertically ( m^2/s )
+ C     viscAp    - Eddy viscosity coeff. for mixing of
+ 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     diffKhT   - Laplacian diffusion coeff. for mixing of
  C                 heat laterally ( m^2/s )
  C     diffKzT   - Laplacian diffusion coeff. for mixing of
  C                 heat vertically ( m^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                 salt vertically ( m^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     deltaT    - Default timestep ( s )
-Line 227 
 C     deltaTtracer - Timestep for tracer
+Line 319 
 C     deltaTtracer - Timestep for tracer
  C     freesurfFac  - Parameter to turn implicit free surface term on or off
  C                    freesurfac = 1. uses implicit free surface
  C                    freesurfac = 0. uses rigid lid
- C     tauCD     - CD scheme coupling timescale ( 1/s )
+ C     hFacMin      - Minimum fraction size of a cell (affects hFacC etc...)
- C     rCD       - CD scheme normalised coupling parameter ( 0-1 )
+ C     hFacMinDz    - Minimum dimesional size of a cell (affects hFacC etc..., m)
- C     GMmaxslope  - max. slope allowed in GM/Redi tensor
+ C     hFacMinDp    - Minimum dimesional size of a cell (affects hFacC etc..., Pa)
- C     GMlength  - Length to use in Visbeck et al. formula for K (m)
+ C     hFacMinDr    - Minimum dimesional size of a cell (affects hFacC etc..., units of r)
- C     GMalpha   - alpha to use in Visbeck et al. formula for K
+ C     tauCD        - CD scheme coupling timescale ( 1/s )
- C     GMdepth   - Depth over which to integrate Richardson # (Visbeck et al.)
+ C     rCD          - CD scheme normalised coupling parameter ( 0-1 )
- C     GMkbackground - background value of GM/Redi coefficient
+ C     startTime     - Starting time for this integration ( s ).
- C     startTime - Starting time for this integration ( s ).
+ C     endTime       - Ending time for this integration ( s ).
- C     endTime   - Ending time for this integration ( s ).
+ C     chkPtFreq     - Frequency of rolling check pointing ( s ).
- C     chkPtFreq  - Frequency of rolling check pointing ( s ).
+ C     pChkPtFreq    - Frequency of permanent check pointing ( s ).
- C     pChkPtFreq - Frequency of permanent check pointing ( s ).
+ C     dumpFreq      - Frequency with which model state is written to
- C     dumpFreq  - Frequency with which model state is written to
+ C                     post-processing files ( s ).
- C                 post-processing files ( s ).
+ C     afFacMom      - Advection of momentum term tracer parameter
- C     afFacMom  - Advection of momentum term scaling parameter
+ C     vfFacMom      - Momentum viscosity tracer parameter
- C     vfFacMom  - Momentum viscosity scaling parameter
+ C     pfFacMom      - Momentum pressure forcing tracer parameter
- C     pfFacMom  - Momentum pressure forcing parameter
+ C     cfFacMom      - Coriolis term tracer parameter
- C     cfFacMom  - Coriolis term scaling parameter
+ C     foFacMom      - Momentum forcing tracer parameter
- C     foFacMom  - Momentum forcing scaling parameter
+ C     mtFacMom      - Metric terms tracer parameter
- C     mtFacMom  - Metric terms scaling parameter
+ C     cosPower      - Power of cosine of latitude to multiply viscosity
- C     cAdjFreq  - Frequency of convective adjustment
+ C     cAdjFreq      - Frequency of convective adjustment
+ C
+ C     taveFreq      - Frequency with which time-averaged model state is written to
+ C                     post-processing files ( s ).
  C     tauThetaClimRelax - Relaxation to climatology time scale ( s ).
  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 ).
-       COMMON /PARM_R/ cg2dTargetResidual, cg2dpcOffDFac, delZ, delX, delY,
+ C     externForcingPeriod - Is the period of which forcing varies (eg. 1 month)
-      & deltaT,deltaTmom, deltaTtracer, deltaTClock,abeps, startTime, phiMin,
+ C     externForcingCycle - Is the repeat time of the forcing (eg. 1 year)
-      & thetaMin, rSphere, rRSphere, f0, fCori, beta, viscAh, viscAz, viscA4,
+ C                          (note: externForcingCycle must be an integer
-      & diffKhT, diffKzT, diffK4T, diffKhS, diffKzS, diffK4S, delT,
+ C                           number times externForcingPeriod)
-      & tauCD, rCD, freeSurfFac,
+ C     horiVertRatio      - Ratio on units in vertical to units in horizontal.
-      & GMmaxslope,GMlength,GMalpha,GMdepth,GMkbackground,
+ C     recip_horiVertRatio  ( 1 if horiz in m and vertical in m ).
-      & gravity, gBaro, rhonil, tRef, sRef,
+ C                          ( g*rho if horiz in m and vertical in Pa ).
-      & endTime, chkPtFreq, pchkPtFreq, dumpFreq,
+ C     latFFTFiltLo       - Low latitude for FFT filtering of latitude
+ C                          circles ( see filter*.F )
+ C     Ro_SeaLevel        - standard position of Sea-Level in "R" coordinate, used as
+ C                          starting value (k=1) for vertical coordinate (rf(1)=Ro_SeaLevel)
+ C     bottomDragLinear   - Drag coefficient built in to core dynamics
+ C         "     Quadratic  ( linear: 1/s, quadratic: 1/m )
+       COMMON /PARM_R/ cg2dTargetResidual, cg2dpcOffDFac,
+      & cg3dTargetResidual,
+      & delP, delZ, delR, delX, delY,
+      & deltaT,deltaTmom, deltaTtracer, deltaTClock,abeps, startTime,
+      & phiMin, thetaMin, rSphere, recip_RSphere, f0, fCori, beta,
+      & viscAh,  viscAz,  viscA4,  viscAr,
+      & diffKhT, diffKzT, diffK4T, diffKrT,
+      & diffKhS, diffKzS, diffK4S, diffKrS,
+      & delT, tauCD, rCD, freeSurfFac, hFacMin, hFacMinDz,
+      & gravity, recip_Gravity, gBaro, rhonil, recip_rhonil,
+      & recip_rhoConst, rhoConst, tRef, sRef,
+      & endTime, chkPtFreq, pchkPtFreq, dumpFreq, taveFreq,
       & afFacMom, vfFacMom, pfFacMom, cfFacMom, foFacMom, mtFacMom,
+      & cosPower,
       & cAdjFreq, omega, tauThetaClimRelax, lambdaThetaClimRelax,
-      & tauSaltClimRelax, lambdaSaltClimRelax
+      & tauSaltClimRelax, lambdaSaltClimRelax,
+      & externForcingCycle, externForcingPeriod,
+      & viscAp, diffKpT, diffKpS, hFacMinDr, hFacMinDp,
+      & theta_S, specVol_S, horiVertRatio, recip_horiVertRatio,
+      & latFFTFiltLo, ivdc_kappa, Ro_SeaLevel, zonal_filt_lat,
+      & bottomDragLinear,bottomDragQuadratic
        _RL cg2dTargetResidual
+       _RL cg3dTargetResidual
        _RL cg2dpcOffDFac
-       _RL delZ(Nz)
+       _RL delZ(Nr)
+       _RL delP(Nr)
+       _RL delR(Nr)
        _RL delX(Nx)
        _RL delY(Ny)
        _RL deltaT
-Line 275 
 C     lambdaSaltClimRelax - Inverse time
+Line 397 
 C     lambdaSaltClimRelax - Inverse time
        _RL phiMin
        _RL thetaMin
        _RL rSphere
-       _RL rRSphere
+       _RL recip_RSphere
        _RL f0
        _RL freeSurfFac
+       _RL hFacMin
+       _RL hFacMinDz
+       _RL hFacMinDp
+       _RL hFacMinDr
        _RL beta
        _RL viscAh
        _RL viscAz
+       _RL viscAp
+       _RL viscAr
        _RL viscA4
        _RL diffKhT
+       _RL diffKrT
        _RL diffKzT
+       _RL diffKpT
        _RL diffK4T
        _RL diffKhS
+       _RL diffKrS
        _RL diffKzS
+       _RL diffKpS
        _RL diffK4S
        _RL delt
        _RL tauCD
        _RL rCD
-       _RL GMmaxslope
-       _RL GMlength
-       _RL GMalpha
-       _RL GMdepth
-       _RL GMkbackground
        _RL gravity
+       _RL recip_gravity
        _RL gBaro
        _RL rhonil
-       _RL tRef(Nz)
+       _RL recip_rhonil
-       _RL sRef(Nz)
+       _RL rhoConst
+       _RL recip_rhoConst
+       _RL specVol_S(Nr)
+       _RL tRef(Nr)
+       _RL theta_S(Nr)
+       _RL sRef(Nr)
        _RS Fcori(1-OLx:sNx+OLx,1-OLy:sNy+OLy,nSx,nSy)
        _RL startTime
        _RL endTime
        _RL chkPtFreq
        _RL pChkPtFreq
        _RL dumpFreq
+       _RL taveFreq
        _RL afFacMom
        _RL vfFacMom
        _RL pfFacMom
        _RL cfFacMom
        _RL foFacMom
        _RL mTFacMom
+       _RL cosPower
        _RL cAdjFreq
        _RL omega
        _RL tauThetaClimRelax
        _RL lambdaThetaClimRelax
        _RL tauSaltClimRelax
        _RL lambdaSaltClimRelax
+       _RL externForcingCycle
+       _RL externForcingPeriod
+       _RL horiVertRatio
+       _RL recip_horiVertRatio
+       _RL latFFTFiltLo
+       _RL ivdc_kappa
+       _RL Ro_SeaLevel
+       _RL zonal_filt_lat
+       _RL bottomDragLinear
+       _RL bottomDragQuadratic
-       COMMON /PARM_A/ HeatCapacity_Cp,
+       COMMON /PARM_A/ HeatCapacity_Cp,recip_Cp,
       &                Lamba_theta
        _RL HeatCapacity_Cp
        _RL Lamba_theta
+       _RL recip_Cp
  C Equation of State (polynomial coeffients)
        COMMON /PARM_EOS_NL/ eosC,eosSig0,eosRefT,eosRefS
-       _RL eosC(9,Nz+1),eosSig0(Nz+1),eosRefT(Nz+1),eosRefS(Nz+1)
+       _RL eosC(9,Nr+1),eosSig0(Nr+1),eosRefT(Nr+1),eosRefS(Nr+1)
  C Linear equation of state
  C     tAlpha    - Linear EOS thermal expansion coefficient ( 1/degree ).
  C     sBeta     - Linear EOS haline contraction coefficient.
-Line 336 
 C     sBeta     - Linear EOS haline cont
+Line 482 
 C     sBeta     - Linear EOS haline cont
        _RL sBeta
        character*(6) eosType
+ C Logical flags for selecting packages
+       LOGICAL useKPP
+       LOGICAL useGMRedi
+       LOGICAL useOBCS
+       LOGICAL useECCO
+       COMMON /PARM_PACKAGES/
+      &        useKPP, useGMRedi, useOBCS, useECCO

 Legend:



Removed from v.1.18
 


changed lines


 
Added in v.1.46
 Legend:



Removed from v.1.18
 


changed lines


 
Added in v.1.46
-Removed from v.1.18
+Added in v.1.46

	ViewVC Help
Powered by ViewVC 1.1.22