Description
Preserve a supplied research trial discard annotation without selecting performance criteria.
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.
Preserve a supplied research trial discard annotation without selecting performance criteria.
When to use this tool
Use it for grip trial discard reason token when the required inputs and conventions are already available.
How to use the tool and how it works
- Enter trialId, discardReason, allowedReasons. Keep parallel arrays aligned and use the stated units and conventions.
- Run the calculation. Correct any input error before interpreting a result.
- Read discarded, reasonRecognized, trialKey. Inspect any known, defined, inclusion, or boundary flags before interpreting numeric values.
Mark a trial discarded whenever discardReason is nonempty, independently mark whether that reason is in allowedReasons or empty, and serialize trialId/reason as a JSON tuple key.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| trialId | Trial Id | Required. Text; maximum UTF-16 length 8192. |
| discardReason | Discard Reason | Required. Text; maximum UTF-16 length 8192. |
| allowedReasons | Allowed Reasons | Required. Array of Text; maximum UTF-16 length 8192.; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| discarded | Discarded | Required. Boolean. |
| reasonRecognized | Reason Recognized | Required. Boolean. |
| trialKey | Trial Key | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"trialId": "T2",
"discardReason": "slip",
"allowedReasons": [
"slip",
"device"
]
},
"output": {
"discarded": true,
"reasonRecognized": true,
"trialKey": "[\"T2\",\"slip\"]"
}
}Limitations and assumptions
- An unrecognized reason still marks the record discarded. No reason is selected, strength value judged, or measurement quality inferred; the key is an identity aid rather than authentication.
- 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 grip trial discard reason token, 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 Assessment Unable Versus Missing Token
Count explicit assessed, unable and missing site statuses.