Difference between revisions of "roms.in"

From WikiROMS
Jump to navigationJump to search
Line 95: Line 95:


* Factor between passive (outflow) and active (inflow) (in the Orlanksi radiation sense) open boundary condition nudging time scales, [1:Ngrids]. If [[Variables#obcfac|OBCFAC]] > 1, nudging on inflow is stronger than on outflow (recommended) because the inflow time scale TNUDG/OBCFAC is less than the outflow timescale TNUDG (see above). <wikitex>The passive/active radiation conditions in ROMS follow the method proposed by [[Bibliography#MarchesielloP_2001a | Marchesiello et al. (2001)]]: $$\frac{\partial \phi}{\partial t} + C_x \frac{\partial \phi}{\partial x} + C_y \frac{\partial \phi}{\partial y} = - \frac{1}{\tau}(\phi - \phi^{ext})$$ with $$\eqalign {\tau &= \tau_{out} \mbox{\quad if \quad} C_x > 0, \cr
* Factor between passive (outflow) and active (inflow) (in the Orlanksi radiation sense) open boundary condition nudging time scales, [1:Ngrids]. If [[Variables#obcfac|OBCFAC]] > 1, nudging on inflow is stronger than on outflow (recommended) because the inflow time scale TNUDG/OBCFAC is less than the outflow timescale TNUDG (see above). <wikitex>The passive/active radiation conditions in ROMS follow the method proposed by [[Bibliography#MarchesielloP_2001a | Marchesiello et al. (2001)]]: $$\frac{\partial \phi}{\partial t} + C_x \frac{\partial \phi}{\partial x} + C_y \frac{\partial \phi}{\partial y} = - \frac{1}{\tau}(\phi - \phi^{ext})$$ with $$\eqalign {\tau &= \tau_{out} \mbox{\quad if \quad} C_x > 0, \cr
\noalign{\smallskip} \tau &= \tau_{in} \mbox{\quad \phantom{t}if \quad} C_x < 0 \mbox{\quad and \quad} C_y = 0 \cr}$$ where $\phi^{ext}$ represents the external boundary data and $\tau$ is the nudging time scale with $\tau_{out}$ for outflow, $\tau_{in}$ for inflow, and $\tau_{out} \ll \tau_{in}$. At outflow, a weak nudging is used to prevent a drift of the solution while avoiding over-specification of the boundary data. During inflow, a strong nudging is applied to avoid data-shock in the solution. The nudging time scales provided above are for the outflow (passive) conditions, $\tau_{out}$, in days.  The inflow nudging time scale is $\frac{1}{\tau_{in}} = \frac{\mbox{obcfac}}{\tau_{out}}$.</wikitex> <div class="box">      [[Variables#obcfac|OBCFAC]] == 10.0d0              ! nondimensional</div>
\noalign{\smallskip} \tau &= \tau_{in} \mbox{\quad \phantom{t}if \quad} C_x < 0 \mbox{\quad and \quad} C_y = 0 \cr}$$ where $\phi^{ext}$ represents the external boundary data and $\tau$ is the nudging time scale with $\tau_{out}$ for outflow, $\tau_{in}$ for inflow, and $\tau_{out} \ll \tau_{in}$. At outflow, a weak nudging is used to prevent a drift of the solution while avoiding over-specification of the boundary data. During inflow, a strong nudging is applied to avoid data-shock in the solution. The nudging time scales provided above are for the outflow (passive) conditions, $\tau_{out}$, in days.  The inflow nudging factor in the above equation is $\frac{1}{\tau_{in}} = \frac{\mbox{obcfac}}{\tau_{out}}$.</wikitex> <div class="box">      [[Variables#obcfac|OBCFAC]] == 10.0d0              ! nondimensional</div>


* Linear equation of State parameters, [1:[[Ngrids]]] values are expected.<div class="box">          [[Variables#R0|R0]] == 1027.0d0            ! kg/m3<br />          [[Variables#T0|T0]] == 10.0d0              ! Celsius<br />          [[Variables#S0|S0]] == 35.0d0              ! nondimensional<br />      [[Variables#Tcoef|TCOEF]] == 1.7d-4              ! 1/Celsius<br />      [[Variables#Scoef|SCOEF]] == 7.6d-4              ! 1/nondimensional</div>
* Linear equation of State parameters, [1:[[Ngrids]]] values are expected.<div class="box">          [[Variables#R0|R0]] == 1027.0d0            ! kg/m3<br />          [[Variables#T0|T0]] == 10.0d0              ! Celsius<br />          [[Variables#S0|S0]] == 35.0d0              ! nondimensional<br />      [[Variables#Tcoef|TCOEF]] == 1.7d-4              ! 1/Celsius<br />      [[Variables#Scoef|SCOEF]] == 7.6d-4              ! 1/nondimensional</div>

Revision as of 15:51, 4 February 2015

Standard Input Script - ocean.in

File ocean.in is the ROMS standard input file to any model run. This file sets the application spatial dimensions and many of the parameters that are not specified at compile time, including parallel tile decomposition, time-stepping, physical coefficients and constants, vertical coordinate set-up, logical switches and flags to control the frequency of output, the names of input and output NetCDF files, and additional input scripts names for data assimilation, stations, floats trajectories, ecosystem models, and sediment model.

This standard input ASCII file is organized in several sections as shown below, with links to more detailed explanation where required.

Note Notice: A detailed information about ROMS input script file syntax can be found here.

Note Notice: A default ocean.in input script is provided in the User/External subdirectory. Also there are several standard input scripts in the ROMS/External subdirectory which are used in the distributed test cases. They are usually named ocean_app.in where app is the lowercase of the test case cpp option.

Configuration Parameters

  • Application title. This string will be saved in the output NetCDF files.
    TITLE = Wind-Driven Upwelling/Downwelling over a Periodic Channel
  • C-preprocessing Flag to define the specific configuration.
    MyAppCPP = UPWELLING
    Though this is set by ROMS_APPLICATION in the makefile or build Script, ROMS is also compiled with -D$(ROMS_APPLICATION), which allows the use of
    #ifdef UPWELLING
    for instance. The net result of both
    -D$(ROMS_APPLICATION)=UPWELLING -DUPWELLING
    is that ROMS_APPLICATION becomes 1 in the source code. ROMS therefore needs to be told the application name here as well in order to report it to the output file.
  • Input variable information file name. This file needs to be processed first so all information arrays can be initialized properly. Notice that we need an absolute or relative path for input metadata file varinfo.dat. There are many posts in the ROMS Forum of new users that fail to specify the correct location of this file. Expert users usually have the own modified copy of this file for a particular application.
    VARNAME = ROMS/External/varinfo.dat
NoteNOTE: Starting with revision 460 file names can be up to 256 characters long. Previously only 80 characters were allowed.
  • Number of nested grids.
    Ngrids = 1
  • Number of grid nesting layers. This parameter is used to allow refinement and composite grid combinations.
  • Grid dimension parameters. These are used to dynamically allocate all model state variables upon execution.
    Lm == 41  ! Number of I-direction INTERIOR RHO-points
    Mm == 80  ! Number of J-direction INTERIOR RHO-points
    N == 16  ! Number of vertical levels

    Nbed = 0  ! Number of sediment bed layers

    NAT = 2  ! Number of active tracers (usually, 2)
    NPT = 0  ! Number of inactive passive tracers
    NCS = 0  ! Number of cohesive (mud) sediment tracers
    NNS = 0  ! Number of non-cohesive (sand) sediment tracers
  • Domain decomposition parameters for serial, distributed-memory or shared-memory configurations used to determine tile horizontal range indices (Istr,Iend) and (Jstr,Jend), [1:Ngrids] values are expected.
    NtileI == 1  ! I-direction partition
    NtileJ == 1  ! J-direction partition

Lateral Open Boundary Conditions Parameters

  • The lateral boundary conditions are now specified with logical switches instead of CPP flags to allow nested grid configurations. Their values are loaded into the structured array:
    LBC(1:4, nLBCvar, Ngrids)
    where 1:4 are the numbered boundary edges, nLBCvar are the number LBC state variables, and Ngrids is the number of nested grids. For example, to apply gradient boundary conditions for free-surface we use:
    LBC(iwest, isFsur, ng) % gradient
    LBC(ieast, ... , ng) % gradient
    LBC(isouth, ... , ng) % gradient
    LBC(inorth, ... , ng) % gradient
    The lateral boundary conditions are entered with a keyword. A value is expected for each boundary segment per nested grid for each state variable. Each tracer variable requires [1:4,1:NAT+NPT,Ngrids] values. [1:4,1:Ngrids] values are expected for other variables. The boundary order is: 1=west, 2=south, 3=east, and 4=north. That is, anticlockwise starting at the western boundary.

    The keyword is case insensitive and usually has three characters. However, it is possible to have compound keywords, if applicable. For example, the keyword RadNud implies radiation boundary condition with nudging. This combination is usually used in active/passive radiation conditions.
    ! Keyword Lateral Boundary Condition Type
    !
    ! Cha Chapman
    ! Cla Clamped
    ! Clo Closed
    ! Fla Flather _____N_____ j=Mm
    ! Gra Gradient | 4 |
    ! Nes Nested | |
    ! Nud Nudging 1 W E 3
    ! Per Periodic | |
    ! Rad Radiation |_____S_____|
    ! Red Reduced Physics 2 j=1
    ! i=1 i=Lm
    ! W S E N
    ! e o a o
    ! s u s r
    ! t t t t
    ! h h
    !
    ! 1 2 3 4


    LBC(isFsur) == Per Clo Per Clo  ! free-surface
    LBC(isUbar) == Per Clo Per Clo  ! 2D U-momentum
    LBC(isVbar) == Per Clo Per Clo  ! 2D V-momentum
    LBC(isUvel) == Per Clo Per Clo  ! 3D U-momentum
    LBC(isVvel) == Per Clo Per Clo  ! 3D V-momentum
    LBC(isMtke) == Per Clo Per Clo  ! mixing TKE

    LBC(isTvar) == Per Clo Per Clo \  ! temperature
    Per Clo Per Clo  ! salinity
  • Lateral open boundary edge volume conservation switch for nonlinear model and adjoint-based algorithm. This is usually activated with radiation boundary conditions to enforce global mass conservation. Notice that these switches should not be activated if tidal forcing, [1:Ngrids] values are expected.
    VolCons(west) == F  ! western boundary
    VolCons(east) == F  ! eastern boundary
    VolCons(south) == F  ! southern boundary
    VolCons(north) == F  ! northern boundary

    ad_VolCons(west) == F  ! western boundary
    ad_VolCons(east) == F  ! eastern boundary
    ad_VolCons(south) == F  ! southern boundary
    ad_VolCons(north) == F  ! northern boundary

Time-Stepping and Iterations Parameters

  • Time-stepping parameters.
    NTIMES = 1440  ! Number of time steps
    DT == 300.0d0  ! Time-step size (seconds)
    NDTFAST == 30  ! Number of barotropic steps
  • Model iteration loops parameters.
    ERstr = 1  ! Starting perturbation or iteration
    ERend = 1  ! Ending perturbation or iteration
    Nouter = 1  ! Maximum number of 4DVar outer loop iterations
    Ninner = 1  ! Maximum number of 4DVar inner loop iterations
    Nintervals = 1  ! Number of stochastic optimals interval divisions
  • Number of eigenvalues (NEV) and eigenvectors (NCV) to compute for the Lanczos/Arnoldi problem in the Generalized Stability Theory (GST) analysis. NCV must be greater than NEV.
    NEV = 2  ! Number of eigenvalues
    NCV = 10  ! Number of eigenvectors
    Note Notice: At present, there is no a-priori analysis to guide the selection of NCV relative to NEV. The only formal requirement is that NCV > NEV. However in optimal perturbations, it is recommended to have NCV ≥ 2*NEV. In Finite Time Eigenmodes (FTE) and Adjoint Finite Time Eigenmodes (AFTE) the requirement is to have NCV ≥ 2*NEV+1. The efficiency of calculations depends critically on the combination of NEV and NCV. If NEV is large (greater than 10 say), you can use NCV=2*NEV+1 but for NEV small (less than 6) it will be inefficient to use NCV=2*NEV+1. In complicated applications, you can start with NEV=2 and NCV=10. Otherwise, it will iterate for very long time.

Output Frequency Parameters

  • Flags controlling the frequency of output.
    NRREC = 0  ! Model restart flag
    LcycleRST == T  ! Switch to recycle restart time records
    NRST == 288  ! Number of time-steps between restart records
    NSTA == 1  ! Number of time-steps between stations records
    NFLT == 1  ! Number of time-steps between floats records
    NINFO == 1  ! Number of time-steps between information diagnostics
  • Output history, average, diagnostic files parameters.
    LDEFOUT == T  ! File creation/append switch
    NHIS == 72  ! Number of time-steps between history records
    NDEFHIS == 0  ! Number of time-steps between creation of new history file
    NTSAVG == 1  ! Starting averages time-step
    NAVG == 72  ! Number of time-steps between averages records
    NDEFAVG == 0  ! Number of time-steps between creation of new averages file
    NTSDIA == 1  ! Starting diagnostics time-step
    NDIA == 72  ! Number of time-steps between diagnostics records
    NDEFDIA == 0  ! Number of time-steps between creation of new diagnostics file
  • Output tangent linear and adjoint models parameters.
    LcycleTLM == F  ! Switch to recycle TLM time records
    NTLM == 72  ! Number of time-steps between TLM records
    NDEFTLM == 0  ! Number of time-steps between creation of new TLM file
    LcycleADJ == F  ! Switch to recycle ADM time records
    NADJ == 72  ! Number of time-steps between ADM records
    NDEFADJ == 0  ! Number of time-steps between creation of new ADM file
    NSFF == 72  ! Number of time-steps between 4DVAR adjustment of
     ! surface forcing fluxes
    NOBC == 72  ! Number of time-steps between 4DVAR adjustment of
     ! open boundary fields
  • Output check pointing GST restart parameters.
    LmultiGST = F  ! one eigenvector per history file
    LrstGST = F  ! GST restart switch
    MaxIterGST = 500  ! maximum number of iterations
    NGST = 10  ! check pointing interval

Physical and Numerical Parameters

  • Relative accuracy of the Ritz values computed in the GST analysis.
    Ritz_tol = 1.0d-15
  • Harmonic/biharmonic horizontal diffusion of all active and passive (dye) tracers for the nonlinear model and adjoint-based algorithms: [1:NAT+NPT,Ngrids] values are expected. Diffusion coefficients for biology and sediment tracers are set in their respective input scripts.
    TNU2 == 0.0d0 0.0d0  ! m2/s
    TNU4 == 2*0.0d0  ! m4/s

    ad_TNU2 == 0.0d0 0.0d0  ! m2/s
    ad_TNU4 == 0.0d0 0.0d0  ! m4/s
  • Harmonic/biharmonic, horizontal viscosity coefficient for the nonlinear model and adjoint-based algorithms: [1:Ngrids values are expected. Only used if the appropriate CPP options are defined.
    VISC2 == 0.0d0  ! m2/s
    VISC4 == 0.0d0  ! m4/s

    ad_VISC2 == 0.0d0  ! m2/s
    ad_VISC4 == 0.0d0  ! m4/s
  • Logical switches (TRUE/FALSE) to increase/decrease horizontal viscosity and/or diffusivity in specific areas of the application domain (like sponge areas) for the desired application grid.
    LuvSponge == F  ! horizontal momentum
    LtracerSponge == F F  ! temperature, salinity, inert
  • Background vertical mixing coefficients for active (NAT) and inert (NPT) tracers for the nonlinear model and basic state scale factor in adjoint-based algorithms: [1:NAT+NPT,Ngrids] values are expected.
    AKT_BAK == 1.0d-6 1.0d-6  ! m2/s

    ad_AKT_fac == 1.0d0 1.0d0 !nondimensional
  • Background vertical mixing coefficient for momentum for the nonlinear model and basic state scale factor in the adjoint-based algorithms: [1:Ngrids] values are expected.
    AKV_BAK == 1.0d-5  ! m2/s

    ad_AKV_fac == 1.0d0 !nondimensional
  • Turbulent closures parameters.
    AKK_BAK == 5.0d-6  ! m2/s
    AKP_BAK == 5.0d-6  ! m2/s
    TKENU2 == 0.0d0  ! m2/s
    TKENU4 == 0.0d0  ! m4/s
  • Generic length-scale turbulence closure parameters. These parameters are used when GLS_MIXING is activated.
    GLS_P == 3.0d0  ! K-epsilon
    GLS_M == 1.5d0  ! Turbulent kinetic energy exponent
    GLS_N == -1.0d0  ! Turbulent length scale exponent
    GLS_Kmin == 7.6d-6  ! Minimum value of specific turbulent energy
    GLS_Pmin == 1.0d-12  ! Minimum Value of dissipation

    ! Closure independent constraint parameters:

    GLS_CMU0 == 0.5477d0  ! Stability coefficient
    GLS_C1 == 1.44d0  ! Shear production coefficient
    GLS_C2 == 1.92d0  ! Dissipation coefficient
    GLS_C3M == -0.4d0  ! Buoyancy production coefficient (minus)
    GLS_C3P == 1.0d0  ! Buoyancy production coefficient (plus)
    GLS_SIGK == 1.0d0  ! Constant Schmidt number for turbulent
     ! kinetic energy diffusivity
    GLS_SIGP == 1.30d0  ! Constant Schmidt number for turbulent
     ! generic statistical field, "psi"
  • Constants used in surface turbulent kinetic energy flux computation.
    CHARNOK_ALPHA == 1400.0d0  ! Charnok surface roughness
    ZOS_HSIG_ALPHA == 0.5d0  ! Roughness from wave amplitude
    SZ_ALPHA == 0.25d0  ! roughness from wave dissipation
    CRGBAN_CW == 100.0d0  ! Craig and Banner wave breaking
  • Constants used in momentum stress computation.
    RDRG == 3.0d-04  ! m/s
    RDRG2 == 3.0d-03  ! nondimensional
    Zob == 0.02d0  ! m
    Zos == 0.02d0  ! m
  • Height (m) of atmospheric measurements for Bulk fluxes parameterization.
    BLK_ZQ == 10.0d0  ! air humidity
    BLK_ZT == 10.0d0  ! air temperature
    BLK_ZW == 10.0d0  ! winds
  • Minimum depth for wetting and drying.
    DCRIT == 0.10d0  ! m
  • Jerlov water type used to set vertical depth scale for shortwave radiation absorption.
    WTYPE == 1
  • Mean Density and Brunt-Vaisala frequency.
    RHO0 = 1025.0d0  ! kg/m3
    BVF_BAK = 1.0d-4  ! 1/s2
  • Time-stamp assigned for model initialization, reference time origin for tidal forcing, and model reference time for output NetCDF units attribute.
    DSTART = 0.0d0  ! days
    TIDE_START = 0.0d0  ! days
    TIME_REF = 0.0d0  ! yyyymmdd.dd
  • Nudging/relaxation time scales, inverse scales will be computed internally, [1:Ngrids] values are expected. These values are used for two purposes.
  1. When climatology nudging is active throughout the domain because the logical flags LtracerCLM, Lm3CLM, Lm2CLM etc. are TRUE, these values are the default nudging time scales set in Functionals/ana_nudgcoef.h. Since the user can choose to customize ana_nudgcoef.h, or provide 3-D climatology nudging time scales in an external file, these parameters might not be used
  2. When nudging is applied in the lateral open boundary conditions because the LBC logical flags are set to "RadNud" the values here set the nudging time scale when the Orlanski radiation scheme detects outflow conditions. When the Orlanski scheme detects inflow conditions, the nudging time scale is TNUDG/OBCFAC (see OBCFAC below).
TNUDG == 2*0.0d0  ! days
ZNUDG == 0.0d0  ! days
M2NUDG == 0.0d0  ! days
M3NUDG == 0.0d0  ! days
  • Factor between passive (outflow) and active (inflow) (in the Orlanksi radiation sense) open boundary condition nudging time scales, [1:Ngrids]. If OBCFAC > 1, nudging on inflow is stronger than on outflow (recommended) because the inflow time scale TNUDG/OBCFAC is less than the outflow timescale TNUDG (see above). <wikitex>The passive/active radiation conditions in ROMS follow the method proposed by Marchesiello et al. (2001): $$\frac{\partial \phi}{\partial t} + C_x \frac{\partial \phi}{\partial x} + C_y \frac{\partial \phi}{\partial y} = - \frac{1}{\tau}(\phi - \phi^{ext})$$ with $$\eqalign {\tau &= \tau_{out} \mbox{\quad if \quad} C_x > 0, \cr

\noalign{\smallskip} \tau &= \tau_{in} \mbox{\quad \phantom{t}if \quad} C_x < 0 \mbox{\quad and \quad} C_y = 0 \cr}$$ where $\phi^{ext}$ represents the external boundary data and $\tau$ is the nudging time scale with $\tau_{out}$ for outflow, $\tau_{in}$ for inflow, and $\tau_{out} \ll \tau_{in}$. At outflow, a weak nudging is used to prevent a drift of the solution while avoiding over-specification of the boundary data. During inflow, a strong nudging is applied to avoid data-shock in the solution. The nudging time scales provided above are for the outflow (passive) conditions, $\tau_{out}$, in days. The inflow nudging factor in the above equation is $\frac{1}{\tau_{in}} = \frac{\mbox{obcfac}}{\tau_{out}}$.</wikitex>

OBCFAC == 10.0d0  ! nondimensional
  • Linear equation of State parameters, [1:Ngrids] values are expected.
    R0 == 1027.0d0  ! kg/m3
    T0 == 10.0d0  ! Celsius
    S0 == 35.0d0  ! nondimensional
    TCOEF == 1.7d-4  ! 1/Celsius
    SCOEF == 7.6d-4  ! 1/nondimensional
  • Slipperiness parameter: 1.0 (free slip) or -1.0 (no slip).
    GAMMA2 = 1.0d0
  • Logical switches (TRUE/FALSE) to activate horizontal momentum transport point Sources/Sinks (like river runoff) and mass point Sources/Sinks (like volume vertical influx): [1:Ngrids] values are expected. These switches replace obsolete CPP options UV_PSOURCE and Q_PSOURCE, respectively. In nesting, a particular grid may or may not have Sources/Sinks forcing.
    LuvSrc == F  ! horizontal momentum transport
    LwSrc == F  ! volume vertical influx
  • Logical switches (TRUE/FALSE) to activate tracers point Sources/Sinks (like river runoff) and to specify which tracer variables to consider: [1:NAT+NPT,Ngrids] values are expected. Other biological and sediment tracer switches are activated in their respective input scripts. This switch replaces obsolete CPP option TS_PSOURCE. In nesting, a particular grid may or may not have tracers Sources/Sinks forcing.
    LtracerSrc == F F  ! temperature, salinity, inert
  • Logical switches (TRUE/FALSE) to read and process climatology fields.
    LsshCLM == F  ! sea-surface height
    Lm2CLM == F  ! 2D momentum
    Lm3CLM == F  ! 3D momentum

    LtracerCLM == F F  ! temperature, salinity, inert
  • Logical switches (TRUE/FALSE) to nudge the desired climatology field(s). If not analytical climatology fields, users need to turn ON the logical switches above to process the fields from the climatology NetCDF file that are needed for nudging.
    LnudgeM2CLM == F  ! 2D momentum
    LnudgeM3CLM == F  ! 3D momentum

    LnudgeTCLM == F F  ! temperature, salinity, inert

Vertical Coordinates Parameters

  • Set vertical, terrain-following coordinates transformation equation and stretching function (see Vertical S-coordinate for more details).
    Vtransform == 2  ! transformation equation
    Vstretching == 4  ! stretching function
  • S-coordinate surface control parameter, [1:Ngrids] values are expected. The range of optimal values depends on the vertical stretching function.
    THETA_S == 3.0d0  ! surface stretching parameter
  • S-coordinate bottom control parameter, [1:Ngrids] values are expected. The range of optimal values depends on the vertical stretching function.
    THETA_B == 0.0d0  ! bottom stretching parameter
  • Critical depth (hc) in meters (positive) controlling the stretching. It can be interpreted as the width of surface or bottom boundary layer in which higher vertical resolution (levels) is required during stretching.
    TCLINE == 25.0d0  ! critical depth (m)

Adjoint Sensitivity Parameters

  • Starting (DstrS) and ending (DendS) day for adjoint sensitivity forcing. DstrS must be less or equal to DendS. If both values are zero, their values are reset internally to the full range of the adjoint integration.
    DstrS == 0.0d0  ! starting day
    DendS == 0.0d0  ! ending day
  • Starting and ending vertical levels of the 3D adjoint state variables whose sensitivity is required.
    KstrS == 1  ! starting level
    KendS == 1  ! ending level
  • Logical switches (TRUE/FALSE) to specify the adjoint state tracer variables whose sensitivity is required, [1:NT,1:Ngrids] values are expected.
    Lstate(isTvar) == F F  ! NT tracers

Stochastic Optimals Parameters

  • Stochastic optimals time decorrelation scale (days) assumed for red noise processes.
    SO_decay == 2.0d0  ! days

History Output Variables Switches

  • Logical switches (TRUE/FALSE) to activate writing of extra inert passive tracers other than biological and sediment tracers. An inert passive tracer is one that it is only advected and diffused. Other processes are ignored. These tracers include, for example, dyes, pollutants, oil spills, etc. [1:NPT] values are expected. However, these switches can be activated using compact parameter specification.
    Hout(inert) == T  ! dye_01, ... inert passive tracers
  • Logical switches (TRUE/FALSE) to activate writing of exposed sediment layer properties into HISTORY output file. Currently, MBOTP properties are expected for the bottom boundary layer and/or sediment models.
    ! idBott( 1=isd50) grain_diameter mean grain diameter
    ! idBott( 2=idens) grain_density mean grain density
    ! idBott( 3=iwsed) settling_vel mean settling velocity
    ! idBott( 4=itauc) erosion_stress critical erosion stress
    ! idBott( 5=irlen) ripple_length ripple length
    ! idBott( 6=irhgt) ripple_height ripple height
    ! idBott( 7=ibwav) bed_wave_amp wave excursion amplitude
    ! idBott( 8=izdef) Zo_def default bottom roughness
    ! idBott( 9=izapp) Zo_app apparent bottom roughness
    ! idBott(10=izNik) Zo_Nik Nikuradse bottom roughness
    ! idBott(11=izbio) Zo_bio biological bottom roughness
    ! idBott(12=izbfm) Zo_bedform bed form bottom roughness
    ! idBott(13=izbld) Zo_bedload bed load bottom roughness
    ! idBott(14=izwbl) Zo_wbl wave bottom roughness
    ! idBott(15=iactv) active_layer_thickness active layer thickness
    ! idBott(16=ishgt) saltation saltation height
    !
    ! 1 1 1 1 1 1 1
    ! 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6


    Hout(idBott) == T T T T T T T T T F F F F F F F

Time-averaged Output Variables Switches

  • Logical switches (TRUE/FALSE) to activate writing of extra inert passive tracers other than biological and sediment tracers into the time-averaged output file. An inert passive tracer is one that it is only advected and diffused. Other processes are ignored. These tracers include, for example, dyes, pollutants, oil spills, etc. [1:NPT,1:Ngrids] values are expected. However, these switches can be activated using compact parameter specification.
    Aout(inert) == T  ! dye_01, ... inert passive tracers

Time-averaged Diagnostic Output Variables Switches

  • Logical switches (TRUE/FALSE) to activate writing time-averaged. 2D momentum (ubar, vbar) diagnostic terms into the diagnostics output file.
    Dout(M2rate) == T  ! ubar_accel, ... acceleration
    Dout(M2pgrd) == T  ! ubar_prsgrd, ... pressure gradient
    Dout(M2fcor) == T  ! ubar_cor, ... Coriolis force
    Dout(M2hadv) == T  ! ubar_hadv, ... horizontal total advection
    Dout(M2xadv) == T  ! ubar_xadv, ... horizontal XI-advection
    Dout(M2yadv) == T  ! ubar_yadv, ... horizontal ETA-advection
    Dout(M2hrad) == T  ! ubar_hrad, ... horizontal total radiation stress
    Dout(M2hvis) == T  ! ubar_hvisc, ... horizontal total viscosity
    Dout(M2xvis) == T  ! ubar_xvisc, ... horizontal XI-viscosity
    Dout(M2yvis) == T  ! ubar_yvisc, ... horizontal ETA-viscosity
    Dout(M2sstr) == T  ! ubar_sstr, ... surface stress
    Dout(M2bstr) == T  ! ubar_bstr, ... bottom stress
  • Logical switches (TRUE/FALSE) to activate writing of time-averaged, 3D momentum (u,v) diagnostic terms into the diagnostics output file.
    Dout(M2rate) == T  ! u_accel, ... acceleration
    Dout(M3pgrd) == T  ! u_prsgrd, ... pressure gradient
    Dout(M3fcor) == T  ! u_cor, ... Coriolis force
    Dout(M3hadv) == T  ! u_hadv, ... horizontal total advection
    Dout(M3xadv) == T  ! u_xadv, ... horizontal XI-advection
    Dout(M3yadv) == T  ! u_yadv, ... horizontal ETA-advection
    Dout(M3vadv) == T  ! u_vadv, ... vertical advection
    Dout(M3hrad) == T  ! u_hrad, ... horizontal total radiation stress
    Dout(M3vrad) == T  ! u_vrad, ... vertical radiation stress
    Dout(M3hvis) == T  ! u_hvisc, ... horizontal total viscosity
    Dout(M3xvis) == T  ! u_xvisc, ... horizontal XI-viscosity
    Dout(M3yvis) == T  ! u_yvisc, ... horizontal ETA-viscosity
    Dout(M3vvis) == T  ! u_vvisc, ... vertical viscosity
  • Logical switches (TRUE/FALSE) to activate writing of time-averaged, active (temperature and salinity) and passive (inert) tracer diagnostic terms into the diagnostics output file. [1:NAT+NPT,1:Ngrids] values are expected.
    Dout(iTrate) == T T  ! temp_rate, ... time rate of change
    Dout(iThadv) == T T  ! temp_hadv, ... horizontal total advection
    Dout(iTxadv) == T T  ! temp_xadv, ... horizontal XI-advection
    Dout(iTyadv) == T T  ! temp_yadv, ... horizontal ETA-advection
    Dout(iTvadv) == T T  ! temp_vadv, ... vertical advection
    Dout(iThdif) == T T  ! temp_hdiff, ... horizontal total diffusion
    Dout(iTxdif) == T T  ! temp_xdiff, ... horizontal XI-diffusion
    Dout(iTydif) == T T  ! temp_ydiff, ... horizontal ETA-diffusion
    Dout(iTsdif) == T T  ! temp_sdiff, ... horizontal S-diffusion
    Dout(iTvdif) == T T  ! temp_vdiff, ... vertical diffusion

Generic User Parameters

  • NUSER is the number (integer) of user parameters to consider. USER is a vector containing NUSER user parameters (real array).
    NUSER = 0
    USER = 0.d0
    This array is primarily used with the SANITY_CHECK to test the correctness of the tangent linear adjoint models. It contains the model variable and grid point to perturb:
    ! INT(user(1)): tangent state variable to perturb
    ! INT(user(2)): adjoint state variable to perturb
    ! [ isFsur = 1 ] free-surface
    ! [ isUbar = 2 ] 2D U-momentum
    ! [ isVbar = 3 ] 2D V-momentum
    ! [ isUvel = 4 ] 3D U-momentum
    ! [ isVvel = 5 ] 3D V-momentum
    ! [ isTvar = 6 ] First tracer (temperature)
    ! [ ... ] ...
    ! [ isTvar = ? ] Last tracer
    !
    ! INT(user(3)): I-index of tangent variable to perturb
    ! INT(user(4)): I-index of adjoint variable to perturb
    ! INT(user(5)): J-index of tangent variable to perturb
    ! INT(user(6)): J-index of adjoint variable to perturb
    ! INT(user(7)): K-index of tangent variable to perturb, if 3D
    ! INT(user(8)): K-index of adjoint variable to perturb, if 3D
    Set tangent and adjoint parameters to the same values if perturbing and reporting the same variable.
  • This parameter could also be used to adjust constants in analytical functions at run time.


NetCDF-4/HDF5 Compression Parameters

  • NetCDF-4/HDF5 compression parameters for output files. This capability is used when both HDF5 and DEFLATE C-preprocessing options are activated. The user needs to compile with the NetCDF-4/HDF5 and MPI libraries. File deflation cannot be used in parallel I/O for writing libraries. File deflation cannot be used in parallel I/O for writing to exactly map the data to the disk location. For more information, check NetCDF official website.
    NC_SHUFFLE = 1  ! if non-zero, turn on shuffle filter
    NC_DEFLATE = 1  ! if non-zero, turn on deflate filter
    NC_DLEVEL = 1  ! deflate level [0-9]

Input NetCDF Files

NoteNOTE: Starting with revision 460 file names can be up to 256 characters long. Previously only 80 characters were allowed.

  • Input NetCDF file names, [1:Ngrids] values are expected.
    GRDNAME == ocean_grd.nc  ! Grid
    ININAME == ocean_ini.nc  ! NLM initial conditions
    ITLNAME == ocean_itl.nc  ! TLM initial conditions
    IRPNAME == ocean_irp.nc  ! RPM initial conditions
    IADNAME == ocean_iad.nc  ! ADM initial conditions
    FWDNAME == ocean_fwd.nc  ! Forward trajectory
    ADSNAME == ocean_ads.nc  ! Adjoint sensitivity functionals
  • Nesting grids connectivity data: contact points information. This NetCDF file is special and complex. It is currently generated using the script matlab/grid/contact.m from the Matlab repository.
    NGCNAME = ocean_ngc.nc
  • Input lateral boundary conditions and climatology file names. The user has the option to split input data time records into several NetCDF files (see the File Syntax Notes). If so, use a single line per entry with a vertical bar (|) symbol after each entry, except the last one.
    BRYNAME == ocean_bry.nc  ! Open boundary conditions
    CLMNAME == ocean_clm.nc  ! Climatology
  • Input climatology nudging coefficients file name.
    NUDNAME == ocean_nud.nc
  • Input Sources/Sinks forcing (like river runoff) file name. This file is separated from the regular forcing files to allow manipulations over nested grids. A particular nesting grid may or may not have Sources/Sinks forcing.
    SSFNAME == ocean_rivers.nc
  • Input forcing NetCDF file name(s). The user has the option to enter several files names for each nested grid. For example, the user may have a different files for wind products, heat fluxes, tides, etc. The model will scan the file list and will read the needed data from the first file in the list containing the forcing field. Therefore, the order of the file names is very important. If multiple forcing files per grid, enter first all the file names for grid 1, then grid 2, and so on. It is also possible to split input data time records into several NetCDF files (see the File Syntax Notes). Use a single line per entry with a continuation ( \ ) or vertical bar ( | ) symbol after each entry, except the last one.
    NFFILES == 1  ! number of unique forcing files

    FRCNAME == ocean_frc.nc  ! forcing file 1, grid 1

Output NetCDF Files

NoteNOTE: Starting with revision 460 file names can be up to 256 characters long. Previously only 80 characters were allowed.

  • Output NetCDF file names, [1:Ngrids] files are expected.
    GSTNAME == ocean_gst.nc  ! GST analysis restart
    RSTNAME == ocean_rst.nc  ! Restart
    HISNAME == ocean_his.nc  ! History
    TLMNAME == ocean_tlm.nc  ! TLM history
    TLFNAME == ocean_tlf.nc  ! Impulse TLM forcing
    ADJNAME == ocean_adj.nc  ! ADM history
    AVGNAME == ocean_avg.nc  ! Averages
    DIANAME == ocean_dia.nc  ! Diagnostics
    STANAME == ocean_sta.nc  ! Stations
    FLTNAME == ocean_flt.nc  ! Floats

Additional Input Scripts

NoteNOTE: Starting with revision 460 file names can be up to 256 characters long. Previously only 80 characters were allowed.