**Welcome to the official ADCIRCWiki site! The site is currently under construction, with limited information. ---**

# Difference between revisions of "A00, B00, C00"

Line 3: | Line 3: | ||

== Typical Values == | == Typical Values == | ||

If the consistent mass-matrix solver is chosen (see [[IM]] parameter) then a semi-implicit method is possible and encouraged. In this case the most common choice for the weighting factors are: <br /> | If the consistent mass-matrix solver is chosen (see [[IM]] parameter) then a semi-implicit method is possible and encouraged. In this case the most common choice for the weighting factors are: <br /> | ||

− | <math>\mathrm{A00} = \mathrm{C00} = 0.35 \quad \mathrm{B00} = 0.30</math> | + | <math>\mathrm{A00} = \mathrm{C00} = 0.35, \quad \mathrm{B00} = 0.30</math> |

If the lumped mass-matrix solver is chosen then only an explicit method is possible (the weighting A00 must be zero as no matrix solve is conducted), and the weighting factors that are typically chosen become simply:<br /> | If the lumped mass-matrix solver is chosen then only an explicit method is possible (the weighting A00 must be zero as no matrix solve is conducted), and the weighting factors that are typically chosen become simply:<br /> | ||

− | <math>\mathrm{A00} = \mathrm{C00} = 0 \quad \mathrm{B00} = 1</math> | + | <math>\mathrm{A00} = \mathrm{C00} = 0, \quad \mathrm{B00} = 1</math> |

== Theory == | == Theory == | ||

Theory is dominated by analysis of the Wave Continuity Equation (WCE), a special case of the Generalized Wave Continuity Equation (GWCE) where the [[TAU0]] parameter is equal to the linear friction coefficient. Analysis began with Lynch and Gray, Foreman, etc, and ended with Kinnemark who was responsible, ultimately, for introducing the GWCE. In all analyses, a second-order centered technique was sought which reduces the choice of A00, B00, C00 to: | Theory is dominated by analysis of the Wave Continuity Equation (WCE), a special case of the Generalized Wave Continuity Equation (GWCE) where the [[TAU0]] parameter is equal to the linear friction coefficient. Analysis began with Lynch and Gray, Foreman, etc, and ended with Kinnemark who was responsible, ultimately, for introducing the GWCE. In all analyses, a second-order centered technique was sought which reduces the choice of A00, B00, C00 to: | ||

− | <math>\mathrm{A00} = \mathrm{C00} = 0.5\theta \quad \mathrm{B00} = 1-\theta</math> | + | <math>\mathrm{A00} = \mathrm{C00} = 0.5\theta, \quad \mathrm{B00} = 1-\theta</math> |

In other words, k+1 and k-1 weightings are always chosen to be equal. | In other words, k+1 and k-1 weightings are always chosen to be equal. | ||

− | Essentially all studies, whether in 1-D (Lynch and Gray etc) or ultimately 2-D with Coriolis and other terms (Kinnemark), found that unconditional stability | + | Essentially all studies, whether in 1-D (Lynch and Gray etc) or ultimately 2-D with Coriolis and other terms (Kinnemark), found that unconditional stability is achieved with the prescription of <math>\theta \geq 0.5</math>. Likely in response to these findings, the typical choice for ADCIRC has become <math>\theta = 0.70</math>, i.e., A00 = C00 = 0.35, B00 = 0.30, as noted above. |

A purely explicit method (<math>\theta = 0</math>) was found to be stable under the following conditions: | A purely explicit method (<math>\theta = 0</math>) was found to be stable under the following conditions: |

## Revision as of 23:36, 6 July 2019

**A00, B00, C00** are the weighting factors (at time levels k+1, k, k-1, respectively) for the free surface and boundary fluxes in the GWCE, and must sum to 1. Most critically, the weighting factors are used in the discretization of the linear gravity wave (pressure gradient) term and are responsible for determining the inherent implicity (impacting solution stability), in addition to order of accuracy and dispersive characteristics of the numerical method.

## Contents

## Typical Values

If the consistent mass-matrix solver is chosen (see IM parameter) then a semi-implicit method is possible and encouraged. In this case the most common choice for the weighting factors are:

If the lumped mass-matrix solver is chosen then only an explicit method is possible (the weighting A00 must be zero as no matrix solve is conducted), and the weighting factors that are typically chosen become simply:

## Theory

Theory is dominated by analysis of the Wave Continuity Equation (WCE), a special case of the Generalized Wave Continuity Equation (GWCE) where the TAU0 parameter is equal to the linear friction coefficient. Analysis began with Lynch and Gray, Foreman, etc, and ended with Kinnemark who was responsible, ultimately, for introducing the GWCE. In all analyses, a second-order centered technique was sought which reduces the choice of A00, B00, C00 to:

In other words, k+1 and k-1 weightings are always chosen to be equal. Essentially all studies, whether in 1-D (Lynch and Gray etc) or ultimately 2-D with Coriolis and other terms (Kinnemark), found that unconditional stability is achieved with the prescription of . Likely in response to these findings, the typical choice for ADCIRC has become , i.e., A00 = C00 = 0.35, B00 = 0.30, as noted above.

A purely explicit method () was found to be stable under the following conditions:

- : lumped mass-matrix solved in 1-D
- : consistent non-lumped mass-matrix solved in 1-D
- : lumped mass-matrix solved in 2-D.

As one can see, stability (and dispersive characteristics) is superior for the lumped mass-matrix solver versus the consistent non-lumped mass-matrix solver, hence the lumped solver should always be chosen when employing an explicit method (see IM parameter for setting the solver type).

## Critique

Since theory is based on the WCE instead of the GWCE, stability was found to be independent of the choice of TAU0 (). However, from experience a larger value of always tend to be more unstable than a smaller value. This makes sense since the behavior of the equations will become more and more similar to the Primitive Continuity Equation with greater , which is responsible for 2Δx instabilities - the motive for using the GWCE in the finite-element method. Further analysis of the GWCE is required to determine stability with respect to the choice of and different weighting factors (possibly non-centered, i.e., ).

Moreover, the equations analysed are always linearized (a requirement of the von Neumann stability analysis), thus unconditional stability may not be possible for the semi-implicit method when simulating real-world problems, especially those with fine-grid sizes and where nonlinearities are non-trivial. In such cases where it is not possible to achieve time steps more than twice that possible with an explicit method it becomes preferable to employ the explicit lumped mass-matrix solver since it is computationally twice as fast per time step solve.