https://github.com/jacobious52/opioidcalc
https://github.com/jacobious52/opioidcalc
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jacobious52/opioidcalc
- Owner: Jacobious52
- Created: 2025-06-22T03:22:21.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-08-26T12:30:00.000Z (9 months ago)
- Last Synced: 2025-08-26T16:40:20.710Z (9 months ago)
- Language: HTML
- Homepage: https://jacobious52.github.io/opioidcalc/
- Size: 312 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Opioid Conversion Calculator
A client-side web tool to calculate equianalgesic doses for various opioid medications. This application runs entirely in the browser and provides a user-friendly interface for healthcare professionals to perform safe and accurate opioid conversions.
## Features
- **Static & Serverless**: Runs entirely in the browser. No backend required, ensuring privacy and offline availability.
- **Multiple Opioids**: Calculate the total Oral Morphine Equivalent (OME) from multiple current opioid medications.
- **Dose Reduction**: Applies a 25% dose reduction when switching between opioids (50% for elderly or frail patients) to ensure safety.
- **Convenient Dosing**: Rounds the final calculated dose to the nearest available dosage form.
- **Detailed Breakdown**: Shows a step-by-step breakdown of the entire calculation process.
- **Important Clinical Notes**: Provides relevant clinical warnings and considerations for certain opioids like Methadone and Fentanyl.
## Tech Stack
- **Frontend**: Vanilla JavaScript, HTML, CSS
- **Styling**: Bootstrap 5
## Usage
To use the calculator, simply open the `index.html` file in any modern web browser.
Alternatively, you can host the entire folder on a static web hosting service like GitHub Pages or Netlify.
```bash
uv run pytest
```
## Important Note on Conversion Factors
The equianalgesic conversion factors are defined in `assets/script.js`. These values drive the calculations and should be reviewed and verified against your institution's protocols or up-to-date pharmacological resources.