Skip to content

Main content

Verlet Position Residual Tool

Compare one supplied constant-step position-Verlet update with a recorded next position.

Loading tool…

Description

Compare a recorded position with a Verlet step.

A simulation update combines supplied states, fluxes, forces and time conventions. Local integration and interface terms can be evaluated independently, while a full solver must also supply consistent fields, boundary conditions, conservation and convergence behavior.

Compare a recorded position with a Verlet step.

When to use this tool

Use Verlet Position Residual when checking one explicitly supplied integration, flux or lattice-population contribution.

How to use the tool and how it works

  1. Enter previousPosition, currentPosition, acceleration, timeStep, recordedNext. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read predictedNext, residual. Use the output convention below.

Compare a recorded position with a Verlet step. Require timeStep >= 0; predictedNext = 2*currentPosition-previousPosition+acceleration*timeStep², residual = recordedNext-predicted.1

Input fieldMeaning and unitsAccepted input
previousPositionPrevious PositionRequired. Finite number.
currentPositionCurrent PositionRequired. Finite number.
accelerationAccelerationRequired. Finite number.
timeStepStep duration in the same time unit used by rates and accelerations.Required. Finite number; minimum 0.
recordedNextRecorded NextRequired. Finite number.
Output fieldInterpretationReturned shape
predictedNextPredicted NextRequired. Finite number.
residualSigned difference in the direction stated above, with matching units.Required. Finite number.
json
{
  "input": {
    "previousPosition": 0,
    "currentPosition": 2,
    "acceleration": 1,
    "timeStep": 1,
    "recordedNext": 6
  },
  "output": {
    "predictedNext": 5,
    "residual": 1
  }
}

Limitations and assumptions

  • Use consistent length/time units; forces, constraints and the validity of the previous integration state are not established.
  • 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 and validate the complete numerical method with its state initialization, boundary conditions and physical model for a reliable simulation.

References

  1. Calculation and input contract: computational-physics/verlet-position-residual — tool.io

Similar or alternative tools