Namelist file documentation

This page describes in details the parameters used by GOTM and specified in the various namelist files *.inp file. The current set of parameters corresponds to the Ooster Schelde test case. Some of the parameters are underlined to stress their frequent use and modification. In the "Unit" column, you can find either:

In the "description" column, you get




Namelist file

Parameter Value Unit Description


&airsea

Air Sea interactions

heat_method (int) Method to impose heat flux (positive downward)
const_qin (W/m^2) Solar flux (penetrating into water) (opt[1])
const_qout (W/m^2) Non solar heat flux (Latent+Sensible+Infrared) (opt[1])
heat_flux_file (char) Filename for heat flux (opt[2])
momentum_method (int) Method to impose wind stress
const_tx (N/m^2) Wind stress x-component (opt[1])
const_ty (N/m^2) Wind stress y-component (opt[1])
momentum_flux_file (char) Filename for wind forcing (opt[2])
p_e_method (int) Method to impose freshwater flux
p_e_flux_file (char) Filename for freshwater flux (opt[2])
sst_method (int) Method to impose sea surface temperature
sst_file (char) Filename for surface T (opt[2])
sss_method (int) Method to impose sea surface salinity
sss_file (char) Filename for surface S (opt[2])
airt_file (char) Filename for air T


&model_setup

General Model Set-up

title (char) Title of the simulation
nlev (int) Number of vertical levels
dt (s) Time step
cnpar (/) [0-1] Implictness factor for time-resolution
buoy_method (int) Method to compute density (Diagnostic/Prognostic)


&station

Station Information

name (char) Name of the oceanic station
latitude (deg) Latitude S-N
longitude (deg) Longitude W-E
depth (m) Local depth


&time

Time format

timefmt (int) Implicitly uses timestep=dt
MaxN (int) Maximal index for time loop
start (char) Initial time (yyyy/mm/dd hh:mm:ss)
stop (char) Final time (yyyy/mm/dd hh:mm:ss)


&output

Model output specifications

out_fmt (int) Select output format
out_dir (char) Path from here to output directory (set permissions)
out_fn (char) Filename for outputs (extension is appended)
nsave (int) Frequency of saving
variances .true. .false. (bool) Variances are written to output
diagnostics .true. .false. (bool) Diagnostics are written to output?
mld_method (int) Select Mixed Layer Depth (MLD) definition criterium
diff_k (m^2/s^2) Critical TKE for MLD definition (opt[1])
ri_crit (/) Critical Ri number for MLD definition (opt[2])
rad_corr .true. .false. (bool) Correct surface buoyancy flux for solar radiation


&eqstate

Equation of State

eq_state_method (int) Select form of equation of state
T0 (deg) Reference temperature
S0 (psu) Reference salinity
p0 (bar) Reference pressure
dtr0 (kg/m^3/K) Thermal expansion coefficient (opt[4])
dsr0 (kg/m^3/psu) Saline expansion coefficient (opt[4])


&meanflow

Dynamical parameters

h0b (m) Bottom roughness - Note: z0b=0.03*h0b+..
h0s (m) Surface roughness - Note: z0b=0.03*h0s+..
ddu (int) Upper grid zooming parameter
ddl (int) Lower grid zooming parameter
gravity (m/s^2) Gravity acceleration
rho_0 (kg/m^3) Reference density
cp (J/kg/K) Specific heat of sea water
avmolu (m^2/s) Molecular viscosity for momentum
avmolt (m^2/s) Molecular diffusivity for T
avmols (m^2/s) Molecular diffusivity for S
MaxItz0b (int) Max # of iterations for z0b as function of u_taub


&sprofile

Salinity Profile

s_prof_method (int) Select type of S profile
z_s1 (m) Upper layer thickness (opt[1])
s_1 (psu) Upper layer salinity (opt[1])
z_s2 (m) Depth of start of lower layer (opt[1])
s_2 (psu) Lower layer salinity (opt[1])
s_prof_file (char) Filename with S profile (opt[2])
SRelaxTauM (s) Maximum Relaxation Time


&tprofile

Temperature Profile

t_prof_method (int) Select the type of T profile
z_t1 (m) Upper layer thickness (opt[1])
t_1 (psu) Upper layer temperature (opt[1])
z_t2 (m) Depth of start of lower layer (opt[1])
t_2 (psu) Lower layer temperature (opt[1])
t_prof_file (char) Filename with T profile (opt[2])
TRelaxTauM (s) Maximum Relaxation Time


&bprofile

Buoyancy Profile

b_obs_surf (m/s^2) Prescribed initial buoyancy at the surface
b_obs_NN (/s) Prescribed initial Brunt-Vaisalla frequency
b_obs_sbf (m/s^2) Prescribed constant surface buoyancy flux


&ext_pressure

External Pressure Gradient

