Skip to content

Main content

Boundary Layer Height Datum Offset

Subtract an explicit ground datum height from a reported boundary-layer height on compatible vertical units.

Loading tool…

Description

Subtract a supplied ground-height datum from a layer height.

Atmospheric values depend on pressure order, vertical datums, moisture definitions and reference conditions. Specific humidity uses moist-air mass as its denominator, whereas mixing ratio uses dry-air mass. A pressure-order flag differs from a temperature inversion, and a logarithmic-pressure weight can represent extrapolation.

Subtract a supplied ground-height datum from a layer height.

When to use this tool

Use Boundary Layer Height Datum Offset when you already have suppliedGroundDatumHeight, reportedLayerHeight and need to subtract a supplied ground-height datum from a layer height.

How to use the tool and how it works

  1. Enter suppliedGroundDatumHeight, reportedLayerHeight. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read signedGap. Use the output convention below.

Return reportedLayerHeight-suppliedGroundDatumHeight, retaining signs.1

Input fieldMeaning and unitsAccepted input
suppliedGroundDatumHeightSupplied Ground Datum HeightRequired. Finite number.
reportedLayerHeightReported Layer HeightRequired. Finite number.
Output fieldInterpretationReturned shape
signedGapSigned GapRequired. Finite number.
json
{
  "input": {
    "suppliedGroundDatumHeight": 12,
    "reportedLayerHeight": 17
  },
  "output": {
    "signedGap": 5
  }
}

Limitations and assumptions

  • Both heights need the same unit/datum. No layer is detected, terrain retrieved, vertical reference transformed or atmospheric boundary-layer model fitted.
  • 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 profile and station data with the complete atmospheric model. Preserve datum, humidity and pressure conventions and assess uncertainty before interpreting local terms as an observed layer, state or forecast.

References

  1. Calculation and input contract: atmospheric-science/boundary-layer-height-datum-offset — tool.io

Similar or alternative tools