minimal Common Oncology Data Elements (mCODE) Implementation Guide
2.1.0 - Pre-STU 3 Development United States of America flag

minimal Common Oncology Data Elements (mCODE) Implementation Guide, published by HL7 International Clinical Interoperability Council. This is not an authorized publication; it is the continuous build for version 2.1.0). This version is based on the current content of https://github.com/HL7/fhir-mCODE-ig/ and changes regularly. See the Directory of published versions

Home

Official URL: http://hl7.org/fhir/us/mcode/ImplementationGuide/hl7.fhir.us.mcode Version: 2.1.0
Draft as of 2022-11-30 Computable Name: MinimalCommonOncologyDataElements

Background

Cancer is among the leading causes of death worldwide. According to the National Cancer Institute, in the United States, 39.5 percent of men and women will be diagnosed with cancer at some point during their lifetimes. In 2020, an estimated 1,806,590 new cases of cancer will be diagnosed in the United States and 606,520 people will die from the disease. While these numbers are staggering, the silver lining in the wide prevalence of cancer is the potential to learn from treatment of millions of patients. If we had research-quality data from all cancer patients, it would enable better health outcomes. Today, we lack the data models, technologies, and methods to capture that data.

mCODE™ (short for Minimal Common Oncology Data Elements) is an initiative intended to assemble a core set of structured data elements for oncology electronic health records (EHRs). mCODE is a step towards capturing research-quality data from the treatment of all cancer patients. This would enable the treatment of every cancer patient to contribute to comparative effectiveness analysis (CEA) of cancer treatments by allowing for easier methods of data exchange between health systems.

Overview

mCODE consists of approximately 30 FHIR profiles organized into six thematic groups. Groups are introduced for pedagogical purposes only and have no other meaning or consequence.

The overall scope of mCODE and the relationships between mCODE profiles is illustrated in the following diagram (not all details are shown). Click on items to see their underlying definitions.


Readers should also take note of the Data Dictionary, a flattened list of data elements in mCODE in Microsoft Excel format. There is also a Data Dictionary Differential that compares STU 2 with STU 1 on an element-by-element basis.

The Data Dictionary comes with several caveats:

  • Only must-support (MS) data elements are included. These are elements that implementers could be expected to provide meaningful support for (see Profile Conformance for details).
  • Profiles defined externally to mCODE, such as vital signs defined in base FHIR or US Core, are not included.
  • Sub-elements of complex types such as CodeableConcept and Period are not explicitly included.

The actual number of data elements in a resource can vary widely. For example, there are 16 MS data elements in the CancerPatient profile, but the full resource defines more than 60 elements. Of these, only four are required (namely identifier.system, identifier.value, name.family or name.given, and gender). Moreover, different systems can implement different subsets of profiles, depending on their role in information workflows (see Profile Conformance for details). Not every mCODE-compliant system will support the same set of data elements.

Development History

In late 2018, American Society of Clinical Oncology (ASCO®), with the assistance of MITRE Corporation, convened a committee of twenty leading clinical experts in oncology, radiology, surgery, and public health. This group developed two use cases that drove the initial clinical data requirements for mCODE:

After the initial analysis, an open survey was conducted to validate and prioritize the data elements from these use cases. Down-scoping was conducted based on the likelihood the data elements would be found in current EHRs, and if collecting the data would place undue burden on clinicians. In 2019, mCODE was balloted and approved as an HL7 Standard for Trial Use (STU 1).

In the ensuing period, mCODE was piloted at a number of clinical sites, facilitated by the CodeX FHIR Accelerator. Use cases are tracked here. Incorporating that experience, the second trial use publication (STU 2) was balloted in May 2021, and published in January 2022.

Sources

In addition to information obtained from subject matter experts, several existing standards, nomenclatures, and guidelines were consulted during the development of this specification. These include:

In addition, material was drawn from the US Core Implementation Guide and the Genomics Reporting Implementation Guide.

Understanding this Guide

mCODE is a “Domain of Knowledge” implementation guide (IG). The purpose is to show how to represent clinical concepts generally, not to have a complete set of agreements for interoperable exchanges.

The page layouts and symbols are explained in the FHIR documentation. In viewing a profile page, note that there are multiple views. The “Differential Table” view represents the difference between the current profile and its base resource or profile. When interpreting this view, bear in mind that the immediate parent may not be a base FHIR resource, but could be a US Core profile or another profile in this guide. The “Snapshot Table” represents the entire profile, with all elements.

In the event there are differences between the page renderings in this IG and the associated FHIR artifacts, the FHIR artifacts should be taken as the source of truth. In the event that an artifact’s snapshot is inconsistent with its differential, the differential should be taken as the source of truth.

Credits

The authors gratefully acknowledge the leadership of Dr. Monica Bertagnolli, former ASCO President, and Dr. Jay Schnitzer, MITRE Chief Technology and Chief Medical Officer. The ASCO/CancerLinQ team was led by Dr. Robert Miller. Dr. Travis Osterman of Vanderbilt University leads the mCODE Technical Review Group. Dr. Charles Mayo of University of Michigan, Randi Kudner of ASTRO, and Martin von Siebenthal of Varian made significant contributions to the much improved radiotherapy portion of this IG. Wendy J. Blumenthal and Wendy Sharber of CDC provided essential input helping align mCODE with cancer registry reporting requirements.

The authors recognize HL7 sponsorship and input from Clinical Interoperability Council, with special thanks to Laura Heermann Langford, Russell Leftwich, and Lindsey Hoggle. The HL7 Clinical Genomics Work Group has been a consistent and constructive partner during this project. Lloyd McKenzie and Grahame Grieve contributed to mCODE in countless ways with their outstanding energy and dedication.

Andre Quina and Nichole Ng guide the overall mCODE effort at MITRE. Key MITRE contributors include Mark Kramer, May Terry, Max Masnick, Saul Kravitz, Su Chen, Rute Martins, Chris Moesel, Caroline Potteiger, Anthony DiDonato, and Sharon Sebastian. Steve Bratt leads the CodeX FHIR Accelerator, a member-driven community accelerating implementation around mCODE standard. Capability statements were rendered with tools developed by Eric Haas and modified by Corey Spears. Max Masnick wrote the Data Dictionary generator. The raw FSH annotation of the examples was generated by Saul Kravitz using GoFSH and this script.

Contact Information

If you have questions or comments about this guide, you can join the conversation on chat.fhir.org, create an issue in the HL7 Jira, or reach out to any of the following individuals:

Topic Who Role Email
Implementation and Use Cases Steve Bratt CodeX Accelerator Program Manager sbratt@mitre.org
Oncology Domain Content Dr. Travis Osterman Chair, mCODE Technical Review Group travis.osterman@vumc.org
Modeling and FHIR IG issues Mark Kramer Modeling Lead mkramer@mitre.org

mCODE is an open source project and welcomes all contributors. The source code for this IG is maintained in the HL7 Github. All of the profiling work is done using FHIR Shorthand and SUSHI.

MITRE: Approved for Public Release. Distribution Unlimited. Case Number 16-1988