Description
Quaternion order is scalar-first [w,x,y,z], Hamilton product and right-handed active rotations; compare unit rotations under q and -q sign equivalence using explicit component-space tolerance.
A quaternion has one scalar and three vector components. This family uses [w, x, y, z] unless a layout converter says otherwise. Unit quaternions can represent rotations, and q and −q describe the same rotation under this convention; component arithmetic and physical rotation interpretation are separate operations.
Quaternion order is scalar-first [w,x,y,z], Hamilton product and right-handed active rotations; compare unit rotations under q and -q sign equivalence using explicit component-space tolerance.
When to use this tool
Use this tool to compare unit rotations under q and -q sign equivalence using explicit component-space tolerance.
How to use the tool and how it works
- Enter left, right, tolerance using the field definitions below.
- Run the operation. Correct input errors before interpreting an output.
- Read result.equivalent. Use the ordering, boundary rules and absence conditions described below.
Require unit endpoints. Compare the smaller Euclidean distance between left − right and left + right with the supplied nonnegative tolerance.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| left | Left quaternion in [w, x, y, z] order. | Dense list of at most 128 finite numbers; integer/shape constraints above also apply. |
| right | Right quaternion in [w, x, y, z] order. | Dense list of at most 128 finite numbers; integer/shape constraints above also apply. |
| tolerance | Nonnegative norm or component-distance tolerance as specified in the calculation. | A finite number satisfying the operation’s stated comparisons. |
| Output field | Interpretation |
|---|---|
| result | Object containing the named fields below. |
| result.equivalent | Whether left and right are within the supplied component-distance tolerance after allowing a sign flip. |
{
"input": {
"left": [
1,
0,
0,
0
],
"right": [
-1,
0,
0,
0
],
"tolerance": 0
},
"output": {
"result": {
"equivalent": true
}
}
}Limitations and assumptions
- Tolerance measures component-space distance, not an angular threshold in radians.
- When an operation requires unit input, the fixed acceptance condition is |norm − 1| ≤ 1e−10. The norm audit instead uses its supplied tolerance. Angles use radians; vector units are preserved by a unit rotation. Floating-point roundoff is possible.
- Every declared top-level input field is required and unexpected fields are rejected. Ordinary strings are limited to 8,192 UTF-16 code units and lists to 128 entries, with tighter operation-specific bounds where stated. JSON text has bounded nesting and node counts.
- Numeric outputs must be finite and no larger in absolute magnitude than the safe-integer limit; operations returning exact large integers use decimal text. Positions are zero-based and spans end exclusively unless the operation explicitly states a different convention.
Alternative or Complementary methods
Confirm component layout, multiplication order and coordinate-frame convention before using another library’s records. Normalize only when appropriate, and distinguish component-space tolerances from angular tolerances.
References
Similar or alternative tools
- Quaternion Rotation Canonical Sign
Quaternion order is scalar-first [w,x,y,z], Hamilton product and right-handed active rotations; canonicalize unit quaternion sign by the first nonzero component being positive, including half-turn scalar-zero cases.
- Unit Quaternion Vector Rotation
Quaternion order is scalar-first [w,x,y,z], Hamilton product and right-handed active rotations; rotate a finite three-vector by a validated unit quaternion without applying translation.