Description
Calculate research item support share from explicit caller-supplied inputs.
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.
Calculate research item support share from explicit caller-supplied inputs.
When to use this tool
Use it for research item support share when the required inputs and conventions are already available.
How to use the tool and how it works
- Enter itemWeights, applicable, responseKnown, sourceVerified. Keep parallel arrays aligned and use the stated units and conventions.
- Run the calculation. Correct any input error before interpreting a result.
- Read applicableWeight, supportedWeight, share, defined. Inspect any known, defined, inclusion, or boundary flags before interpreting numeric values.
Sum nonnegative item weights for applicable entries and for entries jointly applicable, responseKnown, and sourceVerified. Return supported/applicable weight or zero with defined false when no applicable weight exists.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| itemWeights | Item Weights | Required. Array of Finite number; minimum 0.; maximum items 256. |
| applicable | Applicable | Required. Array of Boolean.; maximum items 256. |
| responseKnown | Response Known | Required. Array of Boolean.; maximum items 256. |
| sourceVerified | Source Verified | Required. Array of Boolean.; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| applicableWeight | Applicable Weight | Required. Finite number. |
| supportedWeight | Supported Weight | Required. Finite number. |
| share | Dimensionless fraction using the denominator described above; not a percentage numeral. | Required. Finite number. |
| defined | Whether the associated denominator or quantity is defined; read this before interpreting a zero placeholder. | Required. Boolean. |
{
"input": {
"itemWeights": [
2,
3,
5
],
"applicable": [
true,
true,
false
],
"responseKnown": [
true,
true,
true
],
"sourceVerified": [
true,
false,
true
]
},
"output": {
"applicableWeight": 5,
"supportedWeight": 2,
"share": 0.4,
"defined": true
}
}Limitations and assumptions
- Aligned arrays represent caller annotations, not independently verified clinical evidence. A true sourceVerified flag is trusted as supplied and weighted completeness is not a validated research or disease score.
- 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 research item support share, 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
- Item Response Direction Gap
Orient one supplied research-item difference without a clinical score.
- Joint Count Research Assessed Site Fraction
Audit supplied research site counts with unable and missing sites separate.