Description
Compare a research value with a caller-selected threshold policy.
Clinical research distinguishes supplied protocol metadata, participant/event records, allocation bookkeeping and an analysis target. A local count, permission flag or denominator choice can help reconcile records without establishing valid consent, randomization, regulatory compliance or a reliable treatment-effect estimate.
Compare a research value with a caller-selected threshold policy.
When to use this tool
Use Research Supplied Threshold Equality Rule when checking the stated clinical-research record, allocation, timing, analysis or evidence-basis convention.
How to use the tool and how it works
- Enter value, threshold, direction, equalityCounts. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read signedMargin, meets, equal. Inspect meets, equal before interpreting the associated values.
Compare a research value with a caller-selected threshold policy. Require direction above/below; signedMargin orients value-threshold toward the requested direction, meets applies strict/inclusive comparison under equalityCounts, equal tests exact equality.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| value | Value | Required. Finite number. |
| threshold | Threshold | Required. Finite number. |
| direction | Direction | Required. Text; one of "above", "below"; maximum UTF-16 length 8192. |
| equalityCounts | Caller-selected inclusive/strict comparison; no measurement tolerance or clinical threshold is chosen. | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| signedMargin | Signed Margin | Required. Finite number. |
| meets | Meets | Required. Boolean. |
| equal | Equal | Required. Boolean. |
{
"input": {
"value": 5,
"threshold": 5,
"direction": "above",
"equalityCounts": false
},
"output": {
"signedMargin": 0,
"meets": false,
"equal": true
}
}Limitations and assumptions
- No tolerance is added; the threshold is supplied and does not establish a clinically validated decision rule or appropriate action.
- 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 complete approved protocol, authenticated source records and qualified clinical/statistical oversight for actual trial design, conduct and interpretation.
References
Similar or alternative tools
- Cue Validity Uninformative Base Flag
Compare cue correctness with a baseline and tolerance.
- Protocol Window Boundary Distance
Return signed distances from protocol-window boundaries.