Description
Count explicit paired-side research observation coverage without scoring joint disease.
Research records distinguish observed, missing, inapplicable, and unverified entries. Those categories affect which denominator or weight a summary uses. A completeness or timing calculation describes the supplied records without assigning a clinical score or interpreting a condition.
Count explicit paired-side research observation coverage without scoring joint disease.
When to use this tool
Use it for joint side observation gap when the required inputs and conventions are already available.
How to use the tool and how it works
- Enter jointIds, sides, observed, leftLabel, rightLabel. Keep parallel arrays aligned and use the stated units and conventions.
- Run the calculation. Correct any input error before interpreting a result.
- Read leftObserved, rightObserved, unpairedJointIds. Inspect any known, defined, inclusion, or boundary flags before interpreting numeric values.
Build distinct observed joint-ID sets for the supplied left and right labels. Return each set size and the size of their symmetric difference as unpairedJointIds.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| jointIds | Joint Ids | Required. Array of Text; maximum UTF-16 length 8192.; maximum items 256. |
| sides | Sides | Required. Array of Text; maximum UTF-16 length 8192.; maximum items 256. |
| observed | Observed | Required. Array of Boolean.; maximum items 256. |
| leftLabel | Left Label | Required. Text; maximum UTF-16 length 8192. |
| rightLabel | Right Label | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| leftObserved | Left Observed | Required. Safe integer. |
| rightObserved | Right Observed | Required. Safe integer. |
| unpairedJointIds | Count of IDs occurring on exactly one supplied side; not an identifier list. | Required. Safe integer. |
{
"input": {
"jointIds": [
"k",
"k",
"w"
],
"sides": [
"L",
"R",
"L"
],
"observed": [
true,
true,
true
],
"leftLabel": "L",
"rightLabel": "R"
},
"output": {
"leftObserved": 2,
"rightObserved": 1,
"unpairedJointIds": 1
}
}Limitations and assumptions
- The latter is a count, not an array. Duplicate rows do not multiply joints and other side labels are ignored. Exact IDs and caller labels are not a clinical interpretation of laterality or disease.
- The field tables describe structural bounds; the mechanics also state cross-field requirements. Malformed input shapes, disallowed keys, and invalid domains cause input errors. Results must remain finite and within the declared output contract. A successful false flag or zero placeholder is distinct from an error.
- Numeric arithmetic uses binary floating point. Exact comparisons have no hidden tolerance or decimal rounding; negative zero is exported as zero. Decimal-text integer operations retain the exactness specifically stated above.
Alternative or Complementary methods
For joint side observation gap, check the source records and the supplied rule before comparing the result with another method. Use an appropriately validated measurement or analysis method for clinical interpretation.
References
Similar or alternative tools
- Joint Site Observation Share
Count research site observation coverage without disease activity scoring.
- Joint Assessment Unable Versus Missing Token
Count explicit assessed, unable and missing site statuses.