Research Proxy Response Gap Tool

Description

Average proxy minus self over flagged pairs, otherwise return zero with defined false.

Geriatric research summaries organize supplied observations, activities, and support records. Counts and ratios describe that research data; they are not clinical scores unless an independently validated scoring method explicitly defines them.

Average proxy minus self over flagged pairs, otherwise return zero with defined false.

When to use this tool

Use Research Proxy Response Gap when you need a descriptive calculation on supplied geriatric research records.

How to use the tool and how it works

Enter itemIds, selfResponses, proxyResponses, pairedValid. 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 validPairs, meanProxyMinusSelf, defined. Inspect defined before interpreting the associated values.

Require aligned unique itemIds and selfResponses, proxyResponses, and pairedValid flags. Average proxy minus self over flagged pairs, otherwise return zero with defined false.^[1]

Input field	Meaning and units	Accepted input
itemIds	Item Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
selfResponses	Self Responses	Required. Array of finite number; maximum items 256.
proxyResponses	Proxy Responses	Required. Array of finite number; maximum items 256.
pairedValid	Paired Valid	Required. Array of boolean; maximum items 256.

Output field	Interpretation	Returned shape
validPairs	Valid Pairs	Required. Safe integer.
meanProxyMinusSelf	Mean Proxy Minus Self	Required. Finite number.
defined	Whether the stated denominator or normalization exists; inspect before interpreting a zero placeholder.	Required. Boolean.

json

{
  "input": {
    "itemIds": [
      "a",
      "b"
    ],
    "selfResponses": [
      2,
      3
    ],
    "proxyResponses": [
      3,
      5
    ],
    "pairedValid": [
      true,
      false
    ]
  },
  "output": {
    "validPairs": 1,
    "meanProxyMinusSelf": 1,
    "defined": true
  }
}

Limitations and assumptions

Validity is supplied rather than assessed; no proxy authority, clinical agreement threshold, scale equivalence, or patient capacity is determined.
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 the appropriate validated assessment and professional review when clinical interpretation is required. Check observation scope, missingness, and denominator conventions before comparing research summaries.

References

Calculation and input contract: geriatrics/research-proxy-response-gap — tool.io

Similar or alternative tools

Eldercare Research Complete Case Pair Mask
Return their pairwise conjunction as complete and count true pairs.
Research Function Item Share
Count domain items and available domain items and divide, otherwise return zero with defined false for no domain items.