Description
Add suppliedDeclinationDegrees to headingDegrees after reducing both modulo 360 and normalize correctedDegrees into [0, 360).
Potential-field calculations describe local gravity or magnetic adjustments and spectral operations. Sign, vertical direction, and wavenumber convention affect the result; a single factor does not produce a complete corrected survey.
Add suppliedDeclinationDegrees to headingDegrees after reducing both modulo 360 and normalize correctedDegrees into [0, 360).
When to use this tool
Use Magnetic Heading Reference Offset when you need a local potential-field term with supplied coefficients or geometry.
How to use the tool and how it works
- Enter headingDegrees, suppliedDeclinationDegrees. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read correctedDegrees. Use the output convention below.
Add suppliedDeclinationDegrees to headingDegrees after reducing both modulo 360 and normalize correctedDegrees into [0, 360).1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| headingDegrees | Heading Degrees | Required. Finite number. |
| suppliedDeclinationDegrees | Supplied Declination Degrees | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| correctedDegrees | Corrected Degrees | Required. Finite number. |
{
"input": {
"headingDegrees": 350,
"suppliedDeclinationDegrees": 20
},
"output": {
"correctedDegrees": 10
}
}Limitations and assumptions
- A positive supplied declination is added by this convention; no location/date model, magnetic observation, instrument deviation, or safe navigation assessment is provided.
- 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
Process the complete survey using the intended reference model and correction chain. Check spectral conventions, boundary handling, and input units rather than combining isolated terms without their model context.
References
Similar or alternative tools
- Geographic Azimuth Meridian Reference Pair
Add convergence to gridAzimuth and wrap the sum modulo 360 for trueAzimuth; separately normalize gridAzimuth modulo 360.
- Magnetic Inclination Vector Component
Resolve it using cosine/sine into north, east, and positive-down components under supplied declinationRadians.