Description
Label a lung volume with its stated unit and gas-reference basis.
Respiratory records distinguish signal markers, gas-reference bases, collection validity codes and selected prediction equations. A supplied interval or zero subtraction is only one part of a measurement workflow. Unit labels and device-use discrepancies do not validate a maneuver, estimate a disease state or determine appropriate medication use.
Label a lung volume with its stated unit and gas-reference basis.
When to use this tool
Use Lung Volume BTPS Reference Label when you already have recordId, volume, unitText, statedBasis and need to label a lung volume with its stated unit and gas-reference basis.
How to use the tool and how it works
- Enter recordId, volume, unitText, statedBasis. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read label. Use the output convention below.
Require nonempty recordId/unitText/statedBasis and volume>=0; format record; volume unit [basis].1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| recordId | Record Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| volume | Volume | Required. Finite number; minimum 0. |
| unitText | Unit Text | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| statedBasis | Stated Basis | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| label | Label | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"recordId": "R17",
"volume": 3.5,
"unitText": "L",
"statedBasis": "BTPS"
},
"output": {
"label": "R17; 3.5 L [BTPS]"
}
}Limitations and assumptions
- The label performs no BTPS/STPD conversion, pressure/humidity correction or clinical interpretation.
- 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
Review the original respiratory trace, acquisition protocol and reference-equation definition when interpreting a test. Keep gas-reference bases and supplied quality codes explicit; a zero subtraction, interval or counter discrepancy does not validate the complete measurement.
References
Similar or alternative tools
- Oximetry Signal Quality Label
Attach a supplied signal-quality code to an oximetry record.
- Spirometry Flow Volume Unit Pair
Label the supplied flow and volume units of a spirometry record.