Description
Sum all weights and those satisfying all three flags; return share=supportedWeight/totalWeight when positive, otherwise zero with defined=false.
Optical calculations distinguish lens power in diopters, prism notation, angular axes, geometric distances, and visual-acuity reporting scales. Sign conventions and length units are especially important when a formula combines power with decentration or vertex distance. A supplied model term is separate from a validated visual test or prescription.
Sum all weights and those satisfying all three flags; return share=supportedWeight/totalWeight when positive, otherwise zero with defined=false.
When to use this tool
Use Visual Test Support Share when you need this explicit optical, chart, frame, axis, or reference conversion with compatible supplied units.
How to use the tool and how it works
- Enter trialWeights, stimulusVerified, viewingConditionValid, responseRecorded. 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 totalWeight, supportedWeight, share, defined. Inspect defined before interpreting the associated values.
Require aligned nonnegative trialWeights with stimulusVerified, viewingConditionValid, and responseRecorded. Sum all weights and those satisfying all three flags; return share=supportedWeight/totalWeight when positive, otherwise zero with defined=false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| trialWeights | Trial Weights | Required. Array of finite number; minimum 0; maximum items 256. |
| stimulusVerified | Stimulus Verified | Required. Array of boolean; maximum items 256. |
| viewingConditionValid | Viewing Condition Valid | Required. Array of boolean; maximum items 256. |
| responseRecorded | Response Recorded | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| totalWeight | Total Weight | Required. Finite number. |
| supportedWeight | Supported Weight | Required. Finite number. |
| share | Dimensionless share using the stated denominator, not a percentage numeral. | Required. Finite number. |
| defined | Whether the stated denominator or quantity is defined; inspect before using a placeholder. | Required. Boolean. |
{
"input": {
"trialWeights": [
2,
3,
5
],
"stimulusVerified": [
true,
true,
true
],
"viewingConditionValid": [
true,
true,
false
],
"responseRecorded": [
true,
false,
true
]
},
"output": {
"totalWeight": 10,
"supportedWeight": 2,
"share": 0.2,
"defined": true
}
}Limitations and assumptions
- Weights and support flags are supplied. This measures weighted record support, not response accuracy, a validated visual-function score, or whether viewing conditions were actually controlled.
- 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 complete optical or measurement model when a scalar term is insufficient. Verify power, axis, length, notation, and reference conventions before applying the result within a broader assessment.
References
Similar or alternative tools
- Retinal Mask Support Share
Account for explicit research mask areas and support flags without retinal image interpretation.
- EEG Reference Support Share
Sum included reference weight and included valid weight, and return their share when referenceWeight>0, otherwise zero with defined=false.