smartqhse-hse-calculators (Python)

30+ health, safety & environment (HSE) calculators — TRIR, LTIR, LTIFR, DART, EMR, severity rate, heat stress (WBGT), noise exposure, hand-arm vibration, ergonomics (REBA, RULA, NIOSH), fire load, evacuation time, manhours, risk matrix, incident cost, and more. Pure Python 3.11+, zero runtime dependencies, MIT licensed.

The Python port of @smartqhse/hse-calculators (TypeScript). Same formulas, same authoritative citations, Python-native API with type hints and dataclasses / TypedDicts.

🌐 Live calculators: tools.smartqhse.com 🏗️ Full HSE platform: smartqhse.com — AI-powered permits, risk assessments, incidents, audits, ISO 45001 compliance.

Installation

pip install smartqhse-hse-calculators

Zero runtime dependencies. Python 3.11+.

Quick start

from smartqhse_hse_calculators import (
    calculate_trir,
    calculate_ltifr,
    calculate_wbgt,
    calculate_risk_matrix,
)

# TRIR — OSHA Total Recordable Incident Rate
trir = calculate_trir(recordable_incidents=3, hours_worked=500_000)
print(trir.rate)   # 1.2
print(trir.base)   # 200_000

# LTIFR — ISO/ILO Lost Time Injury Frequency Rate
ltifr = calculate_ltifr(lost_time_injuries=3, hours_worked=500_000)
print(ltifr.rate)  # 6.0

# WBGT heat stress (ACGIH TLV / ISO 7243)
heat = calculate_wbgt(temp_c=38, humidity=60, globe_temp_c=42, indoor=False)
print(heat["risk_level"])            # 'high' or 'extreme'
print(heat["acgih_work_rest_ratio"]) # '25/75' or 'Stop work'

# 5×5 Risk matrix (oil & gas standard)
risk = calculate_risk_matrix(likelihood=4, severity=5, matrix="5x5")
print(risk["band"])     # 'extreme'
print(risk["action"])   # 'Intolerable — stop work, escalate to leadership'

Available calculators

Incident rate formulas

Occupational exposure

Environmental

Ergonomics

Fire safety

Workload & risk

Type safety

Every function has type hints. Result types are @dataclass(frozen=True) or TypedDict. Works with mypy --strict.

from smartqhse_hse_calculators.incident_rates import RateResult

result: RateResult = calculate_trir(recordable_incidents=3, hours_worked=500_000)
# result.rate  → float
# result.base  → int
# result.formula → str

Regulation citations

Every formula is rooted in a published regulation or peer-reviewed ergonomic standard. No proprietary calculations, no "SmartQHSE recommends" values.

United States

• 29 CFR 1904.7 — OSHA recordability (TRIR, LTIR, DART)
• 29 CFR 1910.95 — OSHA occupational noise
• NIOSH Publication 94-110 — Revised lifting equation
• NFPA 10, 101, 557 — Fire codes
• ASHRAE 62.1 — Ventilation
• NCCI — Workers comp EMR

United Kingdom

• HSE L140 — Hand-arm vibration
• HSE MAC tool — Manual handling
• BS 5306, BS 9999 — Fire safety
• HSE Stress Management Standards

International

• ISO 45001:2018 — OH&S management systems
• ISO 14064-1 — GHG quantification
• ISO 2631-1 — Whole-body vibration
• ISO 7243 — WBGT heat stress
• ILO — Frequency rate standards

Europe

• EU Directive 2003/10/EC — Noise
• EU Directive 2002/44/EC — Vibration
• EN 12464-1 — Workplace lighting

Professional bodies

• ACGIH TLVs® — Threshold Limit Values
• GHG Protocol — Scope 1/2/3 accounting
• IOGP — Oil & gas safety benchmarks
• NIOSH — National Institute for Occupational Safety and Health

Who uses this library

• Data scientists doing safety analytics in pandas / Jupyter
• Safety researchers running statistical analyses on HSE datasets
• Academic institutions teaching occupational health and safety
• Government agencies analysing workplace safety trends
• EHS software vendors embedding standardised calculations
• Consultants producing client reports with auditable formulas
• Industrial hygienists quantifying exposure

Full platform

SmartQHSE is the AI-powered HSE / QHSE management platform built on top of these calculators — permits, AI-generated risk assessments, incident management, contractor prequalification, ISO 45001 compliance dashboards.

License

MIT © SmartQHSE Ltd

Related

• TypeScript version: @smartqhse/hse-calculators
• Live web UI: tools.smartqhse.com
• HSE Benchmarks 2026 open dataset: smartqhse.com/datasets/hse-benchmarks-2026
• Awesome HSE: github.com/SmartQHSE/awesome-hse
• HSE knowledge base: smartqhse.com/answers