CDC MME CQL Calculator
3.0.0 - release

This page is part of the CDC Opioid MME Calculator (v3.0.0: Release) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide

MMEMedicationRequest

Defines the minimum expectations for a MedicationRequest that can be used to successfully calculate Morphine Milligram Equivalent (MME)/day according to the CDC Opioid Prescribing guideline

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide

CDC MME Clinical Conversion Factors

This Code System Supplement defines clinical conversion factors for calculating Morphine Milligram Equivalence (MME), as described in the CDC Opioid Prescribing Guideline. The supplement defines conversions factors for ingredients in one of 3 ways: 1, as a direct conversion factor for the ingredient, 2, as a dose-form-specific conversion factor for the ingredient, and 3, as a dose-quantity-ranged conversion factor for the ingredient. See the descriptions for each property for information on how the values are represented for the different conversion factors. For a given ingredient, only one of ‘dose-form’ or ‘dose-range’ will be present, with or without an ingredient-specific conversion factor. The properties together will enable a unique conversion factor to be determined if the input is within the expected range. If the input is outside the expected range, and there is no ingredient-specific conversion-factor specified, implementations should indicate a conversion factor could not be determined from the supplied information. All conversion factors supplied in this supplement are in ‘mg/d’.

CDC MME Usage Context Codes

This Code System defines usage context codes used to configure the MME Conversion Factors Code System Supplement. If there is a single CodeSystem supplement to the RxNorm code system with a usage context of task and a code of ‘mme-calculation’, it will be used as the conversion factors for the calculator. See the Conversion Factors documentation for a description of the Code System supplements that can carry this configuration.

Example CDC MME Clinical Conversion Factors

Example Code System to support Testing (Copy of ClinicalConversion Factors). This Code System Supplement is a copy of the CDC Clinical Conversion Factors code system supplement to support testing. See the original CDC Clinical Conversion Factors code system supplement for documentation of the code system supplement properties.

Knowledge Artifacts: Libraries

These define logic, asset collections and other libraries as part of content in this implementation guide

Morphine Milligram Equivalent (MME) Conversion Factors for FHIR R4

This library contains logic to expose configurable conversion factors for the MME calculation functionality provided by the OMTKLogic library.

Tests for the Morphine Milligram Equivalent (MME) Conversion Factors for FHIR R4

This library contains logic to test configurable conversion factors for the MME calculation functionality provided by the OMTKLogic library.

Morphine Milligram Equivalent (MME) Calculator for FHIR R4

This library contains logic to surface the MME calculation functionality provided by the OMTKLogic library by extracting appropriate information from FHIR R4 MedicationRequest resource.

Tests for the Morphine Milligram Equivalent (MME) Calculator for FHIR R4

This library contains tests to validate the functionality of the FHIR R4 MME calculator

Opioid Management Terminology Knowledge Data

This library contains drug ingredient data for opioid ingredients of combinations drugs as determined using the RxNav API. The content was produced using the process described here.

Tests for the Opioid Management Terminology Knowledge Data Library

This library contains tests of the OMTKData library

Opioid Management Terminology Knowledge Logic

This library provides functionality for calculating Morphine Milligram Equivalents (MME) for opioid medications, as described in the CDC Opioid Prescribing Guideline.

Tests of the Opioid Management Terminology Knowledge Logic library

This library tests the MME calculator provided by the OMTKLogic library

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like

Conversion Factors Clinical Tests - Patient

Test patient for the Conversion Factors Clinical Tests

Conversion Factors Tests - Patient

Test patient for the Conversion Factors Tests

MME Calculator Tests - Greater than Fifty - MedicationRequest

Test MedicationRequest for the Greater than Fifty test case of the MME Calculator

MME Calculator Tests - Greater than Fifty - GuidanceResponse

Expected GuidanceResponse result for the Greater than Fifty test case of the MME Calculator

MME Calculator Tests - Greater than Fifty - Patient

Test patient for the Greater than Fifty test case of the MME Calculator

MME Calculator Tests - Less than Fifty - MedicationRequest

Test MedicationRequest for the Less than Fifty test case of the MME Calculator

MME Calculator Tests - Less than Fifty - GuidanceResponse

Expected GuidanceResponse result for the Less than Fifty test case of the MME Calculator

MME Calculator Tests - Less than Fifty - Patient

Test patient for the Less than Fifty test case of the MME Calculator

MME Calculator Tests - With Time of Day - MedicationRequest

Test MedicationRequest for the With Time of Day test case of the MME Calculator

MME Calculator Tests - With Time of Day - GuidanceResponse

Expected GuidanceResponse result for the With Time of Day test case of the MME Calculator

MME Calculator Tests - With Time of Day - Patient

Test patient for the With Time of Day test case of the MME Calculator

MME Calculator Tests - No Meds - Patient

Test patient for the No Meds test case of the MME Calculator