There are two primary types of numerical wave–makers: Internal and Boundary. In this section, we will discuss internal wave–maker theory.

## Internal wave–maker theory¶

The internal wavemaker was implemented based on Wei et al. (1999) two–way internal wavemaker and Chawla and Kirby (2000) one–way internal wavemaker (under development). Here, we briefly summarize the formulations used in the wavemakers. Detailed theory can be found in Wei and Kirby (1999) and Chawla and Kirby (2000).

Wei and Kirby (1999) followed the approach of Larsen and Dancy (1983) who used an ad–hoc source mechanism where water mass is added and subtracted along a straight source/sink line inside the computing domain. This approach works well in a staggered–grid differencing scheme, where water is essentially being added to or drained from a single grid block. In applying this technique to the Boussinesq model on an unstaggered grid, however, Wei and Kirby found that use of a single source line accused high frequency noise, leading to blowup of the model. They then used a partially distributed mass source $$f(x,y,t)$$:

(20)$f(x,y,t) = g(x) s(y,t)$

where $$g(x)$$ is a Gaussian shape function and $$s(y,t)$$ the input time series of the magnitude of source function with an assumption that the center of the source region is parallel to the y–axis. The functions $$g(x)$$ and $$s(y,t)$$ are defined as:

(21)$g(x) = \mbox{exp}[-\beta(x-x_s)^2]$
(22)$s(y,t) = D \mbox{sin} (\lambda y -\omega t)$

where $$\beta$$ is the shape coefficient for the source function, and $$x_s$$ is the central location of the source in the $$x$$ direction, for a source oriented parallel to the $$y$$ axis, as shown in the figure below. $$D$$ is the magnitude of the source function, $$\lambda = k \mbox{sin} (\theta)$$ the wavenumber in the $$y$$ direction, and $$k$$ is the linear wavenumber.

For a monochromatic wave or a single wave component of a random wave train, the magnitude $$D$$ of source function can be determined by:

(23)$D = \frac{2 a_0 \cos (\theta) (\omega^2 - \alpha_1 g k^4 h^3) }{\omega k I [1-\alpha(kh)^2]}$

where $$\alpha = -0.390, \alpha_1 = \alpha + 1/3$$, and $$I$$ is the integral given by:

(24)$I = \int^\infty_{-\infty} \exp (-\beta x^2) \exp (-ilx) dx = \sqrt{\frac{\pi}{\beta}} \exp(- l^2/4\beta)$

where $$l=k\cos (\theta)$$ is the wavenumber in the $$x$$ direction. In theory, the shape coefficient $$\beta$$ can be any number. The larger the value of $$\beta$$ is, the narrower the source function becomes. The definition of the source function width $$W$$ is not unique, and here we define $$W$$ to be the distance between two coordinates $$x_1$$ and $$x_2$$ where the corresponding source function heights are equal to $$\exp (-5) = 0.0067$$ times the maximum height $$D$$. Then $$x_1$$ and $$x_2$$ must satisfy the quadratic equation:

(25)$\beta (x-x_s)^2 = 5$

from which the width of source function is given by:

(26)$W = |x_2 - x_1| = 2\sqrt{\frac{5}{\beta}}$

In the previous version of FUNWAVE (Kirby et al., 1998), it is suggested that $$W$$ equals about half of the wavelength for monochromatic wave. If $$L$$ is the wavelength, the requirement of $$W=\delta L/2$$ (where $$\delta$$ is of order 1) results in:

(27)$\beta = \frac{5}{(\delta L/4)^2} = \frac{80}{\delta^2 L^2}$

For random waves, the value of $$\beta$$ is determined according to the peak frequency component and then used for all components in the wave train. FUNWAVE–TVD follows the criteria for determining $$\beta$$, though a narrow $$W$$ does not seem to cause any problem.

For the irregular wavemaker, an extension was made to incorporate an alongshore periodicity into wave generation, in order to eliminate a boundary effect on wave simulations. The technique exactly follows the strategy in Chen et al. (2003), who adjusted the distribution of wave directions in each frequency bin to obtain alongshore periodicity. This approach is effective in modeling of breaking wave–induced nearshore circulation such as alongshore currents and rip currents.

### Regular wave generation¶

The generation of monochromatic wave using the internal wavemaker is straightforward. Following the formulations given in 3.7.1, the magnitude of source function $$D$$ is calculated by Equation 13 shown above for given wave amplitude $$a_0$$, wave angle $$\theta$$, water depth $$h$$ and wave period $$T=1/2\pi\omega$$. The source function can be obtained using the Source function above.

### Irregular wave generation¶

• Using directional spectral data

Irregular waves can be generated by integrating wave components split by frequency and direction and with random phases. Each wave component contains wave amplitude $$a_0$$ converted from wave energy, wave angle $$\theta$$ and wave period $$T$$. The source function for each component can be obtained using the source function.

• Using analytical spectrum function

