Site Grid Observation Gap Tool

Description

Deduplicate teeth and requiredSites, form their full Cartesian grid, and count each tooth/site pair once when any matching observed row is true.

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.

Deduplicate teeth and requiredSites, form their full Cartesian grid, and count each tooth/site pair once when any matching observed row is true.

When to use this tool

Use Site Grid Observation Gap 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

Enter toothIds, siteLabels, observed, requiredSites. 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 expectedSites, observedRequiredSites, missingSites. Use the output convention below.

Require aligned toothIds, siteLabels, and observed flags. Deduplicate teeth and requiredSites, form their full Cartesian grid, and count each tooth/site pair once when any matching observed row is true. Return expectedSites, observedRequiredSites, and missingSites.^[1]

Input field	Meaning and units	Accepted input
toothIds	Tooth Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
siteLabels	Site Labels	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
observed	Observed	Required. Array of boolean; maximum items 256.
requiredSites	Required Sites	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.

Output field	Interpretation	Returned shape
expectedSites	Distinct teeth present in toothIds times distinct requiredSites.	Required. Safe integer.
observedRequiredSites	Observed Required Sites	Required. Safe integer.
missingSites	Missing Sites	Required. Safe integer.

json

{
  "input": {
    "toothIds": [
      "t1",
      "t1",
      "t2"
    ],
    "siteLabels": [
      "a",
      "b",
      "a"
    ],
    "observed": [
      true,
      false,
      true
    ],
    "requiredSites": [
      "a",
      "b"
    ]
  },
  "output": {
    "expectedSites": 4,
    "observedRequiredSites": 2,
    "missingSites": 2
  }
}

Limitations and assumptions

Only teeth appearing in toothIds define the tooth universe, so entirely absent teeth cannot be detected. Duplicate observations cannot increase coverage, and no clinical chart completeness or measurement validity is established.
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.

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

Calculation and input contract: periodontology/site-grid-observation-gap — tool.io

Similar or alternative tools

Tooth Landmark Support Share
Deduplicate teeth and requiredLandmarks and count their Cartesian pairs once when any matching observed row is true.
Periodontal Site Visible Share
Audit supplied research visibility flags without periodontal disease assessment.