PHPackages                             davecook/healthcare-voc-compliance - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. davecook/healthcare-voc-compliance

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

davecook/healthcare-voc-compliance
==================================

Healthcare VOC compliance calculator — computes VOC exposure, OSHA PEL comparison, and multi-jurisdiction regulatory compliance for cleaning products.

v0.1.0(3mo ago)00MITPythonPHP &gt;=8.0

Since Apr 7Pushed 3mo agoCompare

[ Source](https://github.com/DaveCookVectorLabs/healthcare-voc-compliance)[ Packagist](https://packagist.org/packages/davecook/healthcare-voc-compliance)[ Docs](https://github.com/DaveCookVectorLabs/healthcare-voc-compliance)[ RSS](/packages/davecook-healthcare-voc-compliance/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependenciesVersions (2)Used By (0)

Healthcare VOC Compliance Calculator
====================================

[](#healthcare-voc-compliance-calculator)

[![PyPI version](https://camo.githubusercontent.com/8fffc3c446654a0cd18433a46eb99b764705629f64ef3a301fcc4b4db9e5de53/68747470733a2f2f62616467652e667572792e696f2f70792f6865616c7468636172652d766f632d636f6d706c69616e63652e737667)](https://pypi.org/project/healthcare-voc-compliance/)[![npm version](https://camo.githubusercontent.com/5f8c493945d8ecebfbbf830caf4e69d3dfe334091a9863b919ce2735ef71dbd1/68747470733a2f2f62616467652e667572792e696f2f6a732f25343064617665636f6f6b2532466865616c7468636172652d766f632d636f6d706c69616e63652e737667)](https://www.npmjs.com/package/@davecook/healthcare-voc-compliance)[![Crates.io](https://camo.githubusercontent.com/72cd5551cfec477ec06781699bde28f7904a402c082e2c7989e8641893fd4519/68747470733a2f2f696d672e736869656c64732e696f2f6372617465732f762f6865616c7468636172652d766f632d656e67696e652e737667)](https://crates.io/crates/healthcare-voc-engine)[![Gem Version](https://camo.githubusercontent.com/8c37ac58e1ff53ec42835fabfe7181e582cdedaf65eebcb8752f0fef6ca63074/68747470733a2f2f62616467652e667572792e696f2f72622f6865616c7468636172655f766f635f636f6d706c69616e63652e737667)](https://rubygems.org/gems/healthcare_voc_compliance)[![Hex.pm](https://camo.githubusercontent.com/cef234db148702083d10103a77ceaa8e0dbb90d4a71b8780089592008b34d4c2/68747470733a2f2f696d672e736869656c64732e696f2f686578706d2f762f6865616c7468636172655f766f632e737667)](https://hex.pm/packages/healthcare_voc)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

An open-source calculator and dataset collection for evaluating VOC (Volatile Organic Compound) exposure from cleaning products used in healthcare facilities. Covers 26 jurisdictions across the United States and Canada.

---

What This Does
--------------

[](#what-this-does)

Given a cleaning product's VOC content, a room's geometry, and ventilation parameters, this tool calculates:

- **VOC concentration** (mg/m³) at steady state during a cleaning cycle
- **OSHA PEL comparison** — what percentage of the Permissible Exposure Limit the concentration represents
- **Time to safe reentry** — how long until VOC concentration drops below 10% of PEL
- **Annual VOC load** — total VOC released per year at the given cleaning frequency
- **Multi-jurisdiction compliance** — whether the product meets VOC limits in each of 26 jurisdictions

---

Datasets
--------

[](#datasets)

Two CSV datasets are included in `datasets/`:

### Dataset A: VOC Regulatory Limits by Jurisdiction (650 rows)

[](#dataset-a-voc-regulatory-limits-by-jurisdiction-650-rows)

VOC limits (g/L) for 25 cleaning product categories across 26 jurisdictions:

- US Federal (EPA 40 CFR Part 59 Subpart C)
- California (CARB Consumer Products Regulations)
- 12 OTC states (CT, DE, ME, MD, MA, NH, NJ, NY, PA, RI, VA, DC)
- 8 states with independent regulations (MI, CO, IL, IN, IA, OH, UT, WA)
- Canada Federal (SOR/2021-268)
- Ontario, British Columbia, Quebec

Each row includes the product category, numeric VOC limit, regulation name, effective date, and healthcare-specific context notes.

### Dataset B: Healthcare Cleaning Product VOC Compliance Matrix (5,000 rows)

[](#dataset-b-healthcare-cleaning-product-voc-compliance-matrix-5000-rows)

Synthetic product data modeled on real institutional cleaning product categories:

- VOC content (g/L concentrate and effective diluted)
- Certifications (Green Seal GS-37, UL ECOLOGO, EPA Safer Choice, UL GREENGUARD Gold, LEED v4)
- Per-jurisdiction compliance flags (compliant/non-compliant in each of 26 jurisdictions)
- Healthcare approval status, IPAC compatibility rating
- Pricing (CAD/litre), dilution ratios, coverage rates
- Recommended healthcare facility types

---

Calculation Model
-----------------

[](#calculation-model)

```
effective_voc     = product_voc_g_per_L × dilution_ratio
product_applied_L = room_sqft / coverage_sqft_per_L
total_voc_mg      = effective_voc × product_applied_L × 1000

# Single-zone mass balance with ventilation
emission_rate     = total_voc_mg / cleaning_duration_hr
ventilation_rate  = air_changes_per_hour × room_volume_m3
steady_state      = emission_rate / ventilation_rate

osha_pel_percent  = (steady_state / 300) × 100

```

ASHRAE 62.1-2022 minimum ventilation rates for healthcare spaces are built in as reference values:

Space TypeMinimum ACHPatient room6ICU12Operating room20Exam room6Corridor4Laboratory12Dietary kitchen10---

Engines
-------

[](#engines)

The calculation is implemented in seven languages. Each exposes `/calculate` (POST) and `/health` (GET) REST endpoints:

LanguageDirectoryPackagePython (FastAPI)`engines/python/``healthcare-voc-compliance` on PyPIRust`engines/rust/``healthcare-voc-engine` on Crates.ioJava`engines/java/``io.github.davecookvectorlabs:healthcare-voc-engine` on Maven CentralRuby (Sinatra)`engines/ruby/``healthcare_voc_compliance` on RubyGemsElixir (Plug)`engines/elixir/``healthcare_voc` on Hex.pmPHP`engines/php/``davecook/healthcare-voc-compliance` on PackagistGo (net/http)`engines/go/``github.com/DaveCookVectorLabs/healthcare-voc-compliance` on pkg.go.dev### Quick Start (Python)

[](#quick-start-python)

```
pip install healthcare-voc-compliance
# or run from source:
cd engines/python
pip install -r requirements.txt
python engine.py          # CLI mode — runs sample calculation
python engine.py --serve  # HTTP server on port 8001
```

### API Example

[](#api-example)

```
curl -X POST http://localhost:8001/calculate \
  -H "Content-Type: application/json" \
  -d '{
    "room_sqft": 200,
    "ceiling_height_ft": 9,
    "product_voc_g_per_L": 8.0,
    "dilution_ratio": 0.015625,
    "coverage_sqft_per_L": 400,
    "air_changes_per_hour": 6,
    "cleaning_frequency_per_year": 365,
    "product_category": "General Purpose Cleaner",
    "space_type": "patient_room"
  }'
```

---

Regulatory Sources
------------------

[](#regulatory-sources)

- [EPA 40 CFR Part 59 Subpart C](https://www.ecfr.gov/current/title-40/chapter-I/subchapter-C/part-59/subpart-C) — US federal VOC emission standards for consumer products
- [CARB Consumer Products Program](https://ww2.arb.ca.gov/our-work/programs/consumer-products-program/about) — California VOC limits
- [Canada SOR/2021-268](https://laws-lois.justice.gc.ca/eng/regulations/SOR-2021-268/FullText.html) — Federal VOC concentration limits
- [OSHA 29 CFR 1910.1000 Table Z-1](https://www.osha.gov/annotated-pels/table-z-1) — Permissible Exposure Limits
- [ASHRAE 62.1-2022](https://www.ashrae.org/technical-resources/bookstore/standards-62-1-62-2) — Ventilation for healthcare facilities
- [Green Seal GS-37](https://greenseal.org/standards/gs-37-cleaning-products-for-industrial-and-institutional-use/) — Institutional cleaning product standard
- [UL GREENGUARD Gold](https://www.ul.com/services/ul-greenguard-certification) — Low-emission certification for sensitive environments
- [EPA Safer Choice](https://www.epa.gov/saferchoice) — Product certification program

---

Project Structure
-----------------

[](#project-structure)

```
healthcare-voc-compliance/
├── datasets/
│   ├── generate_regulatory_limits.py     # Dataset A generator
│   ├── generate_product_matrix.py        # Dataset B generator
│   ├── voc_regulatory_limits.csv         # 650 regulatory limits
│   └── healthcare_cleaning_products_voc.csv  # 5,000 products
├── engines/
│   ├── python/engine.py                  # Python (FastAPI)
│   ├── rust/src/main.rs                  # Rust
│   ├── java/src/.../VOCCalculator.java   # Java
│   ├── ruby/lib/healthcare_voc_compliance.rb  # Ruby
│   ├── elixir/lib/healthcare_voc.ex      # Elixir
│   ├── php/src/VOCCalculator.php         # PHP
│   └── go/main.go                        # Go
├── notebooks/
│   └── voc_compliance_analysis.ipynb     # Jupyter analysis notebook
├── pdfs/
│   └── generate_pdfs.py                  # PDF white paper generator
├── docs/                                 # Sphinx documentation
└── public/                               # PHP web frontend

```

---

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

Maintained by Dave Cook — [Binx Professional Cleaning](https://www.binx.ca/commercial.php), North Bay and Sudbury, Ontario.

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance79

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

108d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dd835051bc63bd26f7ce0558ef339a45045e09d8306b7c6ca7d53a4ccd5828e0?d=identicon)[Dave Cook](/maintainers/Dave%20Cook)

---

Top Contributors

[![Binkmaster](https://avatars.githubusercontent.com/u/12659793?v=4)](https://github.com/Binkmaster "Binkmaster (11 commits)")

---

Tags

compliancehealthcarecleaningfacility-managementvocosha

### Embed Badge

![Health badge](/badges/davecook-healthcare-voc-compliance/health.svg)

```
[![Health](https://phpackages.com/badges/davecook-healthcare-voc-compliance/health.svg)](https://phpackages.com/packages/davecook-healthcare-voc-compliance)
```

###  Alternatives

[roxblnfk/unpoly

Remove unnecessary PHP polyfills

4135.8k18](/packages/roxblnfk-unpoly)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
