Download the PHP package davecook/home-care-cost-model without Composer
On this page you can find all versions of the php package davecook/home-care-cost-model. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download davecook/home-care-cost-model
More information about davecook/home-care-cost-model
Files in davecook/home-care-cost-model
Package home-care-cost-model
Short Description A reference cost model for Canadian home care service-mix decisions (PSW, housekeeping, nursing) with 2026 tax relief stack and per-province subsidy eligibility.
License MIT
Homepage https://github.com/DaveCookVectorLabs/home-care-cost-model
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package home-care-cost-model
Home Care Cost Model
A reference cost model and open dataset collection for home care decisions in Canada. The model quantifies the trade-off families face when combining Personal Support Worker (PSW) hours, housekeeping services, nursing care, and informal caregiving for an older adult or person with a disability remaining at home. It spans all ten provinces and three territories, incorporates 2026 tax relief parameters (Medical Expense Tax Credit, Disability Tax Credit, Canada Caregiver Credit, Veterans Independence Program), and emits explicit scope of practice warnings when inputs imply a service substitution that is not legally permissible.
Plain-language summary
Families across Canada routinely face a choice between hiring a Personal Support Worker (PSW) and hiring a cleaner or housekeeper when a parent or spouse begins to need help at home. The two roles are not interchangeable. A PSW is trained and authorised to provide personal care — bathing, toileting, transfers, feeding, medication reminders, and (in some provinces and under delegation) basic wound and ostomy care. A housekeeper or cleaning service is authorised to clean. Asking a cleaner to help with personal care is outside their scope of practice and, in several provinces, outside the scope of their insurance.
This repository publishes a parametric model that takes a recipient's activities-of-daily-living (ADL) and instrumental-activities-of-daily-living (IADL) scores, their province, a short description of their household and diagnosis, and returns a service mix (PSW hours, housekeeping hours, nursing hours), a monthly private-pay cost, the hours covered by the applicable provincial subsidised program, and the federal and provincial tax credits that typically apply. It also flags, in writing, any combination of inputs where cleaning services cannot legally substitute for personal support.
The model is not clinical advice. It is a reference framework for comparing options before a formal care assessment. All data sources are government or peer-reviewed. All code is open source under MIT. All data is published under CC BY 4.0.
What This Does
Given an older adult or disability-care recipient's functional assessment and jurisdiction, the model computes:
- Recommended weekly service hours across three categories (personal support, housekeeping, skilled nursing), derived from Katz ADL and Lawton IADL scores with diagnosis- and cognition-aware adjustments.
- Scope of practice warnings when the combination of inputs implies a legally-impermissible substitution (e.g. housekeeping for a recipient whose ADL score indicates need for bathing or transfer assistance).
- Private-pay monthly cost using per-province rate bands derived from Statistics Canada wage tables and Canadian Home Care Association agency markup ranges.
- Subsidised hours allocation for the recipient's province, following publicly-documented eligibility rules (Ontario HCCSS, BC Health Authority home care, Alberta Continuing Care at Home, Quebec CLSC Soutien à domicile, Saskatchewan Health Authority, Manitoba Home Care, Atlantic provinces, Territories).
- Federal and provincial tax credit stack — Medical Expense Tax Credit (METC), Disability Tax Credit (DTC), Canada Caregiver Credit (CCC), Veterans Affairs Canada VIP, and Indigenous Services Canada FNIHB Home and Community Care Program flags.
- Out-of-pocket cost after credits, monthly and annualised.
- Hybrid-versus-all-PSW comparison, showing how much a family saves by using a cleaning service for housekeeping hours rather than paying a PSW rate for those same hours.
- Employment-law warnings when private-hire arrangements exceed a threshold that triggers CRA employer obligations (CPP, EI, provincial WSIB, T4 filing).
- Data source citations linking every output field to the Sources manifest row that supplied its constants.
Every response includes a disclaimer field: "Reference model only. Not
clinical or financial advice; consult a regulated health professional or
registered tax practitioner for individual decisions."
Datasets
Three classes of data ship with this repository. All live under datasets/.
Class 1 — Sources (raw, verbatim, credited)
Fetched by datasets/pull_sources.py from authoritative portals and stored
under datasets/sources/<organisation>/<filename> with a sibling
<filename>.source.json that records upstream URL, retrieval timestamp,
license, and SHA256. A human-readable manifest is at
datasets/SOURCES.md. No Source file is ever edited after download.
Upstream organisations represented in Sources: Statistics Canada (wage, population, CPI tables), Canadian Institute for Health Information (home care indicators), Canada Revenue Agency (tax folios), Veterans Affairs Canada (VIP rate schedule), Indigenous Services Canada (FNIHB Home and Community Care), Canadian Home Care Association, the Ontario Ministry of Health (HCCSS), and the equivalent provincial and territorial ministries.
Class 2 — Reference tables (hand-curated, deterministic)
| File | Rows | Description |
|---|---|---|
home_care_services_canada.csv |
~112 | Scope-of-practice and rate bands for 8 service categories across 13 Canadian jurisdictions, plus federal/cross-jurisdiction rows for VAC VIP and ISC FNIHB. Every row cites a source_url. |
home_care_tax_parameters_2026.csv |
~40 | Tax-year 2026 parameters for METC, DTC, CCC, VAC VIP, and provincial disability supplements. Every row cites a CRA folio or equivalent. |
home_care_subsidy_programs.csv |
~25 | Provincial and territorial subsidised home care programs: administering body, eligibility rules, typical hours awarded, wait time, URL, retrieval date. |
Class 3 — Derived scenarios (engine-generated)
These are the analysis-ready tables published to Hugging Face, Kaggle,
Zenodo, Dryad, and Mendeley Data. Every row is produced by calling
engines/python/engine.py with a specific input grid.
| File | Rows | Description |
|---|---|---|
home_care_scenarios.csv |
5,000 | Synthetic household scenarios with population-weighted province sampling, joint-distribution diagnosis/cognition/mobility sampling calibrated to CIHI home care indicators, and per-scenario engine outputs. Deterministic with random.seed(42). |
home_care_per_province_rate_bands.csv |
~650 | Product of the reference scope table × Statistics Canada CPI-adjusted wage data for 2019–2026, yielding implied private-pay and agency-billed rate ranges per (province, service, year). |
home_care_cost_model_archetypes.csv |
~2,500 | Engine outputs for a grid of canonical household archetypes: every (province × ADL × IADL × cognitive × mobility) combination at constant household composition and income. The lookup-table form of the calculator. |
home_care_tax_relief_sensitivity.csv |
~3,500 | Sensitivity grid: ~700 base scenarios × 5 net-income bands ($25k, $50k, $75k, $100k, $150k). Shows how tax-credit value shifts across the income distribution. |
home_care_subsidy_gap.csv |
~390 | 13 jurisdictions × 30 representative scenarios. Reports subsidised hours awarded vs. model-recommended hours vs. monthly dollar gap, exposing cross-province variation in home care program generosity. |
All derived datasets are labelled "Synthetic. Generated from seed 42. Not survey data." in their header comments and dataset cards.
Calculation Model
The reference implementation is engines/python/engine.py. Six additional
language ports implement identical logic; cross-language parity is verified
on three case studies from the PDF working paper.
Engines
Seven language implementations. Each exposes POST /calculate and
GET /health and loads the reference CSVs at startup.
| Language | Directory | Package |
|---|---|---|
| Python (FastAPI) | engines/python/ |
home-care-cost-model on PyPI |
| Rust (axum) | engines/rust/ |
home-care-cost-model-engine on Crates.io |
| Java | engines/java/ |
io.github.davecookvectorlabs:home-care-cost-model-engine on Maven Central |
| Ruby (Sinatra) | engines/ruby/ |
home_care_cost_model on RubyGems |
| Elixir (Plug) | engines/elixir/ |
home_care_cost_model on Hex.pm |
| PHP | engines/php/ |
davecook/home-care-cost-model on Packagist |
| Go (net/http) | engines/go/ |
github.com/DaveCookVectorLabs/home-care-cost-model on pkg.go.dev |
Quick Start (Python)
API Example
Data Sources
Primary government and peer-reviewed sources referenced by the reference
tables and cited in every derived dataset row via source_id:
- Statistics Canada — wage and employment tables (NOC 44101 Home support workers; NOC 33102 Nurse aides, orderlies and patient service associates); population estimates by age and sex; health services CPI. https://www.statcan.gc.ca
- Canadian Institute for Health Information — Home Care Reporting System public indicators; Your Health System home care volume and wait time tables. https://www.cihi.ca
- Canada Revenue Agency — Income Tax Folio S1-F1-C1 (Medical Expense Tax Credit); S1-F1-C2 (Disability Tax Credit); Canada Caregiver Credit guidance. https://www.canada.ca/en/revenue-agency.html
- Veterans Affairs Canada — Veterans Independence Program rate schedule. https://www.veterans.gc.ca
- Indigenous Services Canada — First Nations and Inuit Home and Community Care Program. https://www.sac-isc.gc.ca
- Ontario Ministry of Health — Home and Community Care Support Services program pages. https://www.ontario.ca/page/homecare-seniors
- Government of British Columbia — Home and Community Care policy manual. https://www2.gov.bc.ca
- Alberta Health Services — Continuing Care at Home. https://www.albertahealthservices.ca
- Gouvernement du Québec — CLSC Soutien à domicile. https://www.quebec.ca
- Provincial ministry pages for Saskatchewan, Manitoba, New Brunswick, Nova Scotia, Prince Edward Island, Newfoundland and Labrador, Yukon, Northwest Territories, and Nunavut home care programs.
- Canadian Home Care Association — High-Value Home Care report series. https://cdnhomecare.ca
- Katz S, Ford AB, Moskowitz RW, Jackson BA, Jaffe MW. Studies of Illness in the Aged. The Index of ADL: A Standardized Measure of Biological and Psychosocial Function. JAMA. 1963.
- Lawton MP, Brody EM. Assessment of older people: self-maintaining and instrumental activities of daily living. The Gerontologist. 1969.
Full provenance is recorded in datasets/SOURCES.md, and every source_url
cell in home_care_services_canada.csv points at a specific page within
these portals.
Project Structure
License
MIT License for code. CC BY 4.0 for datasets and the PDF working paper. See
LICENSE for the MIT text; the CC BY 4.0 attribution is specified
in datasets/README.md and on the PDF cover page.
Maintained by Dave Cook — Binx Professional Cleaning, North Bay and Sudbury, Ontario.
