Skip to content

Main content

Joint Angle Unwrapping Increment

Calculate the shortest signed wrapped angle increment in degrees with the exact half-turn tie assigned to -180.

Loading tool…

Description

Calculate one shortest signed wrapped-angle increment.

Movement geometry depends on coordinate registration, time origins, force signs and reference axes. A moment arm must already represent perpendicular leverage, a stride percentage has an endpoint convention, and a toe-to-heel projection differs from full Euclidean separation. Scalar results do not establish a movement diagnosis or a safe activity.

Calculate one shortest signed wrapped-angle increment.

When to use this tool

Use Joint Angle Unwrapping Increment when you already have previousWrappedDegrees, currentWrappedDegrees and need to calculate one shortest signed wrapped-angle increment.

How to use the tool and how it works

  1. Enter previousWrappedDegrees, currentWrappedDegrees. 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 shortestIncrementDegrees. Use the output convention below.

Reduce each angle modulo 360 and wrap current-previous into [-180,180), so a half-turn tie gives -180.1

Input fieldMeaning and unitsAccepted input
previousWrappedDegreesPrevious Wrapped DegreesRequired. Finite number.
currentWrappedDegreesCurrent Wrapped DegreesRequired. Finite number.
Output fieldInterpretationReturned shape
shortestIncrementDegreesCurrent-previous representative in [-180,180); a half-turn maps to -180 and changes above 180 degrees can alias.Required. Finite number.
json
{
  "input": {
    "previousWrappedDegrees": 170,
    "currentWrappedDegrees": -170
  },
  "output": {
    "shortestIncrementDegrees": 20
  }
}

Limitations and assumptions

  • This is one increment, not a full unwrapped trajectory. It cannot recover rotations larger than a half turn between samples or infer actual joint motion or clinical meaning.
  • 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 calibrated motion, force and timing records with a complete biomechanical model. Check coordinate frames, axis normalization and sampling limitations before interpreting local distances, moments or phase values as performance or clinical findings.

References

  1. Calculation and input contract: biomechanics/joint-angle-unwrapping-increment — tool.io

Similar or alternative tools