Description
Return distinct eligible oral-surface observation support.
Oral-health records may contain surface identifiers, annotation support, inventory or image calibration. Local count and balance rules do not verify observations, define an appropriate hygiene practice or establish a dental diagnosis.
Return distinct eligible oral-surface observation support.
When to use this tool
Use Oral Surface Unobserved Share when checking the stated oral-health record or measurement convention.
How to use the tool and how it works
- Enter surfaceIds, observed, eligible. 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 eligibleSurfaces, unobservedSurfaces, unobservedShare, defined. Inspect defined before interpreting the associated values.
Return distinct eligible oral-surface observation support. Require aligned IDs/flags; deduplicate eligible IDs and observed eligible IDs; unobservedShare is their count difference divided by eligible count, or zero with defined = false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| surfaceIds | Surface Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| observed | Observed | Required. Array of boolean; maximum items 256. |
| eligible | Eligible | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| eligibleSurfaces | Eligible Surfaces | Required. Safe integer. |
| unobservedSurfaces | Unobserved Surfaces | Required. Safe integer. |
| unobservedShare | Distinct eligible surfaces never marked observed in an eligible record, divided by eligible surfaces; zero when undefined. | Required. Finite number. |
| defined | Whether the stated denominator is nonzero; inspect this before using the associated ratio. | Required. Boolean. |
{
"input": {
"surfaceIds": [
"a",
"a",
"b"
],
"observed": [
true,
false,
false
],
"eligible": [
true,
true,
true
]
},
"output": {
"eligibleSurfaces": 2,
"unobservedSurfaces": 1,
"unobservedShare": 0.5,
"defined": true
}
}Limitations and assumptions
- One observed eligible duplicate supports that ID; conflicting records and clinical validity are not resolved.
- 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 relevant charting protocol and professional dental guidance for clinical interpretation, care and individual recommendations.
References
Similar or alternative tools
- Oral Surface Visible Count
Count visible and hidden assessable oral-surface records.
- Oral Photo Unobserved Area Share
Return observable photo area and unobserved eligible-area share.