Shovel Swing Angle Calculator

Audit actual successive shovel heading shortest signed swings with explicit180° tie=−180 convention, not productive cycle estimate or permissible slewing command. Caller independently verifies units, applicability and matching conditions; no operational recipe, safety certification, causal efficacy or legal/resource classification is inferred.

Description

Headings wrap around a full circle, so consecutive shovel swings need an angular convention.

Headings wrap around a full circle, so consecutive shovel swings need an angular convention.^[1]

This tool uses the shortest signed turn with an exact half-turn recorded as −180 degrees.

When to use Shovel Swing Angle Calculator

Use this tool to calculate or review the supplied observations under the stated rules. Match completed survey or ledger observations by block, segment or stage and confirm their units and boundaries.

How to use Shovel Swing Angle Calculator and understand its results

Match completed survey or ledger observations by block, segment or stage and confirm their units and boundaries.
Enter observedShovelHeadingDegrees, callerMaximumAbsoluteSwingDegrees, using the field meanings and rules below, then run the tool.
Read signedShortestObservedSwingsDegrees, swingReviewIndices. Inspect nested result fields where present, and review unknown records separately from known matches.
Correct any reported input issue and run again. Before using a successful result, check the stated units, signs, reference scope and observation coverage.

Input field	Meaning	Value type	Requirement
observedShovelHeadingDegrees	Observed shovel heading degrees	list of number	Required
callerMaximumAbsoluteSwingDegrees	Caller maximum absolute swing degrees	number	Required

Require at least two headings in [0,360) and a nonnegative absolute-swing threshold≤180. For each successive pair compute ((next−previous+540)%360)−180. Flag swing indices whose absolute value is strictly above the threshold; index zero is the first pair.

swing_i=((heading_(i+1)−heading_i+540)%360)−180

Use the matching field units and the exact boundary, ordering and reference rules above.

Output field	Meaning	Value type
signedShortestObservedSwingsDegrees	Signed shortest observed swings degrees; preserve the subtraction order and sign defined in the mechanics	list of number
swingReviewIndices	Swing review indices; zero-based positions in the relevant supplied record or adjacent-pair list	list of number

json

{
  "input": {
    "observedShovelHeadingDegrees": [
      350,
      10,
      190
    ],
    "callerMaximumAbsoluteSwingDegrees": 90
  },
  "output": {
    "signedShortestObservedSwingsDegrees": [
      20,
      -180
    ],
    "swingReviewIndices": [
      1
    ]
  }
}

Limitations and assumptions

Units, ledger boundaries, survey interpretation and model applicability must be independently established. These summaries do not assign reserve/resource classifications or establish support adequacy, ventilation safety or an operating setting.

Missing required fields, unknown fields, wrong types and violated rules return input issues. Numeric values and outputs must be finite. Lists and matrices must be dense, without missing cells. Numeric lists allow at most 10000 entries; ordinary string lists allow at most 128 strings of 128 UTF-16 units each; numeric matrices allow at most 128 rows and 128 columns, subject to narrower requirements above.

Alternative or Complementary methods

For a related step, use Shovel Bucket Fill Factor Calculator: Bucket fill compares observed payload volume with a matched heaped bucket volume. For a complementary comparison, use Loader Productivity Calculator: Observed loader productivity relates weighed deliveries to matched productive time.

References

Shovel Swing Angle Calculator — tool.io

Similar or alternative tools

Shovel Bucket Fill Factor Calculator
Bucket fill compares observed payload volume with a matched heaped bucket volume.
Loader Productivity Calculator
Observed loader productivity relates weighed deliveries to matched productive time.