Contents: Interface Overview Number of Species Transport Parameters Species Parameters Solution Type Options Compute Cursor Data Data Table Axis Scaling

This tutorial explains the controls and features of the Multiple Solutes, Equilibrium Sorption with Sequential Decay applet. The applet implements the analytical solution of van Genuchten (1985) for one-dimensional transport of up to four sequentially decaying solute species, with equilibrium linear sorption, advection, and dispersion in a semi-infinite porous medium with a finite-pulse source.

For the mathematical background see the Solution Tutorial.


1Interface Overview

The applet is organized into three panels. A species-selection dropdown sits above the panels in a model row:

LEFT PANEL — Parameters
Transport Parameters
Species Parameters (C₀, R, μ)
Solution Type
Options
Compute / Clear All
Scale bar (min / max)
C vs Time — top canvas
Scale bar (min / max)
C vs Distance — bottom canvas
RIGHT PANEL
Cursor Data table
Show Data Table
UI Tutorial
Solution Tutorial

Both plot panels can be displayed simultaneously. The top canvas always shows the C vs Time (breakthrough curve) result; the bottom canvas shows the C vs Distance (concentration profile) result. Move the cursor over either canvas to activate the crosshair slider.


2Number of Species

The dropdown at the top of the screen selects how many sequentially decaying species to include. The decay chain always starts from the parent compound C1:

SelectionDecay Chain
1 — Single SoluteC1 only (standard ADE with sorption and decay)
2 — Chain C1 → C2C1C2
3 — Chain C1 → C2 → C3C1C2C3
4 — Chain C1 → C2 → C3 → C4C1C2C3C4

Only the rows for the selected number of species are shown in the Species Parameters table. Species are color-coded consistently across all plots and tables.


3Transport Parameters

These parameters describe the physical domain and apply equally to all species:

ParameterSymbolUnitsDefaultDescription
VelocityvL/T1.0Average pore-water velocity (seepage velocity) in the longitudinal direction
DispersionDL²/T0.5Longitudinal hydrodynamic dispersion coefficient
Pulse LengthtpT200.0Duration of the source concentration pulse at x = 0. After tp, the inlet concentration of the parent (C1) drops to zero; daughters already in the domain continue to decay and transport.

4Species Parameters

Each active species has three parameters entered in the species table. Species are identified by their color:

C1 C2 C3 C4

ColumnSymbolUnitsDescription
Input ConcentrationC0M/L³Source concentration at x = 0 during the pulse. Set to 0 for daughter species that are produced only by decay of the parent; they are not present in the source zone.
Retardation FactorRAccounts for linear equilibrium sorption: R = 1 + ρKd/θ. Must be ≥ 1. R = 1 means no sorption.
Aqueous Decayμ1/TFirst-order decay rate in the aqueous phase. Decay only applies to the dissolved phase, not the sorbed phase. Set to 0 for a conservative (non-decaying) species.
Note: Each species can have a different retardation factor and decay rate, reflecting different sorption affinities and chemical stability along the decay chain.
Singularity warning: If two species share identical decay constants (μ), the van Genuchten (1985) analytical formula becomes singular. The applet detects this automatically, slightly perturbs the equal values by 1%, and displays a warning so you are aware the results are approximate near this parameter condition.

5Solution Type

Choose how to view the solution at each compute:

Optionx-axisDescription
Fixed PositionTime [T]Plot concentration vs time at a fixed spatial location x. This is a breakthrough curve (BTC). Enter the observation distance in the adjacent field.
Fixed TimeDistance [L]Plot concentration vs position at a fixed time snapshot t. This is a concentration profile. Enter the time in the adjacent field.

When Show Both Plots is enabled (see Options), each compute generates both solution types simultaneously. The Fixed Position result appears in the top canvas; the Fixed Time result in the bottom canvas. The two panels have independent scale bars.

Tip: Computing different solution types in sequence opens a second canvas automatically. Switching between the two types without clearing preserves both on screen.

6Options
OptionDescription
Show Both PlotsWhen checked, both C vs Time and C vs Distance are computed and displayed simultaneously in the two canvas panels. When unchecked, only the selected solution type is plotted.
Multiple RunsWhen checked, each click of Compute overlays a new set of curves on top of the existing ones. Each successive run is drawn with a different line-dash pattern (solid, dashed, dotted, dash-dot, …) so overlapping runs remain distinguishable even for the same species colors. Uncheck to replace all existing curves on the next compute.
Tip: Use Multiple Runs to compare the sensitivity of the decay chain to a single parameter — vary μ for C1 across runs to visualize how the parent decay rate controls daughter accumulation.

7Compute & Clear

Compute evaluates the van Genuchten (1985) analytical solution with the current parameter set and adds it to the active plot(s). Each species is drawn in its assigned color. In Multiple Runs mode, each successive run uses a distinct line-dash pattern, and an Active Runs list appears below the buttons showing all runs with delete controls.

Clear All removes all runs and curves and resets both canvases.

Error checking: If any retardation factor R < 1, an error message appears and the computation is blocked until the value is corrected. No two decay constants may be exactly equal — the applet perturbs duplicates by 1% and warns you.

8Cursor Data

Move the mouse cursor over either plot canvas to activate the crosshair slider. A vertical dashed line appears at the cursor position. The Cursor Data table in the right panel updates live, showing one row per species per run with:

  • A color swatch identifying the species and run dash-pattern
  • A curve label (e.g., Run 1 C1)
  • The x (distance) or t (time) coordinate at the cursor
  • The interpolated concentration at that position

All runs and species are shown simultaneously, making it easy to compare breakthrough times and peak concentrations.


9Show Data Table

Clicking Show Data Table (right panel) opens a modal window with the full numerical dataset for all computed curves. The modal is organized with:

  • Run tabs at the top — one per computed run
  • Within each run: columns for the x or t coordinate and the concentration of each species (C1, C2, …)
  • Download CSV — exports the currently selected run's data as a comma-separated file for use in spreadsheets or other analysis tools

10Axis Scaling

Each canvas panel has an independent scale bar placed directly above it. The min and max fields set the x-axis range (time or distance):

FieldDefaultDescription
min0.0Left edge of the x-axis. Usually left at 0.
max200Right edge of the x-axis. Increase to see long-term behavior; decrease to zoom in on the breakthrough front.
Tip: The y-axis (concentration) scales automatically to the maximum computed value across all active runs. The top and bottom panels have separate scale bars and can be set independently.

► Launch the Model → Solution Tutorial