IM - Revision history

Wpringle: /* Default IM Values */

2020-08-21T19:30:43Z

Default IM Values

← Older revision		Revision as of 15:30, 21 August 2020
Line 32:		Line 32:
	\|-		\|-
	\| 20		\| 20
	\| ~~111114~~		\| -
	\| Baroclinic 2DDI		\| Baroclinic 2DDI
	\|-		\|-
	\| 21		\| 21
	\| ~~611114~~		\| -
	\| Baroclinic 3D velocity-based momentum		\| Baroclinic 3D velocity-based momentum
	\|-		\|-

Wpringle: /* Six-digit IM Codes */

2020-07-19T22:02:47Z

Six-digit IM Codes

← Older revision		Revision as of 18:02, 19 July 2020
Line 94:		Line 94:
	\| -		\| -
	\| -		\| -
	\| ~~A value of 4~~-~~6 does the same as 1-3 (same order) but in baroclinic mode<br/><code>CBaroclinic=.TRUE.</code> {{ADC version\|version=55\|relation=+}}~~		\| -
	\|-		\|-
	\| 5		\| 5
Line 110:		Line 110:
	\| -		\| -
	\| -		\| -
	\| ~~See above~~		\| -
	\|}		\|}

Wpringle: /* Default IM Values */

2020-07-12T20:34:28Z

Default IM Values

← Older revision		Revision as of 16:34, 12 July 2020
Line 32:		Line 32:
	\|-		\|-
	\| 20		\| 20
	\| ~~111113~~		\| 111114
	\| Baroclinic 2DDI		\| Baroclinic 2DDI
	\|-		\|-
	\| 21		\| 21
	\| ~~611113~~		\| 611114
	\| Baroclinic 3D velocity-based momentum		\| Baroclinic 3D velocity-based momentum
	\|-		\|-

Wpringle: /* Six-digit IM Codes */

2020-07-11T01:13:59Z

Six-digit IM Codes

← Older revision		Revision as of 21:13, 10 July 2020
Line 94:		Line 94:
	\| -		\| -
	\| -		\| -
	\| A value of 4-6 does the same as 1-3 (same order) but in baroclinic mode<br/><code>CBaroclinic=.TRUE.</code> {{~~Version support box~~\|version=55\|relation=+~~\|support=tp~~}}		\| A value of 4-6 does the same as 1-3 (same order) but in baroclinic mode<br/><code>CBaroclinic=.TRUE.</code> {{ADC version\|version=55\|relation=+}}
	\|-		\|-
	\| 5		\| 5

Wpringle: /* Six-digit IM Codes */

2020-07-10T21:43:58Z

Six-digit IM Codes

← Older revision		Revision as of 17:43, 10 July 2020
Line 94:		Line 94:
	\| -		\| -
	\| -		\| -
	\| A value of 4-6 does the same as 1-3 (same order) but in baroclinic mode<br/><code>CBaroclinic=.TRUE.</code> {{~~ADC version~~\|version=55~~: Technical Preview~~\|relation=+}}		\| A value of 4-6 does the same as 1-3 (same order) but in baroclinic mode<br/><code>CBaroclinic=.TRUE.</code> {{Version support box\|version=55\|relation=+\|support=tp}}
	\|-		\|-
	\| 5		\| 5

Wpringle: /* Six-digit IM Codes */

2020-07-10T14:31:50Z

Six-digit IM Codes

← Older revision		Revision as of 10:31, 10 July 2020
Line 86:		Line 86:
	\| Conservative form 2<br/><code>CME_New_C2=.TRUE.</code>		\| Conservative form 2<br/><code>CME_New_C2=.TRUE.</code>
	\| -		\| -
	\| Consistent (implicit for full gravity wave term), barotropic<br/><code>CGWCE_HDP=.TRUE.</code>, <code>IFNL_HDP=1</code>, <code>ILump=0</code> {{ADC version\|version=55\|relation=eq}}		\| Consistent (implicit for full gravity wave term), barotropic<br/><code>CGWCE_HDP=.TRUE.</code>, <code>IFNL_HDP=1</code>, <code>ILump=0</code> {{ADC version\|version=55\|relation=+}}
	\|-		\|-
	\| 4		\| 4
Line 94:		Line 94:
	\| -		\| -
	\| -		\| -
	\| A value of 4-6 does the same as 1-3 (same order) but in baroclinic mode<br/><code>CBaroclinic=.TRUE.</code> {{ADC version\|version=55\|relation=eq}}		\| A value of 4-6 does the same as 1-3 (same order) but in baroclinic mode<br/><code>CBaroclinic=.TRUE.</code> {{ADC version\|version=55: Technical Preview\|relation=+}}
	\|-		\|-
	\| 5		\| 5

Wpringle: /* Six-digit IM Codes */

2020-07-10T14:24:20Z

Six-digit IM Codes

