Description
Address a supplied tooth/surface chart using explicit indexing conventions.
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.
Address a supplied tooth/surface chart using explicit indexing conventions.
When to use this tool
Use Periodontal Chart Tooth Surface Index Term 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 toothIndex, surfaceIndex, surfacesPerTooth, origin. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read flatIndex, oneBasedIndex. Use the output convention below.
For nonnegative integer toothIndex and valid surfaceIndex below positive surfacesPerTooth, accept origin zero or one. Return flatIndex=toothIndex*surfacesPerTooth+surfaceIndex+origin and oneBasedIndex with an added one regardless of origin.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| toothIndex | Zero-based tooth index, independently of output origin. | Required. Safe integer; minimum 0. |
| surfaceIndex | Zero-based index below surfacesPerTooth. | Required. Safe integer; minimum 0. |
| surfacesPerTooth | Surfaces Per Tooth | Required. Safe integer; minimum 1. |
| origin | Origin | Required. Safe integer; minimum 0; maximum 1. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| flatIndex | Flat Index | Required. Safe integer. |
| oneBasedIndex | One Based Index | Required. Safe integer. |
{
"input": {
"toothIndex": 2,
"surfaceIndex": 4,
"surfacesPerTooth": 6,
"origin": 0
},
"output": {
"flatIndex": 16,
"oneBasedIndex": 17
}
}Limitations and assumptions
- Tooth and surface indices are always zero-based inputs. No tooth ID lookup, anatomical surface ordering, or actual chart layout is inferred.
- 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
Similar or alternative tools
- Periodontal Site Alias Order Token
Map supplied site aliases and order indices without inventing a clinical site convention.
- Periodontal Chart Missing Unexamined Tag
Partition supplied tooth IDs by explicit examination status.