recordValidityResult
Extends from TransiEnt.Basics.Icons.Record (Icon for records).
Information
1. Purpose of model
Record returned by the validity analysis function ValidityAnalysis. It contains one status per criterion and the key figures on which the status is based.
2. Level of detail, physical effects considered, and physical insight
(Purely technical component without physical modeling.)
3. Limits of validity
- Status values: 0 = criterion fulfilled, 1 = warning, 2 = criterion violated.
- The key figures are pre-simulation estimates; see ValidityAnalysis for their definitions and limits.
4. Interfaces
(no elements)
5. Nomenclature
statusDarcy, statusLTE, statusNRGF, statusBuoyancy |
status of the criteria on Darcy's law, local thermal equilibrium, natural regional groundwater flow and buoyancy switch (0 fulfilled, 1 warning, 2 violated) [-] | |
statusOverall |
maximum of all status values [-] | |
R_th |
thermal radius of the stored volume [m] | |
d_grain |
grain diameter used for the criteria on Darcy's law and local thermal equilibrium [m] | |
dGrainEstimated |
true if the grain diameter was estimated from permeability and porosity [-] | |
Re_well |
grain Reynolds number at the well screen [-] | |
E_well |
non-Darcy share of the pressure gradient at the well screen [-] | |
r_E |
radius up to which the non-Darcy share exceeds E_Darcy_max [m] | |
r_LTE |
radius up to which the seepage velocity exceeds v_s_LTE [m] | |
fV_LTE |
fraction of the thermal plume volume in which the seepage velocity exceeds v_s_LTE [-] | |
r_LTNE |
radius up to which the Darcy velocity exceeds q_LTNE [m] | |
M_mobility |
mobility ratio of the injected to the ambient water [-] | |
N_0 |
displacement number without high-temperature correction [-] | |
N_lo |
lower bound of the displacement number with high-temperature correction [-] | |
N_hi |
upper bound of the displacement number with high-temperature correction [-] | |
Ra |
Rayleigh-Darcy number of the aquifer [-] | |
q_0 |
characteristic buoyancy flow velocity [m/s] |
6. Governing Equations
(no equations)
7. Remarks for Usage
Returned by ValidityAnalysis; the definitions of all key figures are given in the documentation of ValidityAnalysis. Bind the result to a parameter record, e.g. parameter Records.ValidityResult validity = Function.ValidityAnalysis(...), to access the values in a model.
8. Validation
(no validation or testing necessary)
9. References
(no remarks)
10. Version History
Model created by Markus Gillner (markus.gillner@tuhh.de) on 01.10.2026
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | statusDarcy | Validity of Darcy's law (creeping flow) | |
| Integer | statusLTE | Local thermal equilibrium between fluid and solid | |
| Integer | statusNRGF | Negligible natural regional groundwater flow | |
| Integer | statusBuoyancy | Consistency of the buoyancy switch | |
| Integer | statusOverall | Maximum of all status values | |
| SI.Length | R_th | Thermal radius of the stored volume | |
| SI.Length | d_grain | Grain diameter used for the criteria on Darcy's law and local thermal equilibrium | |
| Boolean | dGrainEstimated | True if the grain diameter was estimated from permeability and porosity | |
| Real | Re_well | Grain Reynolds number at the well screen | |
| Real | E_well | Non-Darcy share of the pressure gradient at the well screen | |
| SI.Length | r_E | Radius up to which the non-Darcy share exceeds E_Darcy_max | |
| SI.Length | r_LTE | Radius up to which the seepage velocity exceeds v_s_LTE | |
| Real | fV_LTE | Fraction of the thermal plume volume in which the seepage velocity exceeds v_s_LTE | |
| SI.Length | r_LTNE | Radius up to which the Darcy velocity exceeds q_LTNE | |
| Real | M_mobility | Mobility ratio of the injected to the ambient water (viscosity ratio) | |
| Real | N_0 | Displacement number without high-temperature correction | |
| Real | N_lo | Lower bound of the displacement number with high-temperature correction | |
| Real | N_hi | Upper bound of the displacement number with high-temperature correction | |
| Real | Ra | Rayleigh-Darcy number of the aquifer | |
| SI.Velocity | q_0 | Characteristic buoyancy flow velocity |