Environmental Excursion Alert Threshold Breach Counter
Retain environmental excursion sample count, contiguous episode count, actual exposure and magnitude×duration as different summaries; measurements represent declared intervals, not intersample interpolation or damage.
Description
Excursion samples, episodes, hours and severity describe different properties.
Excursion samples, episodes, hours and severity describe different properties. A contiguous breach can contain multiple samples.
Retain environmental excursion sample count, contiguous episode count, actual exposure and magnitude×duration as different summaries; measurements represent declared intervals, not intersample interpolation or damage.
When to use Environmental Excursion Alert Threshold Breach Counter
Use this tool to retain environmental excursion sample count, contiguous episode count, actual exposure and magnitude×duration as different summaries; measurements represent declared intervals, not intersample interpolation or damage.
Prepare the collection, exposure, scheduling or financial records required for this calculation. Keep row order and the declared units consistent.
How to use Environmental Excursion Alert Threshold Breach Counter and understand its results
- Prepare the collection, exposure, scheduling or financial records required for this calculation. Keep row order and the declared units consistent.
- Enter observedValues, representedExposureHours, callerAllowedLowerValue, callerAllowedUpperValue using the field table and calculation rules, then run the tool.
- Read breachSampleCount, breachEpisodeCount, breachExposureHours, breachSeverityValueHours. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| observedValues | Observed values | list of number | Required |
| representedExposureHours | Represented exposure hours | list of number | Required |
| callerAllowedLowerValue | Caller allowed lower value | number | Required |
| callerAllowedUpperValue | Caller allowed upper value | number | Required |
Align observations and nonnegative exposure hours with ordered lower/upper bounds. Endpoints are inside the band. Count strict breaches and consecutive episodes, and sum exposure and magnitude-hours without interpolation.1
Paired lists must be nonempty and have equal lengths.
severity = Σ distance outside allowed band × represented hours Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| breachSampleCount | Breach sample count | number |
| breachEpisodeCount | Breach episode count | number |
| breachExposureHours | Breach exposure hours | number |
| breachSeverityValueHours | Breach severity value hours | number |
{
"input": {
"observedValues": [
5,
12,
13,
5
],
"representedExposureHours": [
1,
2,
1,
3
],
"callerAllowedLowerValue": 0,
"callerAllowedUpperValue": 10
},
"output": {
"breachSampleCount": 2,
"breachEpisodeCount": 1,
"breachExposureHours": 3,
"breachSeverityValueHours": 7
}
}Limitations and assumptions
Declared intervals are assumed representative; these metrics do not measure damage.
Numbers and computed results must be finite; overflow produces an error. Numeric lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use Temperature Daily Swing Tolerance Checker: Integrate exact piecewise-linear daily temperature degree-hours outside caller center/band and retain measured swing; unlike RH range/slew, this is excursion magnitude×duration, not preservation safety. For a complementary task, use RH Daily Fluctuation Tolerance Band Checker: Audit observed full-day RH range and resolved maximum slew as distinct caller fluctuation criteria; unresolved intersample extremes remain unknown.
References
Similar or alternative tools
- Temperature Daily Swing Tolerance Checker
Integrate exact piecewise-linear daily temperature degree-hours outside caller center/band and retain measured swing; unlike RH range/slew, this is excursion magnitude×duration, not preservation safety.
- RH Daily Fluctuation Tolerance Band Checker
Audit observed full-day RH range and resolved maximum slew as distinct caller fluctuation criteria; unresolved intersample extremes remain unknown.