Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- AIR Limit Mode
-
Default TWA and ceiling Allowed TWA only, Ceiling only, TWA and ceiling
About this input
Evaluate the time-weighted average, the ceiling, or both. Inputs and outputs for a nonselected limit type are inactive.
- AIR Profile Conditional
-
Default OSHA Table Z-1 screening Allowed OSHA Table Z-1 screening, Custom / other OEL
About this input
OSHA mode fixes the TWA reference period at eight hours. Custom mode uses the entered reference period but supplies no limit data.
- AIR Concentration Unit
-
Default ppm Allowed ppm, mg/m3, ug/m3, fibers/cm3
About this input
One of four explicit concentration-unit labels applied consistently to all entered concentrations and limits. Changing it relabels values and never converts them.
- AIR Shift Length Hours Conditional
-
Unit hours Default 8 Range 1E-06 to 24
About this input
Actual shift duration. TWA modes require grid durations to equal this value; ceiling-only mode permits partial or instantaneous observations.
- AIR Custom Reference Period Hours Conditional
-
Unit hours Default 8 Range 1E-06 to 24
About this input
Positive averaging reference period used only in custom mode when TWA is evaluated.
- AIR TWA Limit Conditional
-
Unit ppm Default 100 Range 1E-12 to 1000000000
About this input
Positive applicable TWA limit supplied by the user. No regulatory or proprietary OEL lookup is included.
- AIR Ceiling Limit Conditional
-
Unit ppm Default 200 Range 1E-12 to 1000000000
About this input
Positive applicable ceiling supplied by the user. No substance-specific value is embedded.
- AIR Ceiling Data Basis Conditional
-
Default Known constant or instantaneous maximum Allowed Known constant or instantaneous maximum, Time-averaged samples
About this input
Distinguishes a directly comparable known/instantaneous maximum from averages that may mask a shorter excursion.
- AIR Ceiling Averaging Period Minutes Conditional
-
Unit minutes Default 15 Range 1E-06 to 1440
About this input
Required positive averaging duration for every time-averaged ceiling sample. OSHA Table Z-1 screening defaults this to 15 minutes; any nonmatching sample duration is reported as indeterminate.
- AIR Exposure Period Grid
-
Default 4 rows
About this input
Up to 12 entries. Blank rows are unused. Every used row requires a 1-to-80-character label, a purpose of TWA period or Ceiling sample, numeric concentration from 0 through 1e9 in the selected unit, and numeric duration from 0 through 24 hours. TWA coverage uses only TWA-period rows; ceiling logic uses only ceiling-sample rows. Zero duration is allowed only for a known/instantaneous ceiling observation; time-averaged ceiling samples require positive duration. Contract 0.17 cannot encode per-grid-column dropdowns, types, units, or bounds, so workbook validation and Model_Status enforce them.
Column Range or allowed values Period / sample Not declared Purpose TWA period, Ceiling sample Concentration 0 to 1000000000 Duration (h) 0 to 24
Outputs
- AIR Total Concentration Time Dose Conditional
-
Unit ppm*hour
About this output
Sum of concentration multiplied by duration across complete rows marked TWA period.
- AIR Actual Shift TWA Conditional
-
Unit ppm
About this output
Concentration-time dose divided by actual shift length.
- AIR Reference Period Equivalent Conditional
-
Unit ppm
About this output
Concentration-time dose divided by the active eight-hour or custom reference period; this is the value compared with the entered TWA limit.
- AIR TWA Limit Ratio Conditional
-
Unit fraction
About this output
Reference-period equivalent divided by the entered TWA limit; values can exceed 100%.
- AIR Maximum Concentration Conditional
-
Unit ppm
About this output
Largest comparable ceiling-sample concentration: every ceiling row in known/instantaneous mode, but only exact-window rows in time-averaged mode. Returns zero when no time-averaged row is comparable; the ceiling result then remains indeterminate.
- AIR Ceiling Limit Ratio Conditional
-
Unit fraction
About this output
Maximum comparable ceiling concentration divided by the entered ceiling; values can exceed 100%. Mismatched-window samples remain visible in the chart and drive an indeterminate warning but are not presented as a conclusive ratio.
- AIR Entered Duration Above Ceiling Conditional
-
Unit hours
About this output
Sum of durations for ceiling-sample rows whose entered concentration exceeds the ceiling. It is not a reconstruction of exact excursion duration from averaged samples.
- AIR Coverage Gap Hours Conditional
-
Unit hours
About this output
Shift length minus durations of TWA-period rows; valid TWA models require this to be zero within numerical tolerance.
- AIR Reference Period Used Conditional
-
Unit hours
About this output
Eight hours in OSHA mode or the entered custom averaging reference period.
- AIR Ceiling Averaging Period Used Conditional
-
Unit minutes
About this output
Active averaging-duration screen for time-averaged ceiling samples.
- AIR Dominant Period
-
No unit declared
About this output
In ceiling-only mode, the first maximum-concentration ceiling-sample row; in any TWA mode, the first largest TWA concentration-time-dose row (falling back to maximum TWA concentration or first active TWA row when all doses are zero).
- AIR TWA Result Conditional
-
No unit declared
About this output
Below, at, or above the entered TWA limit; hidden when TWA is not selected.
- AIR Ceiling Result Conditional
-
No unit declared
About this output
A matching known/instantaneous or exact-duration averaged sample at or above the entered ceiling takes precedence; otherwise any mismatched averaged sample makes the ceiling screen indeterminate.
- AIR Overall Exposure Result
-
No unit declared
About this output
Combined result for selected limit types with at/above precedence over an otherwise indeterminate ceiling screen.
- Model Status
-
No unit declared
About this output
Returns an actionable NOT VALID or CHECK reason for malformed inputs, duplicate labels, sample-window mismatch, extended shift, or a reached limit; otherwise OK.
Methodology
Purpose and model boundary
This model combines concentration-and-duration entries into an actual-shift average, a reference-period equivalent, entered-limit ratios, and a separate ceiling screen. It does not contain a contaminant library or decide which occupational exposure limit applies. The user must select a concentration unit and enter current, substance-specific limits from an authoritative source.
Inputs and units
The evaluation mode enables the TWA screen, the ceiling screen, or both. OSHA Table Z-1 screening fixes the TWA reference period at eight hours; custom mode uses the entered reference period. All concentrations and entered limits must use the selected unit consistently because the workbook does not convert among ppm, mg/m3, ug/m3, or fibers/cm3.
Each active table row is assigned either TWA period or Ceiling sample. TWA rows contain a concentration and duration in hours. A ceiling row is treated as a known constant/instantaneous maximum, or as a time-averaged sample that can be compared conclusively only when its duration matches the entered averaging window.
Governing relationships
For TWA row i, the concentration-time dose is:
D_i = C_i × t_i
The combined dose, actual-shift average, and active reference-period equivalent are:
D_total = Σ D_i
C_shift = D_total / T_shift
C_reference = D_total / T_reference
where T_reference = 8 h in the OSHA profile and is user-entered in the custom profile. The TWA utilization is:
TWA ratio = C_reference / TWA_limit
The ceiling calculation selects the largest comparable ceiling-sample concentration:
C_ceiling,max = max(C_j for matching ceiling rows j)
Ceiling ratio = C_ceiling,max / Ceiling_limit
In known/instantaneous mode every complete ceiling row is comparable. In time-averaged mode, only rows whose positive duration exactly matches the active averaging window are comparable; other ceiling rows remain visible but make the screen indeterminate.
Calculation sequence
- Validate the selected modes, unit, active limits, table rows, and any visible reference or ceiling-window input.
- Require at least one complete row for every selected screen and require all 12 table slots to be either complete and valid or unused.
- For a TWA screen, require TWA-row durations to cover the shift length within the workbook tolerance and calculate dose, shift average, reference equivalent, and ratio.
- For a ceiling screen, identify comparable samples, calculate the maximum and ratio when possible, and preserve mismatched averaged samples as an indeterminate condition.
- Identify the dominant period and evaluate status in the precedence shown below.
Outputs and interpretation
The reference-period equivalent is the value compared with the entered TWA limit; it is distinct from the actual-shift average when the shift and reference periods differ. Ratios may exceed 100%. The entered duration above the ceiling is only the sum of durations on rows whose entered concentration exceeds that limit; it cannot reconstruct the true excursion duration hidden inside an averaged sample.
The combined result gives precedence to a conclusive at/above-limit finding over an otherwise indeterminate ceiling screen. These results are arithmetic screens, not regulatory determinations.
Validation and status logic
| Condition, evaluated in order | Returned status |
|---|---|
| A selected limit, purpose-specific row set, row value, TWA coverage, reference period, or ceiling-window input is invalid | NOT VALID: review active limits, purpose-specific rows, and coverage |
| The active TWA ratio reaches 1, or a comparable ceiling sample reaches the entered ceiling | CHECK: at or above an entered limit |
| An active period/sample label is duplicated | CHECK: duplicate period labels |
| Time-averaged ceiling mode contains a sample whose duration does not match the active window | CHECK: ceiling sample window mismatch |
| The shift is longer than the active TWA reference period | CHECK: extended shift needs an approved adjustment |
| None of the preceding conditions applies | OK |
This is the workbook's exact Model_Status precedence. The reached-limit check intentionally precedes duplicate-label, window-mismatch, and extended-shift warnings.
Assumptions and limitations
- Every concentration and limit uses the same selected unit, and every populated row belongs to one calculation purpose only.
- TWA rows must cover the full shift; overlapping or nonrepresentative sampling periods are not detected.
- No OSHA PEL, NIOSH REL, ACGIH TLV, conversion factor, skin notation, mixture rule, excursion limit, respirator factor, or substance-specific exception is embedded.
- The 15-minute OSHA ceiling-window default reflects general Table Z-1 guidance where instantaneous monitoring is infeasible; it may not apply to a particular contaminant.
- Sampling uncertainty, additive-mixture exposure, peak rules, and extended-shift adjustment methods are outside scope.
- The authored concentration ceiling of
1e9is a computational guardrail, not a health-based limit.
Restrictions and non-computing states
At least one active row is required. Active rows need a label, declared purpose, nonnegative numeric concentration, and valid duration. TWA duration must equal the shift length within 1e-8 h; a time-averaged ceiling sample must have positive duration. Active limits must be positive, reference and shift periods must be greater than zero and no more than 24 hours, and the ceiling window must be greater than zero and no more than 1,440 minutes.
Errors and warnings
NOT VALID means no supported exposure result can be interpreted from the entered state. CHECK preserves arithmetic where possible but identifies a reached limit, duplicate identifier, incomparable sample window, or unadjusted extended shift requiring review. A calculation-service or connection error is not an exposure finding.
References
The governing equations, exact sample-matching behavior, named outputs, validation rules, and status precedence were verified against the delivered workbook, its published input rules, tests, and reviewer packet. The workbook identifies these technical sources:
- OSHA 29 CFR 1910.1000 — Air contaminants — Eight-hour TWA arithmetic, ceiling interpretation, and the general 15-minute ceiling-sampling footnote.
- eCFR 29 CFR 1910.1000 — Current official regulatory text cross-check.
- NIOSH Pocket Guide introduction — Definitions and cautions distinguishing TWA, ceiling, and short-term exposure limits.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.