Description
Resolve one supplied specimen location relative to an explicit research reference and legend, without surgery planning.
Oral laboratory and research records use specimen labels, model coordinates, material quantities, event times, and device identifiers. A matching label or dimensional clearance answers a narrower question than verified anatomy, traceability, or clinical suitability. Source identity, reference frames, and measurement units must remain explicit.
Resolve one supplied specimen location relative to an explicit research reference and legend, without surgery planning.
When to use this tool
Use Specimen Site Reference Offset when you need this specimen-record, device-label, timing, material, or model-geometry check.
How to use the tool and how it works
- Enter siteCoordinate, referenceCoordinate, suppliedScale, siteLabel, source. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read offset, sourceKey. Use the output convention below.
For positive suppliedScale return offset=(siteCoordinate-referenceCoordinate)*scale and sourceKey=JSON.stringify([source,siteLabel]).1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| siteCoordinate | Site Coordinate | Required. Finite number. |
| referenceCoordinate | Reference Coordinate | Required. Finite number. |
| suppliedScale | Supplied Scale | Required. Finite number; strictly above 0. |
| siteLabel | Site Label | Required. Text; maximum UTF-16 length 8192. |
| source | Source | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| offset | Offset | Required. Finite number. |
| sourceKey | Source Key | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"siteCoordinate": 12,
"referenceCoordinate": 2,
"suppliedScale": 0.5,
"siteLabel": "site-A",
"source": "legend-2"
},
"output": {
"offset": 5,
"sourceKey": "[\"legend-2\",\"site-A\"]"
}
}Limitations and assumptions
- Scale maps the coordinate difference to the desired length unit. Source and site labels are preserved metadata, not validated anatomical sites, specimen identities, or evidence of correct clinical localization.
- 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 authenticated records and the intended laboratory or measurement protocol for the full task. Verify source labels, coordinate frames, calibration, and the limits of the supplied physical model.
References
Similar or alternative tools
- Scan Model Unit Closure Gap
For nonnegative scanDistance and modelDistance and positive suppliedModelPerScanUnit return convertedScanDistance=scanDistance*factor and closureGap=modelDistance-convertedScanDistance.
- Jaw Model Plane Offset Coordinate Term
Translate a supplied oriented plane along its unit normal and report point distances.