Description
Apply a supplied scalar relaxation update.
Numerical physics calculations depend on discretization, index conventions, boundary conditions and model units. A local force kick is only part of an integration method, a stencil residual is not a solved field, and a one-sided power weight is not a spectral-density normalization. Floating-point resolution also limits grid and coordinate representations.
Apply a supplied scalar relaxation update.
When to use this tool
Use Relaxation Update Grid Cell when you already have oldValue, candidateValue, relaxationFactor and need to apply a supplied scalar relaxation update.
How to use the tool and how it works
- Enter oldValue, candidateValue, relaxationFactor. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read updatedValue. Use the output convention below.
Require relaxationFactor>=0; return oldValue+factor*(candidateValue-oldValue).1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| oldValue | Old Value | Required. Finite number. |
| candidateValue | Candidate Value | Required. Finite number. |
| relaxationFactor | Nonnegative numeric factor; values above one permit over-relaxation. | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| updatedValue | Updated Value | Required. Finite number. |
{
"input": {
"oldValue": 2,
"candidateValue": 6,
"relaxationFactor": 0.5
},
"output": {
"updatedValue": 4
}
}Limitations and assumptions
- Factors above one permit over-relaxation. No solver, admissible range, convergence, stability or suitable factor is determined.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use the complete discretized model, integration algorithm and boundary treatment. Assess convergence, conservation and stability with the full calculation; individual residuals, CFL components, relaxation terms and index mappings do not establish numerical accuracy or physical validity.
References
Similar or alternative tools
- Poisson Solver Cell Residual
Calculate a supplied one-dimensional Poisson cell residual.
- Grid Refinement Richardson Single Term
Calculate a supplied Richardson fine-grid error term and extrapolated value.