(DRAFT) Potential Drug-Drug Interaction (PDDI) CDS IG : Ballot for Comment 2
0.2.0 - CI Build

(DRAFT) Potential Drug-Drug Interaction (PDDI) CDS IG : Ballot for Comment 2, published by HL7 Clinical Decision Support Workgroup. This is not an authorized publication; it is the continuous build for version 0.2.0). This version is based on the current content of https://github.com/HL7/PDDI-CDS/ and changes regularly. See the Directory of published versions

Terminology defined for the PDDI CDS Implementation Guide

Value Sets

The framework for the PDDI CDS value sets has three components:

  1. Composite ValueSet
  2. Element ValueSet
  3. Element ValueSet-exclude

Delineation in the components of value sets is based on characteristics or hierarchy of the terminology and the CDS service. The CDS service typically calls individual identifiers in the Element ValueSet through the Composite ValueSet. The CDS Service MUST call an Element ValueSet in the event a Composite ValueSet is unnecessary or unavailable. This approach allows value sets to be agnostic, reusable, and amenable to automated updating.

Scope and Definitions

While the processes for creating value sets for this implementation guide are amenable to international applications, several of the value sets for the provided CDS artifacts are limited to the United States. The scope of the value set is signified in the version (e.g., US 1.0) and jurisdiction (US) elements. Service agnostic value sets (i.e., Element ValueSet) have a broad description that refrains from limiting the value set to a certain terminology. Service-specific value sets specify a terminology and query details in the description element. Depending on the type of value set, up to two definitions are available, which include:

  • Extensional Definition – Explicitly enumerating each of the value set concepts.
  • Intensional Definition – Defining an algorithm that, when executed by a machine (or interpreted by a human), yields a set of such elements.

Composite ValueSet

The Composite ValueSet is a superset that references Element ValueSets and Element ValueSets-exclude as needed for the defined CDS Service. It is signified by an upper-case name (e.g., valueset-NSAIDS). For example, non-steroidal anti-inflammatory drugs (NSAIDs) is a class of medications with several members (e.g., ibuprofen, naproxen, diclofenac). The Composite ValueSet references Element ValueSets including valueset-ibuprofen, valueset-naproxen, valueset-diclofenac etc. Composite ValueSets have an Extensional Definition for including and excluding Element ValueSets. The Composite ValueSet references Element ValueSet-exclude to refine included identifiers.

Element ValueSet

The Element ValueSets are signified by lower-case names (e.g., valueset-naproxen). Element ValueSets are unique in that the identifiers are available in the Extensional and Intensional Definitions. Element ValueSets MUST have a persistent URL for the Composite ValueSet to reference. The Extensional Definition of enumerated identifiers and names are available through ValueSet.compose.include.concept. The Intensional Definition identifiers and names are available through ValueSet.expansion.contains. The Intensional Definition is a general query to a public Terminology server, typically through an API with a RESTful query. The intent of an Element ValueSet is to contain a broad capture of identifiers at the concept or product level (e.g., naproxen and naproxen 500mg tablet). Refining these value sets occurs at the Composite ValueSet level with Element ValueSet-exclude.

RESTful API Public terminology servers are now available for several of the most recognized terminologies including: RxNorm, LOINC, and SNOMED-CT. These APIs are convenient, stable, and provide a simplistic mechanism for reproducible queries.

Element ValueSet-exclude

The Element ValueSet-excludes are signified with an identical name to the Element ValueSets but with an “-exclude” (e.g., valueset-naproxen-exclude) These value sets have an enumerated Extensional Definition only, and are a subset of the Element ValueSet. The subset criteria is defined in the description element. For example, an Element ValueSet may capture all naproxen products; however, the CDS knowledge only calls for systemic naproxen. By including an Element ValueSet-exclude that has an enumerated set of identifiers that are topical, the Composite ValueSet can provide a more precise set of identifiers that closely matched the CDS knowledge. The Composite ValueSet and Element ValueSet-exclude are CDS Service specific. In the situation where Element ValueSet-excludes are not maintained, it will only increase the sensitivity of the CDS system (i.e., error on safety).