ext_press_method (int) Select type of barotropic forcing
PressMethod (int) Select imposition of pressure gradient
ext_press_file (char) Pressure filename (opt[2])
PressConstU (/) Constant x-pressure grad (opt[0])
PressConstV (/) Constant y-pressure grad (opt[0])
PressHeight (m) Height above bottom of current obs
PeriodM (s) Period of 1. harmonic of M2 tide (opt[1])
AmpMu (m/s) u amp. of 1. harmonic (opt[1])
AmpMv (m/s) v amp. of 1. harmonic (opt[1])
PhaseMu (deg|rad) u phase of 1. harmonic (opt[1])
PhaseMv (deg|rad) v phase of 1. harmonic (opt[1])
PeriodS (s) Period of 1. harmonic for S tide (opt[1])
AmpSu (m/s) u amp. of 1. harmonic (opt[1])
AmpSv (m/s) v amp. of 1. harmonic (opt[1])
PhaseSu (deg|rad) u phase of 1. harmonic (opt[1])
PhaseSv (deg|rad) v phase of 1. harmonic (opt[1])


&int_pressure

Internal Pressure Gradient

int_press_method (int) Select type of baroclinic forcing
int_press_file (char) Filename for Internal Pressure (opt[2])
const_dsdx (psu/m) Salinity x-grad (opt[0])
const_dsdy (psu/m) Salinity y-grad (opt[0])
const_dtdx (K/m) Temperature x-grad (opt[0])
const_dtdy (K/m) Temperature y-grad (opt[0])
const_idpdx (m/s^2) Salinity x-grad (opt[0])
const_idpdy (m/s^2) Salinity y-grad (opt[0])
s_adv .true. .false. (bool) Advection of S
t_adv .true. .false. (bool) Advection of T


&zetaspec

Sea surface elevation

zeta_method (int) Select type of elevation
zeta_file (char) Filename Elevation (opt[2])
zeta0 (m) Constant sea surface elevation (opt[0])
Period1 (s) Period harmonic 1 of M2 (opt[1])
Amp1 (m) Amplitude harmonic 1 of M2 (opt[1])
Phase1 (deg|rad) Phase harmonic 1 of M2 (opt[1])
Period2 (s) Period harmonic 2 of M2 (opt[1])
Amp2 (m) Amplitude harmonic 2 (opt[1])
Phase2 (deg|rad) Phase harmonic 2 of M2 (opt[1])


&extinct

Light Extinction Method

zeta_method (int) Select water clearance type
extinct_file (char) Filename for Extinction data (opt[7])


&turbulence

Turbulence Settings

turb_method (int) Select turbulence method
tke_method (int) TKE method
len_scale_method (int) Length-scale method [Info]
stab_method (int) Stability function method
length_lim .true. .false. (bool) Apply length limitation
k_min (m^2/s^2) Minimal TKE
L_min (m) Minimal Length scale
eps_min (>>) Minimal Dissipation


&turb_parameters

Turbulence Parameters

kappa (/) Von Karman's constant
Prandtl0 (/) Turbulent Pradntl number
cm0 (/) Stabi func for momentum for unstrat equilibrium flow
cmucst (/) Coefficient in stability function for momentum
galp (/) Coefficient for length limitation


&keps

Constants for k-eps model

ce1 (/) Empirical coeff in diss eq
ce2 (/) Empirical coeff in diss eq
ce3minus (/) ce3 for stable stratification
ce3plus (/) ce3 for un-stable stratification
sig_k (/) Schimdt number for TKE eddy diffus
flux_bdy .true. .false. (bool) Flux boundary condition? [Info]


&my

Constants for k-kL model of MY

sl (/) Eddy diffu of k & kL
e1 (/) Coeff in MY kL equation
e2 (/) Coeff in MY kL equation
e3 (/) Coeff in MY kL equation
MY_method (int) MY method


&stabfunc

Constants for Stability Function

a1 (/) Coeff in Galperin QE SF
a2 (/) Coeff in Galperin QE SF
b1 (/) Coeff in Galperin QE SF
b2 (/) Coeff in Galperin QE SF
c2 (/) 0 for Galperin SF, 0.7 for KC SF
c3 (/) 0 for Galperin SF, 0.2 for KC SF
qehsmooth .true. .false. (bool) Smooth in unstable stratification?
qehmax (/) Max value of parameter gh in qeSF
qehmin (/) Min value of parameter gh in qeSF
qehcrit (/) Critical value of gh to start smoothing


&iw

Internal waves parameters

IW_model (int) IW method
alpha (/) Coeff for extra shear by N^2 (opt[1])
klimiw (m^2/s^2) Critical TKE activating (opt[2])
rich_cr (/) Critical value for Richardson number (opt[2])
numshear (m^2/s) Background diffusivity for Shear Instability (opt[2])
numiw (m^2/s) Background diffusivity for Internal Wave breaking (opt[2])
nuhiw (m^2/s) Background viscosity for Internal Wave breaking (opt[2])


&sedi

Sediment Module

sedi_calc .true. .false. (bool) Switch on sediment model?
sedi_dens .true. .false. (bool) Active effect of sediment on density?
rho_sed (kg/m^3) Density of sediments (opt[1])
size (m) Diameter of sediment particle
init_conc (/) Initial relative sediment concentration
adv_method (int) Advection scheme
cnpar (/) Crank-Nicholson parameter
Bcup (int) Upper boundary specification (not change)
Bcdw (int) Lower boundary specification (not change)
Cup (kg/m^3) BC specification (not change)
CbObsDt (s) Relaxation of bed sediment to analytical sol
z0bMmethod (int) Method to determine z0