Description
Multiply suppliedDatumOffset by that scale, reverse sign when subtractOffset, and add the signed correction to observedGravity.
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.
Multiply suppliedDatumOffset by that scale, reverse sign when subtractOffset, and add the signed correction to observedGravity.
When to use this tool
Use Gravity Datum Offset Contribution when you need a local potential-field term with supplied coefficients or geometry.
How to use the tool and how it works
- Enter observedGravity, suppliedDatumOffset, suppliedScale, subtractOffset. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read correction, corrected. Use the output convention below.
Require positive suppliedScale. Multiply suppliedDatumOffset by that scale, reverse sign when subtractOffset, and add the signed correction to observedGravity.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| observedGravity | Observed Gravity | Required. Finite number. |
| suppliedDatumOffset | Supplied Datum Offset | Required. Finite number. |
| suppliedScale | Supplied Scale | Required. Finite number; strictly above 0. |
| subtractOffset | Subtract Offset | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| correction | Correction | Required. Finite number. |
| corrected | Corrected | Required. Finite number. |
{
"input": {
"observedGravity": 100,
"suppliedDatumOffset": 2,
"suppliedScale": 3,
"subtractOffset": true
},
"output": {
"correction": -6,
"corrected": 94
}
}Limitations and assumptions
- The scale maps offset units to gravity units; reference identity and sign policy are supplied without a physical datum transformation or complete gravity correction.
- 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
- Gravity Drift Anchor Weight
Linearly interpolate firstDrift and lastDrift and subtract the interpolated value from observed.
- Gravity Freeair Height Correction Factor
Multiply heightMeters by gradientMgalPerMeter and add that correction to observedMgal.