← Older revision		Revision as of 10:24, 10 July 2020
Line 115:		Line 115:
	A common code combination is <code>IM=111112</code>, which is identical to the default <code>111111</code> (same as <code>IM=0</code>), but simulates in explicit mass-lumping mode. Note that <code>[[A00, B00, C00]]</code> must be set to <code>0.0 1.0 0.0</code> when in this mode. Lumped explicit mode is a useful alternative to the (default) semi-implicit consistent GWCE mass matrix mode, because the latter requires a matrix solve that increases computational time and memory. By comparison, the explicit mass-lumping mode is about twice as fast and scales to fewer grid nodes per computational core.<ref>S. Tanaka, S. Bunya, J.J. Westerink, C. Dawson, R.A. Luettich, Scalability of an Unstructured Grid Continuous Galerkin Based Hurricane Storm Surge Model, J. Sci. Comput. 46 (2011) 329–358. doi:10.1007/s10915-010-9402-1</ref> Moreover, for model setups that are sufficiently resolved in space and time, differences in the solution between approaches should be small. Though, many users have reported somewhat lower stability in lumped explicit mode.		A common code combination is <code>IM=111112</code>, which is identical to the default <code>111111</code> (same as <code>IM=0</code>), but simulates in explicit mass-lumping mode. Note that <code>[[A00, B00, C00]]</code> must be set to <code>0.0 1.0 0.0</code> when in this mode. Lumped explicit mode is a useful alternative to the (default) semi-implicit consistent GWCE mass matrix mode, because the latter requires a matrix solve that increases computational time and memory. By comparison, the explicit mass-lumping mode is about twice as fast and scales to fewer grid nodes per computational core.<ref>S. Tanaka, S. Bunya, J.J. Westerink, C. Dawson, R.A. Luettich, Scalability of an Unstructured Grid Continuous Galerkin Based Hurricane Storm Surge Model, J. Sci. Comput. 46 (2011) 329–358. doi:10.1007/s10915-010-9402-1</ref> Moreover, for model setups that are sufficiently resolved in space and time, differences in the solution between approaches should be small. Though, many users have reported somewhat lower stability in lumped explicit mode.

	The most recent version (55+) also has an option that improves the (default) semi-implicit consistent GWCE mass matrix mode to compute the complete (total depth) gravity wave term (free surface gradient) implicitly; toggled by setting ~~IMDig6~~ to 3. The default version (~~IMDig~~=1), only computes the initial still water depth component of the free surface gradient implicitly, which might make it more susceptible to CFL violations in shallow depths and can encounter Matrix diagonality issues overland where the initial still water depth is negative.		The most recent version (55+) also has an option that improves the (default) semi-implicit consistent GWCE mass matrix mode to compute the complete (total depth) gravity wave term (free surface gradient) implicitly; toggled by setting IMDigit-6 to 3. The default version (IMDigit-6=1), only computes the initial still water depth component of the free surface gradient implicitly, which might make it more susceptible to CFL violations in shallow depths and can encounter Matrix diagonality issues overland where the initial still water depth is negative.

	== References ==		== References ==
	<references />		<references />

Wpringle: /* Six-digit IM Codes */

2020-07-10T14:23:27Z

Six-digit IM Codes

← Older revision		Revision as of 10:23, 10 July 2020
Line 115:		Line 115:
	A common code combination is <code>IM=111112</code>, which is identical to the default <code>111111</code> (same as <code>IM=0</code>), but simulates in explicit mass-lumping mode. Note that <code>[[A00, B00, C00]]</code> must be set to <code>0.0 1.0 0.0</code> when in this mode. Lumped explicit mode is a useful alternative to the (default) semi-implicit consistent GWCE mass matrix mode, because the latter requires a matrix solve that increases computational time and memory. By comparison, the explicit mass-lumping mode is about twice as fast and scales to fewer grid nodes per computational core.<ref>S. Tanaka, S. Bunya, J.J. Westerink, C. Dawson, R.A. Luettich, Scalability of an Unstructured Grid Continuous Galerkin Based Hurricane Storm Surge Model, J. Sci. Comput. 46 (2011) 329–358. doi:10.1007/s10915-010-9402-1</ref> Moreover, for model setups that are sufficiently resolved in space and time, differences in the solution between approaches should be small. Though, many users have reported somewhat lower stability in lumped explicit mode.		A common code combination is <code>IM=111112</code>, which is identical to the default <code>111111</code> (same as <code>IM=0</code>), but simulates in explicit mass-lumping mode. Note that <code>[[A00, B00, C00]]</code> must be set to <code>0.0 1.0 0.0</code> when in this mode. Lumped explicit mode is a useful alternative to the (default) semi-implicit consistent GWCE mass matrix mode, because the latter requires a matrix solve that increases computational time and memory. By comparison, the explicit mass-lumping mode is about twice as fast and scales to fewer grid nodes per computational core.<ref>S. Tanaka, S. Bunya, J.J. Westerink, C. Dawson, R.A. Luettich, Scalability of an Unstructured Grid Continuous Galerkin Based Hurricane Storm Surge Model, J. Sci. Comput. 46 (2011) 329–358. doi:10.1007/s10915-010-9402-1</ref> Moreover, for model setups that are sufficiently resolved in space and time, differences in the solution between approaches should be small. Though, many users have reported somewhat lower stability in lumped explicit mode.

	The most recent version (55+) also has an option that improves the (default) semi-implicit consistent GWCE mass matrix mode to ~~include~~ compute the complete (total depth) gravity wave term (free surface gradient) implicitly; toggled by setting IMDig6 to 3. The default version (IMDig=1), only computes the initial still water depth component of the free surface gradient implicitly, which might make it more susceptible to CFL violations in shallow depths and can encounter Matrix diagonality issues overland where the initial still water depth is negative.		The most recent version (55+) also has an option that improves the (default) semi-implicit consistent GWCE mass matrix mode to compute the complete (total depth) gravity wave term (free surface gradient) implicitly; toggled by setting IMDig6 to 3. The default version (IMDig=1), only computes the initial still water depth component of the free surface gradient implicitly, which might make it more susceptible to CFL violations in shallow depths and can encounter Matrix diagonality issues overland where the initial still water depth is negative.

	== References ==		== References ==
	<references />		<references />

