Files
pplus-library/modules/md/minimum-image/routine.json
T
alexmandClaude df12b2a008 Start pplus-library: 16 verified routines in six modules
Routines written once in pseudo and checked at every level, so programs
can use them by name instead of rewriting and re-verifying them:

- stats: Mean, Variance (two-pass)
- numerics: KahanSum, LinearInterp, Trapezoid
- align: LinearGapPenalty, AffineGapPenalty, MatchScore,
  NeedlemanWunschScore
- md: LennardJones, LennardJonesForce, MinimumImage, PairDistance
- seq: GCContent, HammingDistance
- special: ErfApprox (Abramowitz and Stegun 7.1.26)

Each has contracts, cases, reference implementations in Python, Mojo
and (for the numerical ones) C at more than one level, and nine have a
Dafny proof over exact numbers. status.json and STATUS.md are written by
pplus-core's library-check: every check passes or is open/unverified as
listed there. The Mojo references still need the pinned compiler's
answers (library-verify-mojo, network).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FgvbRdoEheAHqsRmr2WuKZ
2026-10-05 11:58:22 +00:00

56 lines
1.3 KiB
JSON

{
"name": "MinimumImage",
"summary": "A displacement brought to its nearest periodic image in a box of length Box: the minimum image convention.",
"tags": [
"molecular dynamics",
"periodic boundary conditions"
],
"sources": [
{
"title": "Allen and Tildesley, Computer Simulation of Liquids, section 1.5.2"
}
],
"cases": [
{
"call": "MinimumImage(0.75, 1.0)"
},
{
"call": "MinimumImage(-0.75, 1.0)"
},
{
"call": "MinimumImage(2.3, 1.0)"
},
{
"call": "MinimumImage(0.5, 1.0)"
},
{
"call": "MinimumImage(-12.0, 10.0)"
}
],
"references": [
{
"lang": "python",
"level": "plain",
"file": "ref/python/plain.py",
"note": "The same formula with math.floor."
},
{
"lang": "c",
"level": "plain",
"file": "ref/c/plain.c",
"note": "The same formula with floor from math.h."
},
{
"lang": "mojo",
"level": "plain",
"file": "ref/mojo/plain.mojo",
"note": "The same formula in Mojo, with floor from std.math."
}
],
"proof": {
"lang": "dafny",
"file": "proof/minimum_image.dfy",
"note": "Over real numbers the result lies in [-Box / 2, Box / 2) and differs from Dx by a whole number of box lengths."
}
}