Description
Return a shortest signed periodic angle gap.
Motion records combine sampled coordinates, periodic angles, event timing and signed work or impulse conventions. Local numerical differences and panels can be computed independently while actual event detection, full trajectories and physiological significance require complete measurements and analysis.
Return a shortest signed periodic angle gap.
When to use this tool
Use Joint Axis Angle Wrapping Gap when checking the stated movement timing, angle, geometry, energy or panel convention.
How to use the tool and how it works
- Enter angleDegrees, referenceDegrees, periodDegrees. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read signedWrappedGap, antipodal. Inspect antipodal before interpreting the associated values.
Return a shortest signed periodic angle gap. Require periodDegrees > 0; wrap angle-reference into (-period/2,period/2], choosing positive half-period at an exact antipodal tie.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| angleDegrees | Angle Degrees | Required. Finite number. |
| referenceDegrees | Reference Degrees | Required. Finite number. |
| periodDegrees | Period Degrees | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| signedWrappedGap | Signed Wrapped Gap | Required. Finite number. |
| antipodal | Exact half-period separation, resolved to the positive signed wrapped gap. | Required. Boolean. |
{
"input": {
"angleDegrees": 350,
"referenceDegrees": 10,
"periodDegrees": 360
},
"output": {
"signedWrappedGap": -20,
"antipodal": false
}
}Limitations and assumptions
- Antipodal tests exact equality without tolerance; anatomical motion, normal ranges and coordinate calibration are not 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
Inspect calibrated motion/force data and use an appropriate complete trajectory or dynamics analysis; interpret health and safe-loading implications with qualified professionals.
References
Similar or alternative tools
- Joint Angle Wrapping One Cycle
Wrap a joint angle into a supplied cycle.
- Joint Moment Anatomical Axis Token Tool
Retain an explicitly supplied anatomical-axis mapping rather than infer a joint sign convention.