Wpringle: /* Six-digit IM Codes */

2020-07-10T14:22:59Z

Six-digit IM Codes

← Older revision		Revision as of 10:22, 10 July 2020
Line 114:		Line 114:

	A common code combination is <code>IM=111112</code>, which is identical to the default <code>111111</code> (same as <code>IM=0</code>), but simulates in explicit mass-lumping mode. Note that <code>[[A00, B00, C00]]</code> must be set to <code>0.0 1.0 0.0</code> when in this mode. Lumped explicit mode is a useful alternative to the (default) semi-implicit consistent GWCE mass matrix mode, because the latter requires a matrix solve that increases computational time and memory. By comparison, the explicit mass-lumping mode is about twice as fast and scales to fewer grid nodes per computational core.<ref>S. Tanaka, S. Bunya, J.J. Westerink, C. Dawson, R.A. Luettich, Scalability of an Unstructured Grid Continuous Galerkin Based Hurricane Storm Surge Model, J. Sci. Comput. 46 (2011) 329–358. doi:10.1007/s10915-010-9402-1</ref> Moreover, for model setups that are sufficiently resolved in space and time, differences in the solution between approaches should be small. Though, many users have reported somewhat lower stability in lumped explicit mode.		A common code combination is <code>IM=111112</code>, which is identical to the default <code>111111</code> (same as <code>IM=0</code>), but simulates in explicit mass-lumping mode. Note that <code>[[A00, B00, C00]]</code> must be set to <code>0.0 1.0 0.0</code> when in this mode. Lumped explicit mode is a useful alternative to the (default) semi-implicit consistent GWCE mass matrix mode, because the latter requires a matrix solve that increases computational time and memory. By comparison, the explicit mass-lumping mode is about twice as fast and scales to fewer grid nodes per computational core.<ref>S. Tanaka, S. Bunya, J.J. Westerink, C. Dawson, R.A. Luettich, Scalability of an Unstructured Grid Continuous Galerkin Based Hurricane Storm Surge Model, J. Sci. Comput. 46 (2011) 329–358. doi:10.1007/s10915-010-9402-1</ref> Moreover, for model setups that are sufficiently resolved in space and time, differences in the solution between approaches should be small. Though, many users have reported somewhat lower stability in lumped explicit mode.

			The most recent version (55+) also has an option that improves the (default) semi-implicit consistent GWCE mass matrix mode to include compute the complete (total depth) gravity wave term (free surface gradient) implicitly; toggled by setting IMDig6 to 3. The default version (IMDig=1), only computes the initial still water depth component of the free surface gradient implicitly, which might make it more susceptible to CFL violations in shallow depths and can encounter Matrix diagonality issues overland where the initial still water depth is negative.

	== References ==		== References ==
	<references />		<references />

Wpringle at 14:10, 10 July 2020

2020-07-10T14:10:11Z

← Older revision		Revision as of 10:10, 10 July 2020
Line 1:		Line 1:
	'''<code>IM</code>''' is an important parameter in the [[fort.15 file]] that defines numerical model formulation and dimension. Among other things, <code>IM</code> specifies whether ADCIRC is solved in two-dimensional depth-integrated (2DDI) or in three-dimensions (3D), solution of the governing equations is semi-implicit or explicit in time, and whether the model formulation is barotropic or baroclinic. Popular values for 2D barotropic ADCIRC include <code>IM=0</code> and <code>IM=111112</code>~~, though~~ the ~~latter also requires modifying~~ <code>[[A00, B00, C00]]</code>.		'''<code>IM</code>''' is an important parameter in the [[fort.15 file]] that defines numerical model formulation and dimension. Among other things, <code>IM</code> specifies whether ADCIRC is solved in two-dimensional depth-integrated (2DDI) or in three-dimensions (3D), solution of the governing equations is semi-implicit or explicit in time, and whether the model formulation is barotropic or baroclinic. Popular values for 2D barotropic ADCIRC include <code>IM=0</code> and <code>IM=111112</code>; users should be aware that the <code>[[A00, B00, C00]]</code> coefficients must be specified differently in these two cases.

	== Default IM Values ==		== Default IM Values ==