Facing NSEW Rotation Orientation Counter
Track actual signed quarter-turn dance orientation under caller N/E/S/W stage convention and retain whole-turn winding; no compass/geodesy transform or wrapped-angle motion inference.
Description
Quarter-turn logs retain both final facing and whole-turn winding.
Quarter-turn logs retain both final facing and whole-turn winding. N/E/S/W is a caller stage convention.1
Enter initial integer facing 0–3 and a nonempty integer turn list bounded±10000. Return cumulative signed turns, facing sequence and final facing.
When to use Facing NSEW Rotation Orientation Counter
Use Facing NSEW Rotation Orientation Counter when you need to evaluate the supplied records under the calculation and evidence rules below. No compass/geodesy transform or wrapped-angle motion reconstruction is supplied.
Prepare the annotated dance, timing, rehearsal or inventory records requested. Supply caller rules, evidence flags and local reference values; distinguish beats, bars, counts and seconds.
How to use Facing NSEW Rotation Orientation Counter and understand its results
- Prepare the annotated dance, timing, rehearsal or inventory records requested. Supply caller rules, evidence flags and local reference values; distinguish beats, bars, counts and seconds.
- Enter initialFacingNeswCode, callerSignedQuarterTurns using the field table and calculation rules, then run the tool.
- Read facingNeswCodesAfterTurns, signedCumulativeQuarterTurns, observedFinalFacingNeswCode. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| initialFacingNeswCode | Initial facing nesw code | number | Required |
| callerSignedQuarterTurns | Caller signed quarter turns | list of number | Required |
Enter initial integer facing 0–3 and a nonempty integer turn list bounded±10000. Return cumulative signed turns, facing sequence and final facing.
cumulative=sum(turns); facing=(initial+cumulative) mod4 Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| facingNeswCodesAfterTurns | Facing nesw codes after turns | list of number |
| signedCumulativeQuarterTurns | Signed cumulative quarter turns | list of number |
| observedFinalFacingNeswCode | Observed final facing nesw code | number |
{
"input": {
"initialFacingNeswCode": 0,
"callerSignedQuarterTurns": [
1,
1,
-1,
4
]
},
"output": {
"facingNeswCodesAfterTurns": [
1,
2,
1,
1
],
"signedCumulativeQuarterTurns": [
1,
2,
1,
5
],
"observedFinalFacingNeswCode": 1
}
}Limitations and assumptions
No compass/geodesy transform or wrapped-angle motion reconstruction is supplied.
Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 10,000 entries; string lists to 128 strings of at most 128 characters each. The rules above may impose smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use Viennese Waltz Rotations Per Bar Estimate: Unwrapped body orientations retain whole turns between observations. Signed rotations per bar depend on the actual bar interval. For a complementary task, use Pirouette Spotting Rotation Rpm Estimate: Spotting intervals can be checked against unwrapped torso rotation. Head rotation and torso rotation are different observations.
References
-
Facing NSEW Rotation Orientation Counter — tool.io
Similar or alternative tools
- Viennese Waltz Rotations Per Bar Estimate
Unwrapped body orientations retain whole turns between observations. Signed rotations per bar depend on the actual bar interval.
- Pirouette Spotting Rotation Rpm Estimate
Spotting intervals can be checked against unwrapped torso rotation. Head rotation and torso rotation are different observations.