Description
Sum vector components for closure, use their hypotenuse for closureDistance, sum individual step lengths, and divide closure by traverse length or return zero with defined false.
Survey vectors and angles require a reference direction and sign convention. North/east/down components, magnetic corrections, and heading labels are coordinate choices, not independently measured or current reference-field values.
Sum vector components for closure, use their hypotenuse for closureDistance, sum individual step lengths, and divide closure by traverse length or return zero with defined false.
When to use this tool
Use Survey Loop Closing Share when you need a local survey-vector or heading conversion from explicit supplied values.
How to use the tool and how it works
- Enter northSteps, eastSteps. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read northClosure, eastClosure, closureDistance, traversedDistance, relativeClosure, defined. Inspect defined before interpreting the associated values.
Require aligned northSteps and eastSteps. Sum vector components for closure, use their hypotenuse for closureDistance, sum individual step lengths, and divide closure by traverse length or return zero with defined false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| northSteps | North Steps | Required. Array of finite number; maximum items 256. |
| eastSteps | East Steps | Required. Array of finite number; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| northClosure | North Closure | Required. Finite number. |
| eastClosure | East Closure | Required. Finite number. |
| closureDistance | Closure Distance | Required. Finite number. |
| traversedDistance | Traversed Distance | Required. Finite number. |
| relativeClosure | Relative Closure | Required. Finite number. |
| defined | Whether the stated denominator or normalization exists; inspect before interpreting a zero placeholder. | Required. Boolean. |
{
"input": {
"northSteps": [
3,
-3
],
"eastSteps": [
4,
-4
]
},
"output": {
"northClosure": 0,
"eastClosure": 0,
"closureDistance": 0,
"traversedDistance": 10,
"relativeClosure": 0,
"defined": true
}
}Limitations and assumptions
- Coordinates use a common planar length unit; relative closure is not an accuracy estimate, survey adjustment, geographic datum validation, or proof of correct station order.
- 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 observations and the appropriate survey reference model. Verify axis order, vertical sign, angular units, and correction epoch before integrating results into a survey.
References
Similar or alternative tools
- Magnetic Survey Base Station Drift Term
Return baseAtMeasurement-baseReference as baseDrift and subtract that drift from fieldMeasurement.
- Borehole Log Reversed Depth Axis Flag
Compare lastDepth with firstDepth for increasing and equality for degenerate.