Description
Return shortest periodic point separation and exact antipodal status.
A periodic coordinate identifies values separated by a whole cycle. Minimum-image gaps require a wrapping interval and an explicit half-cycle tie convention; signed direction and unsigned separation answer different questions.
Return shortest periodic point separation and exact antipodal status.
When to use this tool
Use Periodic Point Antipode Tie when checking one explicit periodic-coordinate or gap convention.
How to use the tool and how it works
- Enter first, second, period. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read distance, antipodal. Inspect antipodal before interpreting the associated values.
Return shortest periodic point separation and exact antipodal status. Require period > 0; wrap second-first and take min(remainder,period-remainder). Reduce coordinates separately if direct subtraction overflows.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| first | First | Required. Finite number. |
| second | Second | Required. Finite number. |
| period | Period | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| distance | Distance | Required. Finite number. |
| antipodal | Antipodal | Required. Boolean. |
{
"input": {
"first": 0,
"second": 5,
"period": 10
},
"output": {
"distance": 5,
"antipodal": true
}
}Limitations and assumptions
- Half-cycle detection uses exact equality without tolerance; the period's unit must match coordinates.
- 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 a complete periodic geometry model when multiple axes, seam-crossing intervals or path winding matter.
References
Similar or alternative tools
- Periodic Interval Shorter Gap
Return the shortest gap between two closed intervals on a periodic axis.
- Periodic Distance Half Cell Ambiguity Label
Return minimum periodic separation and a half-cycle ambiguity flag.