Skip to content

Commit

Permalink
fix external links to Trixi.jl
Browse files Browse the repository at this point in the history
  • Loading branch information
patrickersing committed Mar 30, 2024
1 parent 2315f34 commit a6a32cd
Show file tree
Hide file tree
Showing 7 changed files with 23 additions and 24 deletions.
2 changes: 1 addition & 1 deletion src/callbacks_stage/positivity_shallow_water.jl
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ or the [`ShallowWaterEquationsWetDry2D`](@ref) struct to determine the minimal a
The order of the `variables` is important and might have a strong influence
on the robustness.
As opposed to the standard version of the [`PositivityPreservingLimiterZhangShu`](@ref),
As opposed to the standard version of the [`Trixi.PositivityPreservingLimiterZhangShu`](@extref),
nodes with a water height below the `threshold_limiter` are treated in a special way.
To avoid numerical problems caused by velocities close to zero,
the velocity is cut off, such that the node can be identified as "dry". The special feature of the
Expand Down
2 changes: 1 addition & 1 deletion src/equations/numerical_fluxes.jl
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ function min_max_speed_chen_noelle end
"""
flux_hll_chen_noelle = FluxHLL(min_max_speed_chen_noelle)
An instance of [`FluxHLL`](@ref) specific to the shallow water equations that
An instance of [`Trixi.FluxHLL`](@extref) specific to the shallow water equations that
uses the wave speed estimates from [`min_max_speed_chen_noelle`](@ref).
This HLL flux is guaranteed to have zero numerical mass flux out of a "dry" element,
maintain positivity of the water height, and satisfy an entropy inequality.
Expand Down
6 changes: 3 additions & 3 deletions src/equations/shallow_water_two_layer_1d.jl
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ This affects the implementation and use of these equations in various ways:
* The flux values corresponding to the bottom topography must be zero.
* The bottom topography values must be included when defining initial conditions, boundary
conditions or source terms.
* [`AnalysisCallback`](@ref) analyzes this variable.
* [`Trixi.AnalysisCallback`](@extref) analyzes this variable.
* Trixi's visualization tools will visualize the bottom topography by default.
A good introduction for the 2LSWE is available in Chapter 12 of the book:
Expand Down Expand Up @@ -102,7 +102,7 @@ end
A smooth initial condition used for convergence tests in combination with
[`source_terms_convergence_test`](@ref) (and
[`BoundaryConditionDirichlet(initial_condition_convergence_test)`](@ref) in non-periodic domains).
[`Trixi.BoundaryConditionDirichlet`](@extref) in non-periodic domains).
"""
function Trixi.initial_condition_convergence_test(x, t,
equations::ShallowWaterTwoLayerEquations1D)
Expand All @@ -123,7 +123,7 @@ end
Source terms used for convergence tests in combination with
[`initial_condition_convergence_test`](@ref)
(and [`BoundaryConditionDirichlet(initial_condition_convergence_test)`](@ref)
(and [`Trixi.BoundaryConditionDirichlet`](@extref)
in non-periodic domains).
"""
@inline function Trixi.source_terms_convergence_test(u, x, t,
Expand Down
2 changes: 1 addition & 1 deletion src/equations/shallow_water_two_layer_2d.jl
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ This affects the implementation and use of these equations in various ways:
* The flux values corresponding to the bottom topography must be zero.
* The bottom topography values must be included when defining initial conditions, boundary
conditions or source terms.
* [`AnalysisCallback`](@ref) analyzes this variable.
* [`Trixi.AnalysisCallback`](@extref) analyzes this variable.
* Trixi's visualization tools will visualize the bottom topography by default.
A good introduction for the 2LSWE is available in Chapter 12 of the book:
Expand Down
15 changes: 7 additions & 8 deletions src/equations/shallow_water_wet_dry_1d.jl
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ This affects the implementation and use of these equations in various ways:
* The flux values corresponding to the bottom topography must be zero.
* The bottom topography values must be included when defining initial conditions, boundary conditions or
source terms.
* [`AnalysisCallback`](@ref) analyzes this variable.
* [`Trixi.AnalysisCallback`](@extref) analyzes this variable.
* Trixi.jl's visualization tools will visualize the bottom topography by default.
References for the SWE are many but a good introduction is available in Chapter 13 of the book:
Expand Down Expand Up @@ -111,9 +111,8 @@ end
A smooth initial condition used for convergence tests in combination with
[`source_terms_convergence_test`](@ref)
(and [`BoundaryConditionDirichlet(initial_condition_convergence_test)`](@ref) in non-periodic domains).
(and [`Trixi.BoundaryConditionDirichlet`](@extref) in non-periodic domains).
"""

function Trixi.initial_condition_convergence_test(x, t,
equations::ShallowWaterEquationsWetDry1D)
return Trixi.initial_condition_convergence_test(x, t,
Expand All @@ -125,7 +124,7 @@ end
Source terms used for convergence tests in combination with
[`initial_condition_convergence_test`](@ref)
(and [`BoundaryConditionDirichlet(initial_condition_convergence_test)`](@ref) in non-periodic domains).
(and [`Trixi.BoundaryConditionDirichlet`](@extref) in non-periodic domains).
This manufactured solution source term is specifically designed for the bottom topography function
`b(x) = 2.0 + 0.5 * sin(sqrt(2.0)*pi*x[1])`
Expand Down Expand Up @@ -255,7 +254,7 @@ variables.
This hydrostatic reconstruction ensures that the finite volume numerical fluxes remain
well-balanced for discontinuous bottom topographies [`ShallowWaterEquationsWetDry1D`](@ref).
Should be used together with [`FluxHydrostaticReconstruction`](@ref) and
Should be used together with [`Trixi.FluxHydrostaticReconstruction`](@extref) and
[`hydrostatic_reconstruction_audusse_etal`](@ref) in the surface flux to ensure consistency.
Further details on the hydrostatic reconstruction and its motivation can be found in
Expand All @@ -280,7 +279,7 @@ Non-symmetric two-point surface flux that discretizes the nonconservative (sourc
The discretization uses the `hydrostatic_reconstruction_chen_noelle` on the conservative
variables.
Should be used together with [`FluxHydrostaticReconstruction`](@ref) and
Should be used together with [`Trixi.FluxHydrostaticReconstruction`](@extref) and
[`hydrostatic_reconstruction_chen_noelle`](@ref) in the surface flux to ensure consistency.
Further details on the hydrostatic reconstruction and its motivation can be found in
Expand Down Expand Up @@ -388,7 +387,7 @@ end
A particular type of hydrostatic reconstruction on the water height to guarantee well-balancedness
for a general bottom topography [`ShallowWaterEquationsWetDry1D`](@ref). The reconstructed solution states
`u_ll_star` and `u_rr_star` variables are then used to evaluate the surface numerical flux at the interface.
Use in combination with the generic numerical flux routine [`FluxHydrostaticReconstruction`](@ref).
Use in combination with the generic numerical flux routine [`Trixi.FluxHydrostaticReconstruction`](@extref).
Further details on this hydrostatic reconstruction and its motivation can be found in
- Emmanuel Audusse, François Bouchut, Marie-Odile Bristeau, Rupert Klein, and Benoit Perthame (2004)
Expand All @@ -409,7 +408,7 @@ A particular type of hydrostatic reconstruction of the water height to guarantee
for a general bottom topography of the [`ShallowWaterEquationsWetDry1D`](@ref). The reconstructed solution states
`u_ll_star` and `u_rr_star` variables are used to evaluate the surface numerical flux at the interface.
The key idea is a linear reconstruction of the bottom and water height at the interfaces using subcells.
Use in combination with the generic numerical flux routine [`FluxHydrostaticReconstruction`](@ref).
Use in combination with the generic numerical flux routine [`Trixi.FluxHydrostaticReconstruction`](@extref).
Further details on this hydrostatic reconstruction and its motivation can be found in
- Guoxian Chen and Sebastian Noelle (2017)
Expand Down
16 changes: 8 additions & 8 deletions src/equations/shallow_water_wet_dry_2d.jl
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ This affects the implementation and use of these equations in various ways:
* The flux values corresponding to the bottom topography must be zero.
* The bottom topography values must be included when defining initial conditions, boundary conditions or
source terms.
* [`AnalysisCallback`](@ref) analyzes this variable.
* [`Trixi.AnalysisCallback`](@extref) analyzes this variable.
* Trixi.jl's visualization tools will visualize the bottom topography by default.
References for the SWE are many but a good introduction is available in Chapter 13 of the book:
Expand Down Expand Up @@ -112,7 +112,7 @@ Trixi.varnames(::typeof(cons2prim), ::ShallowWaterEquationsWetDry2D) = ("H", "v1
A smooth initial condition used for convergence tests in combination with
[`source_terms_convergence_test`](@ref)
(and [`BoundaryConditionDirichlet(initial_condition_convergence_test)`](@ref) in non-periodic domains).
(and [`Trixi.BoundaryConditionDirichlet`](@extref) in non-periodic domains).
"""
function Trixi.initial_condition_convergence_test(x, t,
equations::ShallowWaterEquationsWetDry2D)
Expand All @@ -125,7 +125,7 @@ end
Source terms used for convergence tests in combination with
[`initial_condition_convergence_test`](@ref)
(and [`BoundaryConditionDirichlet(initial_condition_convergence_test)`](@ref) in non-periodic domains).
(and [`Trixi.BoundaryConditionDirichlet`](@extref) in non-periodic domains).
This manufactured solution source term is specifically designed for the bottom topography function
`b(x,y) = 2 + 0.5 * sin(sqrt(2)*pi*x) + 0.5 * sin(sqrt(2)*pi*y)`
Expand Down Expand Up @@ -188,7 +188,7 @@ end
boundary_condition_slip_wall(u_inner, orientation, direction, x, t,
surface_flux_function, equations::ShallowWaterEquationsWetDry2D)
Should be used together with [`TreeMesh`](@ref).
Should be used together with [`Trixi.TreeMesh`](@extref).
"""
@inline function Trixi.boundary_condition_slip_wall(u_inner, orientation,
direction, x, t,
Expand Down Expand Up @@ -321,7 +321,7 @@ end
A particular type of hydrostatic reconstruction on the water height to guarantee well-balancedness
for a general bottom topography [`ShallowWaterEquationsWetDry2D`](@ref). The reconstructed solution states
`u_ll_star` and `u_rr_star` variables are used to evaluate the surface numerical flux at the interface.
Use in combination with the generic numerical flux routine [`FluxHydrostaticReconstruction`](@ref).
Use in combination with the generic numerical flux routine [`Trixi.FluxHydrostaticReconstruction`](@extref).
Further details for the hydrostatic reconstruction and its motivation can be found in
- Emmanuel Audusse, François Bouchut, Marie-Odile Bristeau, Rupert Klein, and Benoit Perthame (2004)
Expand All @@ -342,7 +342,7 @@ A particular type of hydrostatic reconstruction of the water height to guarantee
for a general bottom topography of the [`ShallowWaterEquationsWetDry2D`](@ref). The reconstructed solution states
`u_ll_star` and `u_rr_star` variables are then used to evaluate the surface numerical flux at the interface.
The key idea is a linear reconstruction of the bottom and water height at the interfaces using subcells.
Use in combination with the generic numerical flux routine [`FluxHydrostaticReconstruction`](@ref).
Use in combination with the generic numerical flux routine [`Trixi.FluxHydrostaticReconstruction`](@extref).
Further details on this hydrostatic reconstruction and its motivation can be found in
- Guoxian Chen and Sebastian Noelle (2017)
Expand Down Expand Up @@ -410,7 +410,7 @@ variables.
This hydrostatic reconstruction ensures that the finite volume numerical fluxes remain
well-balanced for discontinuous bottom topographies [`ShallowWaterEquationsWetDry2D`](@ref).
Should be used together with [`FluxHydrostaticReconstruction`](@ref) and
Should be used together with [`Trixi.FluxHydrostaticReconstruction`](@extref) and
[`hydrostatic_reconstruction_audusse_etal`](@ref) in the surface flux to ensure consistency.
Further details for the hydrostatic reconstruction and its motivation can be found in
Expand Down Expand Up @@ -448,7 +448,7 @@ Non-symmetric two-point surface flux that discretizes the nonconservative (sourc
The discretization uses the [`hydrostatic_reconstruction_chen_noelle`](@ref) on the conservative
variables.
Should be used together with [`FluxHydrostaticReconstruction`](@ref) and
Should be used together with [`Trixi.FluxHydrostaticReconstruction`](@extref) and
[`hydrostatic_reconstruction_chen_noelle`](@ref) in the surface flux to ensure consistency.
Further details on the hydrostatic reconstruction and its motivation can be found in
Expand Down
4 changes: 2 additions & 2 deletions src/solvers/indicators.jl
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,14 @@
alpha_smooth=true,
variable)
Modified version of the [`IndicatorHennemannGassner`](@ref)
Modified version of the [`Trixi.IndicatorHennemannGassner`](@extref)
indicator used for shock-capturing for shallow water equations. After
the element-wise values for the blending factors are computed an additional check
is made to see if the element is partially wet. In this case, partially wet elements
are set to use the pure finite volume scheme that is guaranteed to be well-balanced
for this wet/dry transition state of the flow regime.
See also [`VolumeIntegralShockCapturingHG`](@ref).
See also [`Trixi.VolumeIntegralShockCapturingHG`](@extref).
## References
Expand Down

0 comments on commit a6a32cd

Please sign in to comment.