diff --git a/docs/input-output/param.md b/docs/input-output/param.md index 57429ece4..ebeae0e3c 100644 --- a/docs/input-output/param.md +++ b/docs/input-output/param.md @@ -51,6 +51,9 @@ These parameters set the # of tracer ‘classes’ for each tracer module (EcoSi ### nspool, ihfskip (int) These two flags control the global netcdf outputs. Output is done every `nspool` steps, and a new output stack is opened every `ihfskip` steps. The code requires that `ihfskip` is a multiple of `nspool`, and `nhot_write` (see SCHOUT section) is a a multiple of `ihfskip`. +### nbins_veg_vert (int) +Number of vertical bins used in vegetation option `iveg=1`. + ## OPT block The optional parameters below are explained in alphabetical order. The default values can be seen below and also in the sample file (sample_inputs/). @@ -96,15 +99,6 @@ In addition, there are parameters related to Vortex Formalism of Bennice and Ard ### ics=1 (int) Coordinate frame flag. If `ics=1`, Cartesian coordinates are used; if `ics=2`, both `hgrid.ll` and `hgrid.gr3` use degrees latitude/longitude (and they should be identical to each other in this case). -### i_hmin_airsea_ex (int), hmin_airsea_ex (double; in meters) -Option to locally turn off heat exchange. - -- `i_hmin_airsea_ex=1`: exchange turned off if `local grid depth0`). In general, `indvel=0` leads to smaller numerical dissipation and better accuracy, but does generally require a velocity B.C. -Due to spurious modes or dispersion (oscillation), viscosity/filter should be applied. `ihorcon=0`:no horizontal viscosity; `=1`: Laplacian (implemented as a filter); `=2`: bi-harmonic. For `ihorcon/=0`, `hvis_coef0` specifies the non-dimensional viscosity. In addition to the viscosity, one can add the Shapiro filter, which is specified by `ishapiro` =0,±1, 2 (turn off/on Shapiro filter). If `ishapiro=1`, `shapiro0` specifies the Shapiro filter strength. If `ishapiro=-1`, an input called `shapiro.gr3` is required which specifies the filter strength at each node (there is a pre-proc script `gen_slope_filter2.f90` for this). If `ishapiro=2`, a Smagorinsky-like filter is applied and `shapiro0` is a coefficient $(\gamma_0)$, which is on the order of $10^3$: +Due to spurious modes or dispersion (oscillation), viscosity/filter should be applied. `ihorcon=0`:no horizontal viscosity; + `=1`: Laplacian (implemented as a filter); `=2`: bi-harmonic. For `ihorcon/=0`, `hvis_coef0` +specifies the non-dimensional viscosity. In addition to the viscosity, one can add the Shapiro filter, +which is specified by `ishapiro` =0,±1, 2 (turn off/on Shapiro filter). If `ishapiro=1`, `shapiro0` +specifies the Shapiro filter strength. If `ishapiro=-1`, an input called `shapiro.gr3` is +required which specifies the filter strength at each node (there is a pre-proc script `gen_slope_filter2.f90` +for this). If `ishapiro=2`, a Smagorinsky-like filter is applied and `shpiro.gr3` specifies the coefficient $(\gamma_0)$, +which is typically 10-$10^3$: \begin{equation} \label{eq01} @@ -235,8 +257,18 @@ i.e. (horizontal `+ or *` vertical relaxation factors) times `dt`. Choice of inundation algorithm. `inunfl=1` can be used if the horizontal resolution is fine enough, and this is critical for tsunami simulations. Otherwise use `inunfl=0`. -### isav=0 (int) -Parameters for submerged or emergent vegetation. If `isav=1` (module on), you need to supply 4 extra inputs: `sav_cd.gr3` (form drag coefficient), `sav_D.gr3` (depth is stem diameter in meters); `sav_N.gr3` (depth is # of stems per m2); and `sav_h.gr3` (height of canopy in meters). +### iveg=0 (int) +Parameters for submerged or emergent vegetation. If `iveg/=0`, you need to supply 4 extra inputs: +`veg_cd.gr3` (form drag coefficient), `veg_D.gr3` (depth is stem diameter in meters); + `veg_N.gr3` (depth is # of stems per m2); and `veg_h.gr3` (height of canopy in meters). These are original, unbent + values for the vegetation. + +If `iveg=1`, the vertical variation/scalings for these parameters are specified for `nbins_veg_vert` vertical bins, with + `veg_vert_z(1:nbins_veg_vert+1)` specifying the distance from bed (in meters) for each bin + (ascending order starting from 0). The vertical scalings are given by `veg_vert_scale_[cd,N,D](1:nbins_veg_vert+1)`. + +If `iveg=2`, flexible vegetation formulation of Ganthy et al. (2011) is used. Parameters needed for this case are: + non-dimensional Leaf Area Index `veg_lai` and `veg_cw` (a non-dimensional calibration coefficient for diameter of bent leaf). ### itr_met=3 (int), h_tvd=5. (double) Transport option for all tracers. `itr_met=3` for TVD, and `itr_met=4` for 3rd order WENO. `h_tvd` specifies the transition depth (in meters) between upwind and higher-order schemes; i.e. more efficient upwind is used when the `local depth < h_tvd`. @@ -270,9 +302,6 @@ inside, you may consult [gotm.net](https://gotm.net) for more details. !!! note 1. GOTM has only been tested up to v5.2, not newer versions of GOTM. Using `itur=3` generally gave similar results, but GOTM can produce substantially better stratification in some cases. -### meth_sink=1 (int) -Option for sinks. If `meth_sink =1`, the sink value is reset to `0` if an element is dry with -a net sink value locally to prevent further drawdown of groundwater. ### nadv=1 (int), dtb_min=10, dtb_max=30 (double) Advection on/off option. If `nadv=0`, advection is selectively turned off based on the input file `adv.gr3`. @@ -298,7 +327,8 @@ wind is applied (and `wtiminc` becomes unused). If `nws=1`, constant wind is app at any given time, and the time history of wind is read in from `wind.th`. If `nws=2`, spatially and temporally variable wind is applied and the input consists of a number of netcdf files in the directory `sflux/`. The option `nws=3` is reserved for coupling with atmospheric model via ESMF caps. If `nws=4`, -the required input `wind.th` specifies wind and pressure at each node and at time of multiple of `wtiminc`. +the required input `atmos.nc` specifies wind and pressure at each node and at time of multiple of `wtiminc`. +Additional inputs (e.g. heat fluxes) are needed if heat/salt exchange module is invoked. If `nws=-1` (requires USE_PAHM), use Holland parametric wind model (barotropic only with wind and atmos. pressure). In this case, the Holland model is called every step so wtiminc is not used. An extra input is needed: `hurricane-track.dat`. @@ -339,6 +369,10 @@ Implicitness parameter (between 0.5 and 1). Recommended value: 0.6. Use '1' to g ### iout_sta=0, nspool_sta=10 (int) Station output flag. If `iout_sta≠0`, an input `station.in` is needed. In addition, `nspool_sta` specifies the spool for station output. In this case, **make sure `nhot_write` is a multiple of `nspool_sta`**. +### iof_ugrid (int) +UGRID option for outputs under scribed IO. If iof_ugrid/=0, outputs will also have UGRID metadata (at +the expense of file size). + ### nc_out =1(int) Main switch to turn on/off netcdf outputs, useful for other programs (e.g., ESMF) to control outputs. diff --git a/sample_inputs/param.nml b/sample_inputs/param.nml index 43cf6cd49..7dac97aaa 100644 --- a/sample_inputs/param.nml +++ b/sample_inputs/param.nml @@ -590,7 +590,7 @@ !----------------------------------------------------------------------- ! Option to add a sediment layer for the buffer effect on temperature -! stemp_stc=0 recovers previous results +! stemp_stc=0 would turn off this effect. !----------------------------------------------------------------------- stemp_stc = 0.0 !heat transfer coefficient W.m-2.K-1 stemp_dz(1)= 1.0 !equivalent sediment buffer depth (m) for heat into sediment diff --git a/src/Readme.beta_notes b/src/Readme.beta_notes index bceaf7aab..a4af3ee7b 100644 --- a/src/Readme.beta_notes +++ b/src/Readme.beta_notes @@ -24,10 +24,10 @@ Github versions: - `376b3a45` (14 Sept, 2023) : removed iflux_out_format (folded it into iflux); Tag stofs3d-atl.v2.1.0 (identical to v5.11.0): for NOAA STOFS3D Atlantic operational forecast release -Tag v5.11.0: (Aug 2022) +Tag v5.11.0: (Aug 2023) - `ae1c210` (14 June 2023): ishapiro=2 now needs shapiro.gr3 (variable coefficients); -- `a6fd5cb` (15 May, 2023): revamped nws=4; input is 'atmos'nc'. It needs wind and air pressure at least. +- `a6fd5cb` (15 May, 2023): revamped nws=4; input is 'atmos.nc'. It needs wind and air pressure at least. If ihconsv/=0, it should also contain 2 heat fluxes ('solar' and 'downwardNetFlux'; the latter is the net surface heat flux). If isconsv/=0, it should also contain 2 salt fluxes: 'prate' and 'evap'.