This page is part of the HL7 FHIR Implementation Guide: minimal Common Oncology Data Elements (mCODE) Release 1 - US Realm | STU1 (v3.0.0-ballot: STU 3 Ballot 1) based on FHIR R4. The current version which supercedes this version is 2.1.0. For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org/fhir/us/mcode/ImplementationGuide/hl7.fhir.us.mcode | Version: 3.0.0-ballot | |||
Draft as of 2023-03-28 | Computable Name: MinimalCommonOncologyDataElements |
Voters familiar with mCODE can focus their attention on the changes since STU 2, listed in the Release Notes.
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.
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.
mCODE is an extensible standard, open to increased scope (horizontal extensibility) and to more specific subcases (vertical extensibility):
mCODE is horizontally extensible in the sense that information not specifically covered by an mCODE profile is not excluded. For example, there is no specific profile for care teams in mCODE, but sharing care team information is essential in some workflows. In such cases, the user should express this information using an appropriate FHIR resources and/or profiles. Users will need to exercise judgment regarding the best choice of profiles.
mCODE is vertically extensible in the sense that more specific profiles can be derived from mCODE. For example, a user could create a profile for a specific type of procedure, such as a reconstructive procedure, using the mCODE procedure profile as a parent. It is expected that mCODE will serve as the basis for future implementation guides dealing with new use cases, particular types of cancer, or specific demographic groups.
To be perfectly clear, if mCODE does not have a profile for some type of data, it CAN be included with mCODE data using an appropriate resource or profile.
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 3 with STU 2 on an element-by-element basis.
The Data Dictionary comes with several caveats:
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). Therefore, not every mCODE-compliant system will support the same set of data elements. However, whatever portion of this specification is implemented will be compatible with other systems, inasmuch as the implementations overlap.
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. A non-balloted update containing terminology updates, version 2.1, was published in March 2023.
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.
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.
The authors gratefully acknowledge the leadership of Dr. Monica Bertagnolli, former ASCO President (currently NCI Director) 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 CodeX Executive Committee. Dr. Sanjay Aneja 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 James McClay. 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. Su Chen 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.
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 | |
---|---|---|---|
Implementation and Use Cases | Dr. Su Chen | CodeX Accelerator Program Manager | suchen@mitre.org |
CodeX Leadership | Dr. Travis Osterman | Chair, CodeX Executive Committee | travis.osterman@vumc.org |
Oncology Domain Content | Dr. Sanjay Aneja | Chair, mCODE Technical Review Group | sanjay.aneja@yale.edu |
Modeling and FHIR IG | 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