Skip to content

Main content

Periodontal Measurement Rounding Envelope Tool

Calculate periodontal measurement rounding envelope from explicit caller-supplied inputs.

Loading tool…

Description

For positive increment return lower=reported-increment/2 and upperExclusive=reported+increment/2 when rounded; otherwise lower=reported and upperExclusive=reported+increment.

Dental research records distinguish teeth, surfaces, sites, observations, exclusions, and reporting bases. Measurement resolution and missing observations affect interpretation differently. A chart token, site share, or measurement envelope can check supplied data without establishing a clinical finding.

For positive increment return lower=reported-increment/2 and upperExclusive=reported+increment/2 when rounded; otherwise lower=reported and upperExclusive=reported+increment.

When to use this tool

Use Periodontal Measurement Rounding Envelope when you need this site-record, denominator, label, image-scale, or measurement component for supplied research data.

How to use the tool and how it works

  1. Enter reported, increment, rounded. 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 lower, upperExclusive, halfwidth. Use the output convention below.

For positive increment return lower=reported-increment/2 and upperExclusive=reported+increment/2 when rounded; otherwise lower=reported and upperExclusive=reported+increment. Always return halfwidth=increment/2.1

Input fieldMeaning and unitsAccepted input
reportedReportedRequired. Finite number.
incrementIncrementRequired. Finite number; strictly above 0.
roundedRoundedRequired. Boolean.
Output fieldInterpretationReturned shape
lowerLowerRequired. Finite number.
upperExclusiveExcluded upper boundary of the selected reporting bin.Required. Finite number.
halfwidthAlways increment/2, including on the unrounded branch.Required. Finite number.
json
{
  "input": {
    "reported": 3,
    "increment": 1,
    "rounded": true
  },
  "output": {
    "lower": 2.5,
    "upperExclusive": 3.5,
    "halfwidth": 0.5
  }
}

Limitations and assumptions

  • Use one length unit. The unrounded branch assumes a lower-edge truncation bin, while halfwidth still means half the increment; tie rules, probe error, and clinical interpretation are outside scope.
  • 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. Signed zero is exported as zero.

Alternative or Complementary methods

Use the intended examination or measurement protocol with verified site identities and source records. Broader interpretation requires actual observations and appropriate measurement properties beyond one token or ratio.

References

  1. Calculation and input contract: periodontology/periodontal-measurement-rounding-envelope — tool.io

Similar or alternative tools