Description
Return distinct item exposure/response support.
Audiological records depend on ear/channel identity, stimulus calibration, timing and decibel reference conventions. A local level difference or response share can reconcile supplied observations while hearing ability, safe sound output and clinical test interpretation require validated procedures and professional assessment.
Return distinct item exposure/response support.
When to use this tool
Use Speech List Item Exposure Share when checking the stated hearing-test record, acoustic level, frequency or timing convention.
How to use the tool and how it works
- Enter itemIds, presentedIds, validResponseIds. Follow any array-alignment requirements below. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read uniqueItems, validPresentedItems, share, defined. Inspect defined before interpreting the associated values.
Return distinct item exposure/response support. Count unique itemIds and those present in both presentedIds and validResponseIds; share divides by item count or is undefined when empty.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| itemIds | Item Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| presentedIds | Presented Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| validResponseIds | Valid Response Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| uniqueItems | Unique Items | Required. Safe integer. |
| validPresentedItems | Valid Presented Items | Required. Safe integer. |
| share | Dimensionless numerator/denominator ratio under the explicit basis above. | Required. Finite number. |
| defined | Whether the stated denominator or information basis supports this value; inspect placeholders before interpretation. | Required. Boolean. |
{
"input": {
"itemIds": [
"a",
"b",
"c"
],
"presentedIds": [
"a",
"b"
],
"validResponseIds": [
"a"
]
},
"output": {
"uniqueItems": 3,
"validPresentedItems": 1,
"share": 0.3333333333333333,
"defined": true
}
}Limitations and assumptions
- IDs and valid-response assertions are supplied; no speech recognition, item difficulty or clinical score validity is assessed.
- 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.
Alternative or Complementary methods
Use calibrated equipment and a complete validated audiological method; consult an appropriate hearing-health professional for diagnosis, fitting or safe exposure decisions.
References
Similar or alternative tools
- Speech List Omitted Item Denominator
Return speech-list correct share under an omission policy.
- Speech List Presented Versus Scored Count
Reconcile explicitly presented and scored speech-list item counts without calculating a diagnostic score.