The input for the wavemaker can be wave bulk parameters or directional spectral data. TMA shallow–water spectrum, JONSWAP spectrum and a wrapped–normal directional–spreading function are used to simulate a directional sea state. The combined spectrum function can be expressed as:

(28)$S(f,h,\theta) = E(f,h) G(\theta)$

$$E$$ is the energy density distribution as follows:

(29)$E (f,h) = \alpha g^2 f^{-5} (2 \pi)^{-4} \Phi (2\pi f, h) e^{-5/4(f/f_p)^{-4}} \gamma^{e^{[-(f/f_p -1)^2 /2\sigma^2]}}$

in which $$f_p$$ is the peak frequency. $$\gamma$$ presents a frequency spreading parameter, and $$\alpha$$ and $$\sigma$$ are coefficients which may be found in Bouws et al. (1985) $$\alpha$$ is obtained using the input $$H_{mo}/H_{sig}$$:

(30)$\sigma = 0.07 \ \ \ \ f \leq f_p$
(31)$\sigma = 0.09 \ \ \ \ f > f_p$

$$\Phi$$ = 1.0 for the JONSWAP spectrum. For TMA, $$\Phi$$ may be expressed as:

(32)$\Phi (2 \pi f, h) =\frac{1}{2} \omega_h^2 \ \ \ \ \omega_h \leq 1$
(33)$\Phi (2 \pi f, h) = 1-\frac{1}{2}(2-\omega_h)^2 \ \ \ \ 2 > \omega_h >1$
(34)$\Phi (2 \pi f, h) = 1 \ \ \ \ \omega_h \geq 2$

where,

(35)$\omega_h = 2 \pi f (\frac{h}{g})^{1/2}$

Here, $$G(\theta)$$ is the wrapped normal directional spreading function written as:

(36)$G(\theta) = \frac{1}{2\pi} +\frac{1}{\pi} \sum^N_{n=1} e^{[-\frac{( \sigma_{\theta})^2}{2}]} \cos n\theta$

where $$\sigma_{\theta}$$ denotes circular deviation of the wrapped normal spreading function. To avoid the computational underflow, $$N = 20$$ in the model.

In the spectral wavemaker, the directional spectrum is first divided into $$1000$$ frequency components and then reconstructed into a user–specified number of components with the equal energy. The directional components are evenly split in each frequency. The source function technique (Wei, et al., 1999) is then used for each component and the final surface elevation function can be written as:

(37)$\eta = \sum^M_{m=1} C_m \cos \omega _m t + \sum^M_{m=1} S_m \sin \omega _m t$

where,

(38)$C_m = \sum^k_{n=1} D_{mn} \cos (k_{mn}y + \varepsilon_{mn})$
(39)$S_m = \sum^k_{n=1} D_{mn} \sin (k_{mn}y + \varepsilon_{mn})$

in which y–axis is oriented along the main axis of the wave maker. $$D_{mn}, k _{mn}$$ and $$\varepsilon_{mn}$$ are the amplitude, wave number in the y direction and phase of a component, respectively. The phase can be random.

The model also provides an option for 1–D spectral wave generation (uni–directional).

### Wavemaker with user-specified wave coherence¶

Users can specify degree of wave cohenrence according to the technique proposed by Salatin et al. (2021). The instruction for such a wavemaker setup and examples and be found in Wave-maker specification.

## References¶

Bouws, E., Günther, H., Rosenthal, W., Vincent, C.L., 1985. “Similarity of the Wind Wave Spectrum in Finite Depth Water: 1. Spectral Form”. J. of Geophysical Research, 90, NO. C1, 975-986. DOI: 10.1029/JC090iC01p00975.

Chawla, A., and Kirby, J.T., 2000. “A source function method for generation of waves on currents in Boussinesq models”. App. Ocean Research, 22 (2), 75-83. DOI: 10.1016/S0141-1187(00)00005-5.

Chen, Q., Kirby, J.T., Dalrymple, R.A., Shi, F., Thorton, E.B., 2003. “Boussinesq modeling of longshore currents”. J. of Geophysical Research, 108, NO. C11, 3362. DOI: 10.1029/2002JC001308

Kirby, J.T., Wei, G., Chen, Q., Kennedy, A.B., Dalrymple, R.A., 1998. “Funwave 1.0: Fully Nonlinear Boussinesq Wave Model – Documentation and User’s Manual”. Hydraulic Eng. Reports: NO. CACR-98-06. University of Delaware.

Salatin, R., Chen, Q., Bak, A. S., Shi, F., and Brandt, S. R., 2021, Effects of Wave Coherence on Longshore Variability of Nearshore Wave Processes, Journal of Geophysical Research - Ocean, DOI:1029/2021JC017641

Wei, G., Kirby J.T., Sinha, A., 1999. “Generation of waves in Boussinesq models using a source function method”. Coastal Eng. 36 (4), 271-299. DOI: 10.1016/S0378-3839(99)00009-5