Description
Audit caller-classified research sample validity without spirometry acceptability rules.
A bench or research calculation starts from supplied measurements, reference values, and unit conventions. A transformed value, timing difference, or support fraction describes that model; its clinical meaning depends on measurement validity and a separate professional assessment.
Audit caller-classified research sample validity without spirometry acceptability rules.
When to use this tool
Use it for exhalation valid sample share when the required inputs and conventions are already available.
How to use the tool and how it works
- Enter valid, included. Keep parallel arrays aligned and use the stated units and conventions.
- Run the calculation. Correct any input error before interpreting a result.
- Read validIncluded, includedCount, share, defined. Inspect any known, defined, inclusion, or boundary flags before interpreting numeric values.
Require matching valid and included arrays. Count included samples and those both included and valid, then divide validIncluded by includedCount when positive.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| valid | Valid | Required. Array of Boolean.; maximum items 256. |
| included | Included | Required. Array of Boolean.; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| validIncluded | Valid Included | Required. Safe integer. |
| includedCount | Included Count | Required. Safe integer. |
| 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": {
"valid": [
true,
false,
true
],
"included": [
true,
true,
false
]
},
"output": {
"validIncluded": 1,
"includedCount": 2,
"share": 0.5,
"defined": true
}
}Limitations and assumptions
- An empty included set returns share zero with defined false. This sample-count share is not duration-weighted and does not independently assess spirometry quality.
- 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 exhalation valid sample 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
- Breath Volume Sample Increment
Return one rectangular research airflow-volume contribution with signed flow.
- Pulmonary Sample Gaslag Volume Factor
Ideal plug-flow sample-line residence plus an explicitly supplied analyzer delay, excluding dispersion or device operating recommendations.