Figure 1: ValueSet Framework
Value_sets.svg

ValueSet

  • Aldosterone Antagonists Drug Value Set
  • Nonsteroidal Anti-inflammatory Drugs Value Set
  • Proton Pump Inhibitor Drug Value Set
  • Systemic Corticosteroid Drug Value Set
  • Composite Cyclosporine Drug Value Set
  • Loop Diuretic Drug Value Set
  • Aldosterone Medications Value Set
  • Aspirin Medications Value Set
  • Betamethasone Medications Value Set
  • Exclude Betamethasone Medications Value Set
  • Bromfenac Medications Value Set
  • Exclude Bromfenac Medications Value Set
  • Bumetanide Medications Value Set
  • LOINC Codes for Serum Calcium
  • Celecoxib Medications Value Set
  • Cloprednol Medications Value Set
  • Cortisone Medications Value Set
  • Cortivazol Medications Value Set
  • Cyclosporine Medications Value Set
  • Exclude cyclosporine Medications Value Set
  • Deflazacort Medications Value Set
  • Desoxycorticosterone Medications Value Set
  • Dexamethasone Medications Value Set
  • Exclude Dexamethasone Medications Value Set
  • Dexlansoprazole Medications Value Set
  • Diclofenac Medications Value Set
  • Exclude Diclofenac Medications Value Set
  • Diflunisal Medications Value Set
  • Digoxin Medications Value Set
  • LOINC Codes for Digoxin Concentration
  • Eplerenone Medications Value Set
  • Esomeprazole Medications Value Set
  • Ethacrynate Medications Value Set
  • Etodolac Medications Value Set
  • Fenoprofen Medications Value Set
  • Fludrocortisone Medications Value Set
  • Fluocortolone Medications Value Set
  • Exclude Fluocortolone Medications Value Set
  • Flurbiprofen Medications Value Set
  • Exclude Flurbiprofen Medications Value Set
  • Furosemide Medications Value Set
  • Upper gastrointestinal bleed Value Set
  • Hydrocortisone Medications Value Set
  • Exclude Hydrocortisone Medications Value Set
  • Ibuprofen Medications Value Set
  • Exclude Ibuprofen Medications Value Set
  • Indomethacin Medications Value Set
  • Ketoprofen Medications Value Set
  • Exclude Ketoprofen Medications Value Set
  • Ketorolac Medications Value Set
  • Exclude Ketorolac Medications Value Set
  • Lansoprazole Medications Value Set
  • LOINC Codes for Serum Potassium
  • Mefenamate Medications Value Set
  • Meloxicam Medications Value Set
  • Meprednisone Medications Value Set
  • Methylprednisolone Medications Value Set
  • Exclude Methylprednisolone Medications Value Set
  • Misoprostol Medications Value Set
  • Nabumetone Medications Value Set
  • Naproxen Medications Value Set
  • Nepafenac Medications Value Set
  • Exclude Nepafenac Medications Value Set
  • Omeprazole Medications Value Set
  • Oxaprozin Medications Value Set
  • Pantoprazole Medications Value Set
  • Paramethasone Medications Value Set
  • Valueset_PDDICDS_indicator
  • Piroxicam Medications Value Set
  • Exclude Piroxicam Medications Value Set
  • LOINC Codes for Serum Potassium
  • Prednisolone Medications Value Set
  • Exclude Prednisolone Medications Value Set
  • Prednisone Medications Value Set
  • Prednylidene Medications Value Set
  • Rabeprazole Medications Value Set
  • LOINC Codes for Renal Function
  • Rimexolone Medications Value Set
  • Exclude Rimexolone Medications Value Set
  • Spironolactone Medications Value Set
  • Sulindac Medications Value Set
  • Tolmetin Medications Value Set
  • Topical Diclofenac Medications Value Set
  • Torsemide Medications Value Set
  • Triamcinolone Medications Value Set
  • Exclude Triamcinolone Medications Value Set
  • Trilostane Medications Value Set
  • Warfarin Medications Value Set
  • Code Systems

  • Codesystem_PDDICDS_indicator