6: Subcell limiting with the IDP Limiter
In the previous tutorial, the element-wise limiting with IndicatorHennemannGassner
and VolumeIntegralShockCapturingHG
was explained. This tutorial contains a short introduction to the idea and implementation of subcell shock capturing approaches in Trixi.jl, which is also based on the DGSEM scheme in flux differencing formulation. Trixi.jl contains the a-posteriori invariant domain-preserving (IDP) limiter which was introduced by Pazner (2020) and Rueda-Ramírez, Pazner, Gassner (2022). It is a flux-corrected transport-type (FCT) limiter and is implemented using SubcellLimiterIDP
and VolumeIntegralSubcellLimiting
. Since it is an a-posteriori limiter you have to apply a correction stage after each Runge-Kutta stage. This is done by passing the stage callback SubcellLimiterIDPCorrection
to the time integration method.
Time integration method
As mentioned before, the IDP limiting is an a-posteriori limiter. Its limiting process guarantees the target bounds for an explicit (forward) Euler time step. To still achieve a high-order approximation, the implementation uses strong-stability preserving (SSP) Runge-Kutta methods, which can be written as convex combinations of forward Euler steps. As such, they preserve the convexity of convex functions and functionals, such as the TVD semi-norm and the maximum principle in 1D, for instance.
Since IDP/FCT limiting procedure operates on independent forward Euler steps, its a-posteriori correction stage is implemented as a stage callback that is triggered after each forward Euler step in an SSP Runge-Kutta method. Unfortunately, the solve(...)
routines in OrdinaryDiffEq.jl, typically employed for time integration in Trixi.jl, do not support this type of stage callback.
Therefore, subcell limiting with the IDP limiter requires the use of a Trixi-intern time integration SSPRK method called with
Trixi.solve(ode, method(stage_callbacks = stage_callbacks); ...)
Right now, only the canonical three-stage, third-order SSPRK method (Shu-Osher) Trixi.SimpleSSPRK33
is implemented.
IDP Limiting
The implementation of the invariant domain preserving (IDP) limiting approach (SubcellLimiterIDP
) is based on Pazner (2020) and Rueda-Ramírez, Pazner, Gassner (2022). It supports several types of limiting which are enabled by passing parameters individually.
Global bounds
If enabled, the global bounds enforce physical admissibility conditions, such as non-negativity of variables. This can be done for conservative variables, where the limiter is of a one-sided Zalesak-type (Zalesak, 1979), and general non-linear variables, where a Newton-bisection algorithm is used to enforce the bounds.
The Newton-bisection algorithm is an iterative method and requires some parameters. It uses a fixed maximum number of iteration steps (max_iterations_newton = 10
) and relative/absolute tolerances (newton_tolerances = (1.0e-12, 1.0e-14)
). The given values are sufficient in most cases and therefore used as default. If the implemented bounds checking functionality indicates problems with the limiting (see below) the Newton method with the chosen parameters might not manage to converge. If so, adapting the mentioned parameters helps fix that. Additionally, there is the parameter gamma_constant_newton
, which can be used to scale the antidiffusive flux for the computation of the blending coefficients of nonlinear variables. The default value is 2 * ndims(equations)
, as it was shown by Pazner (2020) [Section 4.2.2.] that this value guarantees the fulfillment of bounds for a forward-Euler increment.
Very small non-negative values can be an issue as well. That's why we use an additional correction factor in the calculation of the global bounds,
\[u^{new} \geq \beta * u^{FV}.\]
By default, $\beta$ (named positivity_correction_factor
) is set to 0.1
which works properly in most of the tested setups.
Conservative variables
The procedure to enforce global bounds for a conservative variables is as follows: If you want to guarantee non-negativity for the density of the compressible Euler equations, you pass the specific quantity name of the conservative variable.
using Trixi
equations = CompressibleEulerEquations2D(1.4)
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CompressibleEulerEquations2D │
│ ════════════════════════════ │
│ #variables: ………………………………………………… 4 │
│ │ variable 1: …………………………………………… rho │
│ │ variable 2: …………………………………………… rho_v1 │
│ │ variable 3: …………………………………………… rho_v2 │
│ │ variable 4: …………………………………………… rho_e │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
The quantity name of the density is rho
which is how we enable its limiting.
positivity_variables_cons = ["rho"]
1-element Vector{String}:
"rho"
The quantity names are passed as a vector to allow several quantities. This is used, for instance, if you want to limit the density of two different components using the multicomponent compressible Euler equations.
equations = CompressibleEulerMulticomponentEquations2D(gammas = (1.4, 1.648),
gas_constants = (0.287, 1.578))
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CompressibleEulerMulticomponentEquations2D │
│ ══════════════════════════════════════════ │
│ #variables: ………………………………………………… 5 │
│ │ variable 1: …………………………………………… rho_v1 │
│ │ variable 2: …………………………………………… rho_v2 │
│ │ variable 3: …………………………………………… rho_e │
│ │ variable 4: …………………………………………… rho1 │
│ │ variable 5: …………………………………………… rho2 │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
Then, we just pass both quantity names.
positivity_variables_cons = ["rho1", "rho2"]
2-element Vector{String}:
"rho1"
"rho2"
Alternatively, it is possible to all limit all density variables with a general command using
positivity_variables_cons = ["rho" * string(i) for i in eachcomponent(equations)]
2-element Vector{String}:
"rho1"
"rho2"
Non-linear variables
To allow limitation for all possible non-linear variables, including variables defined on-the-fly, you can directly pass the function that computes the quantity for which you want to enforce positivity. For instance, if you want to enforce non-negativity for the pressure, do as follows.
positivity_variables_nonlinear = [pressure]
1-element Vector{typeof(pressure)}:
pressure (generic function with 15 methods)
Local bounds
Second, Trixi.jl supports the limiting with local bounds for conservative variables using a two-sided Zalesak-type limiter (Zalesak, 1979) and for general non-linear variables using a one-sided Newton-bisection algorithm. They allow to avoid spurious oscillations within the global bounds and to improve the shock-capturing capabilities of the method. The corresponding numerical admissibility conditions are frequently formulated as local maximum or minimum principles. The local bounds are computed using the maximum and minimum values of all local neighboring nodes. Within this calculation we use the low-order FV solution values for each node.
As for the limiting with global bounds you are passing the quantity names of the conservative variables you want to limit. So, to limit the density with lower and upper local bounds pass the following.
local_twosided_variables_cons = ["rho"]
1-element Vector{String}:
"rho"
To limit non-linear variables locally, pass the variable function combined with the requested bound (min
or max
) as a tuple. For instance, to impose a lower local bound on the modified specific entropy Trixi.entropy_guermond_etal
, use
local_onesided_variables_nonlinear = [(Trixi.entropy_guermond_etal, min)]
1-element Vector{Tuple{typeof(Trixi.entropy_guermond_etal), typeof(min)}}:
(Trixi.entropy_guermond_etal, min)
Exemplary simulation
How to set up a simulation using the IDP limiting becomes clearer when looking at an exemplary setup. This will be a simplified version of tree_2d_dgsem/elixir_euler_blast_wave_sc_subcell.jl
. Since the setup is mostly very similar to a pure DGSEM setup as in tree_2d_dgsem/elixir_euler_blast_wave.jl
, the equivalent parts are used without any explanation here.
using OrdinaryDiffEq
using Trixi
equations = CompressibleEulerEquations2D(1.4)
function initial_condition_blast_wave(x, t, equations::CompressibleEulerEquations2D)
# Modified From Hennemann & Gassner JCP paper 2020 (Sec. 6.3) -> "medium blast wave"
# Set up polar coordinates
inicenter = SVector(0.0, 0.0)
x_norm = x[1] - inicenter[1]
y_norm = x[2] - inicenter[2]
r = sqrt(x_norm^2 + y_norm^2)
phi = atan(y_norm, x_norm)
sin_phi, cos_phi = sincos(phi)
# Calculate primitive variables
rho = r > 0.5 ? 1.0 : 1.1691
v1 = r > 0.5 ? 0.0 : 0.1882 * cos_phi
v2 = r > 0.5 ? 0.0 : 0.1882 * sin_phi
p = r > 0.5 ? 1.0E-3 : 1.245
return prim2cons(SVector(rho, v1, v2, p), equations)
end
initial_condition = initial_condition_blast_wave;
Since the surface integral is equal for both the DG and the subcell FV method, the limiting is applied only in the volume integral.
Note, that the DG method is based on the flux differencing formulation. Hence, you have to use a two-point flux, such as flux_ranocha
, flux_shima_etal
, flux_chandrashekar
or flux_kennedy_gruber
, for the DG volume flux.
surface_flux = flux_lax_friedrichs
volume_flux = flux_ranocha
flux_ranocha (generic function with 9 methods)
The limiter is implemented within SubcellLimiterIDP
. It always requires the parameters equations
and basis
. With additional parameters (described above or listed in the docstring) you can specify and enable additional limiting options. Here, the simulation should contain local limiting for the density using lower and upper bounds.
basis = LobattoLegendreBasis(3)
limiter_idp = SubcellLimiterIDP(equations, basis;
local_twosided_variables_cons = ["rho"])
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SubcellLimiterIDP │
│ ═════════════════ │
│ Limiter: ………………………………………………………… │
│ : …………………………………………………………………………… Local two-sided limiting for conservative variables [1] │
│ Local bounds: …………………………………………… FV solution │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
The initialized limiter is passed to VolumeIntegralSubcellLimiting
in addition to the volume fluxes of the low-order and high-order scheme.
volume_integral = VolumeIntegralSubcellLimiting(limiter_idp;
volume_flux_dg = volume_flux,
volume_flux_fv = surface_flux)
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ VolumeIntegralSubcellLimiting │
│ ═════════════════════════════ │
│ volume flux DG: ……………………………………… flux_ranocha │
│ volume flux FV: ……………………………………… FluxLaxFriedrichs(max_abs_speed_naive) │
│ limiter: ………………………………………………………… SubcellLimiterIDP │
│ │ Limiter: …………………………………………………… │
│ │ : ……………………………………………………………………… Local two-sided limiting for conservative variables [1] │
│ │ Local bounds: ……………………………………… FV solution │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
Then, the volume integral is passed to solver
as it is done for the standard flux-differencing DG scheme or the element-wise limiting.
solver = DGSEM(basis, surface_flux, volume_integral)
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ DG{Float64} │
│ ═══════════ │
│ basis: ……………………………………………………………… LobattoLegendreBasis{Float64}(polydeg=3) │
│ mortar: …………………………………………………………… LobattoLegendreMortarL2{Float64}(polydeg=3) │
│ surface integral: ………………………………… SurfaceIntegralWeakForm │
│ │ surface flux: ……………………………………… FluxLaxFriedrichs(max_abs_speed_naive) │
│ volume integral: …………………………………… VolumeIntegralSubcellLimiting │
│ │ volume flux DG: ………………………………… flux_ranocha │
│ │ volume flux FV: ………………………………… FluxLaxFriedrichs(max_abs_speed_naive) │
│ │ limiter: …………………………………………………… SubcellLimiterIDP │
│ │ │ Limiter: ……………………………………………… │
│ │ │ : ………………………………………………………………… Local two-sided limiting for conservative variables [1] │
│ │ │ Local bounds: ………………………………… FV solution │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
coordinates_min = (-2.0, -2.0)
coordinates_max = (2.0, 2.0)
mesh = TreeMesh(coordinates_min, coordinates_max,
initial_refinement_level = 5,
n_cells_max = 10_000)
semi = SemidiscretizationHyperbolic(mesh, equations, initial_condition, solver)
tspan = (0.0, 2.0)
ode = semidiscretize(semi, tspan)
summary_callback = SummaryCallback()
analysis_interval = 1000
analysis_callback = AnalysisCallback(semi, interval = analysis_interval)
alive_callback = AliveCallback(analysis_interval = analysis_interval)
save_solution = SaveSolutionCallback(interval = 1000,
save_initial_solution = true,
save_final_solution = true,
solution_variables = cons2prim)
stepsize_callback = StepsizeCallback(cfl = 0.3)
callbacks = CallbackSet(summary_callback,
analysis_callback, alive_callback,
save_solution,
stepsize_callback);
As explained above, the IDP limiter works a-posteriori and requires the additional use of a correction stage implemented with the stage callback SubcellLimiterIDPCorrection
. This callback is passed within a tuple to the time integration method.
stage_callbacks = (SubcellLimiterIDPCorrection(),)
(SubcellLimiterIDPCorrection(),)
Moreover, as mentioned before as well, simulations with subcell limiting require a Trixi-intern SSPRK time integration methods with passed stage callbacks and a Trixi-intern Trixi.solve(...)
routine.
sol = Trixi.solve(ode, Trixi.SimpleSSPRK33(stage_callbacks = stage_callbacks);
dt = 1.0, # solve needs some value here but it will be overwritten by the stepsize_callback
callback = callbacks);
summary_callback() # print the timer summary
████████╗██████╗ ██╗██╗ ██╗██╗
╚══██╔══╝██╔══██╗██║╚██╗██╔╝██║
██║ ██████╔╝██║ ╚███╔╝ ██║
██║ ██╔══██╗██║ ██╔██╗ ██║
██║ ██║ ██║██║██╔╝ ██╗██║
╚═╝ ╚═╝ ╚═╝╚═╝╚═╝ ╚═╝╚═╝
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SemidiscretizationHyperbolic │
│ ════════════════════════════ │
│ #spatial dimensions: ………………………… 2 │
│ mesh: ………………………………………………………………… TreeMesh{2, Trixi.SerialTree{2}} with length 1365 │
│ equations: …………………………………………………… CompressibleEulerEquations2D │
│ initial condition: ……………………………… initial_condition_blast_wave │
│ boundary conditions: ………………………… Trixi.BoundaryConditionPeriodic │
│ source terms: …………………………………………… nothing │
│ solver: …………………………………………………………… DG │
│ total #DOFs per field: …………………… 16384 │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ TreeMesh{2, Trixi.SerialTree{2}} │
│ ════════════════════════════════ │
│ center: …………………………………………………………… [0.0, 0.0] │
│ length: …………………………………………………………… 4.0 │
│ periodicity: ……………………………………………… (true, true) │
│ current #cells: ……………………………………… 1365 │
│ #leaf-cells: ……………………………………………… 1024 │
│ maximum #cells: ……………………………………… 10000 │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CompressibleEulerEquations2D │
│ ════════════════════════════ │
│ #variables: ………………………………………………… 4 │
│ │ variable 1: …………………………………………… rho │
│ │ variable 2: …………………………………………… rho_v1 │
│ │ variable 3: …………………………………………… rho_v2 │
│ │ variable 4: …………………………………………… rho_e │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ DG{Float64} │
│ ═══════════ │
│ basis: ……………………………………………………………… LobattoLegendreBasis{Float64}(polydeg=3) │
│ mortar: …………………………………………………………… LobattoLegendreMortarL2{Float64}(polydeg=3) │
│ surface integral: ………………………………… SurfaceIntegralWeakForm │
│ │ surface flux: ……………………………………… FluxLaxFriedrichs(max_abs_speed_naive) │
│ volume integral: …………………………………… VolumeIntegralSubcellLimiting │
│ │ volume flux DG: ………………………………… flux_ranocha │
│ │ volume flux FV: ………………………………… FluxLaxFriedrichs(max_abs_speed_naive) │
│ │ limiter: …………………………………………………… SubcellLimiterIDP │
│ │ │ Limiter: ……………………………………………… │
│ │ │ : ………………………………………………………………… Local two-sided limiting for conservative variables [1] │
│ │ │ Local bounds: ………………………………… FV solution │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ AnalysisCallback │
│ ════════════════ │
│ interval: ……………………………………………………… 1000 │
│ analyzer: ……………………………………………………… LobattoLegendreAnalyzer{Float64}(polydeg=6) │
│ │ error 1: …………………………………………………… l2_error │
│ │ error 2: …………………………………………………… linf_error │
│ │ integral 1: …………………………………………… entropy_timederivative │
│ save analysis to file: …………………… no │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ AliveCallback │
│ ═════════════ │
│ interval: ……………………………………………………… 100 │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SaveSolutionCallback │
│ ════════════════════ │
│ interval: ……………………………………………………… 1000 │
│ solution variables: …………………………… cons2prim │
│ save initial solution: …………………… yes │
│ save final solution: ………………………… yes │
│ output directory: ………………………………… /home/runner/work/Trixi.jl/Trixi.jl/docs/build/tutorials/out │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ StepsizeCallback │
│ ════════════════ │
│ CFL number: ………………………………………………… 0.3 │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Time integration │
│ ════════════════ │
│ Start time: ………………………………………………… 0.0 │
│ Final time: ………………………………………………… 2.0 │
│ time integrator: …………………………………… SimpleSSPRK33 │
│ adaptive: ……………………………………………………… false │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Environment information │
│ ═══════════════════════ │
│ #threads: ……………………………………………………… 1 │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
────────────────────────────────────────────────────────────────────────────────────────────────────
Simulation running 'CompressibleEulerEquations2D' with DGSEM(polydeg=3)
────────────────────────────────────────────────────────────────────────────────────────────────────
#timesteps: 0 run time: 1.41300000e-06 s
Δt: 1.00000000e+00 └── GC time: 0.00000000e+00 s (0.000%)
sim. time: 0.00000000e+00 (0.000%) time/DOF/rhs!: NaN s
PID: Inf s
#DOFs per field: 16384 alloc'd memory: 1493.166 MiB
#elements: 1024
Variable: rho rho_v1 rho_v2 rho_e
L2 error: 6.25621384e-03 5.88786362e-03 5.81457821e-03 1.15827059e-01
Linf error: 1.06470791e-01 2.46283676e-01 1.37585923e-01 1.97119199e+00
∑∂S/∂U ⋅ Uₜ : -6.22526192e+02
────────────────────────────────────────────────────────────────────────────────────────────────────
#timesteps: 100 │ Δt: 2.9061e-03 │ sim. time: 2.9394e-01 (14.697%) │ run time: 1.5884e+00 s
#timesteps: 200 │ Δt: 3.2316e-03 │ sim. time: 6.0126e-01 (30.063%) │ run time: 2.6938e+00 s
#timesteps: 300 │ Δt: 3.8243e-03 │ sim. time: 9.5591e-01 (47.795%) │ run time: 3.8238e+00 s
#timesteps: 400 │ Δt: 4.3979e-03 │ sim. time: 1.3674e+00 (68.371%) │ run time: 4.9814e+00 s
#timesteps: 500 │ Δt: 5.0302e-03 │ sim. time: 1.8395e+00 (91.977%) │ run time: 6.1514e+00 s
────────────────────────────────────────────────────────────────────────────────────────────────────
Simulation running 'CompressibleEulerEquations2D' with DGSEM(polydeg=3)
────────────────────────────────────────────────────────────────────────────────────────────────────
#timesteps: 532 run time: 6.58175790e+00 s
Δt: 2.58201930e-03 └── GC time: 4.54795660e-02 s (0.691%)
sim. time: 2.00000000e+00 (100.000%) time/DOF/rhs!: 1.89259558e-07 s
PID: 2.49695047e-07 s
#DOFs per field: 16384 alloc'd memory: 1012.831 MiB
#elements: 1024
Variable: rho rho_v1 rho_v2 rho_e
L2 error: 1.01030662e+00 3.05177209e-01 3.05188326e-01 6.85712113e-01
Linf error: 3.29436672e+00 1.45717455e+00 1.45659687e+00 2.92881060e+00
∑∂S/∂U ⋅ Uₜ : -2.91165098e+01
────────────────────────────────────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────────────────────────────────────
Trixi.jl simulation finished. Final time: 2.0 Time steps: 532 (accepted), 532 (total)
────────────────────────────────────────────────────────────────────────────────────────────────────
────────────────────────────────────────────────────────────────────────────────
Trixi.jl Time Allocations
─────────────────────── ────────────────────────
Tot / % measured: 6.59s / 100.0% 21.1MiB / 99.5%
Section ncalls time %tot avg alloc %tot avg
────────────────────────────────────────────────────────────────────────────────
main loop 1 6.05s 91.8% 6.05s 8.67MiB 41.2% 8.67MiB
rhs! 1.60k 4.95s 75.1% 3.10ms 9.33KiB 0.0% 5.98B
volume integral 1.60k 4.41s 66.8% 2.76ms 0.00B 0.0% 0.00B
interface flux 1.60k 285ms 4.3% 178μs 0.00B 0.0% 0.00B
prolong2interf... 1.60k 119ms 1.8% 74.3μs 0.00B 0.0% 0.00B
surface integral 1.60k 102ms 1.6% 64.0μs 0.00B 0.0% 0.00B
reset ∂u/∂t 1.60k 17.6ms 0.3% 11.0μs 0.00B 0.0% 0.00B
Jacobian 1.60k 17.0ms 0.3% 10.6μs 0.00B 0.0% 0.00B
~rhs!~ 1.60k 2.62ms 0.0% 1.64μs 9.33KiB 0.0% 5.98B
prolong2mortars 1.60k 121μs 0.0% 75.5ns 0.00B 0.0% 0.00B
prolong2bounda... 1.60k 114μs 0.0% 71.6ns 0.00B 0.0% 0.00B
mortar flux 1.60k 81.3μs 0.0% 51.0ns 0.00B 0.0% 0.00B
source terms 1.60k 58.9μs 0.0% 36.9ns 0.00B 0.0% 0.00B
boundary flux 1.60k 51.6μs 0.0% 32.4ns 0.00B 0.0% 0.00B
a posteriori lim... 1.60k 954ms 14.5% 598μs 214KiB 1.0% 137B
blending factors 1.60k 649ms 9.8% 407μs 213KiB 1.0% 137B
local twosided 1.60k 580ms 8.8% 364μs 212KiB 1.0% 136B
~blending fa... 1.60k 63.9ms 1.0% 40.1μs 1.47KiB 0.0% 0.94B
reset alpha 1.60k 4.64ms 0.1% 2.91μs 0.00B 0.0% 0.00B
~a posteriori ... 1.60k 305ms 4.6% 191μs 752B 0.0% 0.47B
~main loop~ 1 86.2ms 1.3% 86.2ms 2.31MiB 11.0% 2.31MiB
calculate dt 532 51.0ms 0.8% 95.9μs 0.00B 0.0% 0.00B
analyze solution 1 6.62ms 0.1% 6.62ms 4.64MiB 22.0% 4.64MiB
I/O 1 1.90ms 0.0% 1.90ms 1.52MiB 7.2% 1.52MiB
save solution 1 1.90ms 0.0% 1.90ms 1.51MiB 7.2% 1.51MiB
~I/O~ 1 4.38μs 0.0% 4.38μs 3.94KiB 0.0% 3.94KiB
get node varia... 1 872ns 0.0% 872ns 0.00B 0.0% 0.00B
get element va... 1 160ns 0.0% 160ns 0.00B 0.0% 0.00B
save mesh 1 90.0ns 0.0% 90.0ns 0.00B 0.0% 0.00B
I/O 2 490ms 7.4% 245ms 7.60MiB 36.1% 3.80MiB
~I/O~ 2 487ms 7.4% 244ms 6.09MiB 29.0% 3.04MiB
save solution 1 2.16ms 0.0% 2.16ms 1.51MiB 7.2% 1.51MiB
get node variables 1 912ns 0.0% 912ns 0.00B 0.0% 0.00B
get element vari... 1 792ns 0.0% 792ns 0.00B 0.0% 0.00B
save mesh 1 251ns 0.0% 251ns 0.00B 0.0% 0.00B
analyze solution 1 52.5ms 0.8% 52.5ms 4.76MiB 22.6% 4.76MiB
calculate dt 1 96.0μs 0.0% 96.0μs 0.00B 0.0% 0.00B
────────────────────────────────────────────────────────────────────────────────
Visualization
As for a standard simulation in Trixi.jl, it is possible to visualize the solution using the plot
routine from Plots.jl.
using Plots
plot(sol)
To get an additional look at the amount of limiting that is used, you can use the visualization approach using the SaveSolutionCallback
, Trixi2Vtk
and ParaView. More details about this procedure can be found in the visualization documentation. Unfortunately, the support for subcell limiting data is not yet merged into the main branch of Trixi2Vtk but lies in the branch bennibolm/node-variables
.
With that implementation and the standard procedure used for Trixi2Vtk you get the following dropdown menu in ParaView.
The resulting visualization of the density and the limiting parameter then looks like this.
You can see that the limiting coefficient does not lie in the interval [0,1] because Trixi2Vtk interpolates all quantities to regular nodes by default. You can disable this functionality with reinterpolate=false
within the call of trixi2vtk(...)
and get the following visualization.
Bounds checking
Subcell limiting is based on the fulfillment of target bounds - either global or local. Although the implementation works and has been thoroughly tested, there are some cases where these bounds are not met. For instance, the deviations could be in machine precision, which is not problematic. Larger deviations can be cause by too large time-step sizes (which can be easily fixed by reducing the CFL number), specific boundary conditions or source terms. Insufficient parameters for the Newton-bisection algorithm can also be a reason when limiting non-linear variables. There are described above.
In many cases, it is reasonable to monitor the bounds deviations. Because of that, Trixi.jl supports a bounds checking routine implemented using the stage callback BoundsCheckCallback
. It checks all target bounds for fulfillment in every RK stage. If added to the tuple of stage callbacks like
stage_callbacks = (SubcellLimiterIDPCorrection(), BoundsCheckCallback())
and passed to the time integration method, a summary is added to the final console output. For the given example, this summary shows that all bounds are met at all times.
────────────────────────────────────────────────────────────────────────────────────────────────────
Maximum deviation from bounds:
────────────────────────────────────────────────────────────────────────────────────────────────────
rho:
- lower bound: 0.0
- upper bound: 0.0
────────────────────────────────────────────────────────────────────────────────────────────────────
Moreover, it is also possible to monitor the bounds deviations incurred during the simulations. To do that use the parameter save_errors = true
, such that the instant deviations are written to deviations.txt
in output_directory
every interval
time steps.
BoundsCheckCallback(save_errors = true, output_directory = "out", interval = 100)
Then, for the given example the deviations file contains all daviations for the current timestep and simulation time.
iter, simu_time, rho_min, rho_max
100, 0.29103427131404924, 0.0, 0.0
200, 0.5980281923063808, 0.0, 0.0
300, 0.9520853560765293, 0.0, 0.0
400, 1.3630295622683186, 0.0, 0.0
500, 1.8344999624013498, 0.0, 0.0
532, 1.9974179806990118, 0.0, 0.0
This page was generated using Literate.jl.