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.
This repository contains the mCODE Implementation Guide (IG). An IG is "a set of rules about how FHIR resources are used (or should be used) to solve a particular problem, with associated documentation to support and clarify the usage" (source).
For more information, see:
- mcodeinitiative.org, the project homepage
- Published version of this IG
- Continuous integration build of this repository: main branch or all branches
- The mCODE Knowledge Base
- If you are new to the FHIR community and ecosystem, this tutorial explains FHIR, profiling, and implementation guides
"Building" the IG means generating a web-based, human-readable representation of the structured information and accompanying documentation defined within this repository. This is done via the FHIR Implementation Guide Publisher ("IG Publisher"), a Java program provided by the FHIR team for building IGs into a standardized presentation. You can see the output of building the current contents of this repository here.
If you would like to generate this locally, open command prompt window and navigate to the directory where this repository has been cloned. Then run this command:
- Linux/macOS:
./_genonce.sh
- Windows:
_genonce
This script will do two things automatically for you:
-
Run SUSHI. mCODE is developed in FHIR Shorthand (FSH), a domain-specific language (DSL) for defining the content of FHIR IGs. SUSHI complies FHS files into the JSON files expected by the IG Publisher.
-
Run the IG Publisher.
You will need an active internet connection to build the IG. It make take up to 30 minutes to build for the first time; subsequent builds should be faster (5-7 minutes) on a modern laptop.
When the build finishes, you can open output/index.html
in your browser to see the locally built IG.
- You will need to install SUSHI before building the IG.
- You will also need to run
./_updatePublisher.sh
(Linux/macOS) or_updatePublisher.bat
(Windows) to download the IG Publisher.
If you want to run SUSHI without building the entire IG, you can run sushi .
in a command prompt window after navigating to the directory where this repository has been cloned.
You can also run the IG Publisher without running SUSHI with ./_genonce.sh -no-sushi
or _genonce -no-sushi
.
While not normally necessary, you can delete the following folders to get a clean build:
fsh-generated/
(SUSHI output)output/
(IG Publisher output)input-cache/
(IG Publisher local cache; note that deleting this will dramatically increase the length of the next build)
-
The FHIR Shorthand (
.fsh
) files defining the resources in this IG are found ininput/fsh/
.-
There is a FSH syntax highlighting extension for VSCode. The mCODE team generally uses this set of tools for working on FSH files.
-
The FSH files are prefixed based on what is contained inside.
Prefix Description AL
Aliases DEF
Other Definitions EX
Examples SD
StructureDefinitions VS
ValueSets
-
-
The main pages in the built IG are generated from Markdown found in
input/pagecontent/
. These pages must also be included insushi-config.yaml
to be compiled to HTML by the IG Publisher. -
There are a number of other important configuration options in
sushi-config.yaml
including the menu contents of the built IG and the groupings on the Artifacts Summary page. -
The source for the UML diagrams in the IG are found in
input/images-source/
and SHALL have a.plantuml
extension. These are automatically converted to SVG by the IG Publisher, and are inserted inline into Markdown files using{%include some-diagram.svg%}
(which corresponds toinput/images-source/some-diagram.plantuml
).
See contributing.md
.