opioid_conversion_calculator: Opioid Conversion Calculator (Equianalgesic Dosing)

In cliot: Clinical Indices and Outcomes Tools

Opioid Conversion Calculator (Equianalgesic Dosing)

Description

Calculates the equianalgesic dose when switching from one opioid to another. The function converts the input dose to Morphine Milligram Equivalents (MME) and then converts to the target opioid dose, applying an optional percentage reduction for incomplete cross-tolerance.

Usage

opioid_conversion_calculator(current_drug, current_route, current_dose_mg,
                             target_drug, target_route, reduction_percent = 0)

Arguments

current_drug	String. Name of the current opioid. Options: "morphine", "oxycodone", "hydrocodone", "hydromorphone", "codeine", "tramadol", "oxymorphone", "fentanyl".
current_route	String. Route of administration. Options: "po" (oral), "iv" (intravenous).
current_dose_mg	Numeric. The total dose of the current drug in milligrams. (Note: For Fentanyl IV, input must be in mg, e.g., 100 mcg = 0.1 mg).
target_drug	String. Name of the desired new opioid.
target_route	String. Route of the desired new opioid.
reduction_percent	Numeric. Percentage reduction to apply for incomplete cross-tolerance (e.g., 25 or 50). Defaults to 0.

Details

Standard Equianalgesic Ratios used (relative to 1 mg PO Morphine): Morphine PO: 1 Morphine IV: 3 Oxycodone PO: 1.5 Hydrocodone PO: 1 Hydromorphone PO: 4 Hydromorphone IV: 20 Codeine PO: 0.15 Tramadol PO: 0.1 Fentanyl IV: 300 (based on mg input)

Value

A list containing:

Morphine_Milligram_Equivalents	The unreduced MME of the input dose.
Target_Dose_Calculated	The estimated dose of the new drug after reduction.
Reduction_Applied	The percentage reduction used.

References

McPherson ML. Demystifying Opioid Conversion Calculations: A Guide for Effective Dosing. Amer Soc of Health System; 2010.

Examples

# Example 1: 30mg PO Oxycodone to PO Morphine (No reduction)
# 30 * 1.5 = 45 MME
opioid_conversion_calculator("oxycodone", "po", 30, "morphine", "po")

# Example 2: 2mg IV Hydromorphone to PO Oxycodone with 25% reduction
# 2 * 20 = 40 MME. Reduce 25% = 30 MME. 30 / 1.5 = 20 mg Oxycodone.
opioid_conversion_calculator("hydromorphone", "iv", 2, "oxycodone", "po", 25)

cliot documentation built on Dec. 1, 2025, 1:06 a.m.