An example FHIR artifact library that illustrates a CPG-on-FHIR approach to knowledge engineering applied to Colorectal Cancer.
The concepts in this artifact library are extracted from the FHIR translation of the currently published Colorectal Cancer Screening electronic Clinical Quality Measure (eCQM), CMS-130. The concepts were abstracted and expressed using CPG-on-FHIR profiles and approaches, with the goal of illustrating how shareable libraries of clinical knowledge can be used in various domains including quality measurement, decision support, case-reporting, and others.
For a complete walkthrough of building, and modifying this artifact library, refer to the Walkthrough page.
TIP: To open the Walkthrough in Preview mode for easier viewing and navigation, right-click on the WALKTHROUGH.md file in the explorer pane to the left and select
Open Preview.
This walkthrough is focused on using codespaces to allow participants a completely browser-based experience. For a similar walkthrough using desktop tooling, refer to the Sample Content IG Walkthrough.
Codespaces is a feature of Github, so the first step is to sign up for a Github Account. If you already have a github account, provide your Github ID to the workshop facilitator by emailing it to [email protected].
To use codespaces, the workshop facilitator will need to add you to the Alphora github organization. Codespaces is a paid service, and Alphora is sponsoring codespace usage for the purpose of this workshop. Codespace accounts will be available one week prior to and one week after the workshop to allow participants to work through the material.
Once your github account is associated with the Alphora organization, you will be able to open the Colorectal Cancer Concepts repository in a codespace. To do this, navigate to the Colorectal Cancer Concepts repository, click on the green Code dropdown, and click on the New codespace button:
When creating a new codespace, you need to specify the size of the machine. Just accept the default setting of 4 cores, 8GB of RAM and 32GB of disk space:
This will open the codespace in your browser. While the codespace is initializing, a message will be displayed. Note that while it's loading, there is a green button at the bottom of the screen that allows you to Open this codespace in VS Code desktop. This option requires additional setup to run locally, so don't choose that unless you're sure you have all the prerequisites installed; just allow the codespace to continue initializing:
The first time you build a codespace, this process can take quite a bit of time, so be sure to give it adequate time to complete. This is also a step that can be taken prior to the workshop so you're ready to go.
Once the codespace setup is complete, you will be presented with a codespace view of the environment:
This environment has everything you need to author, validate, build, test, and package FHIR- and CQL-based knowledge artifacts. To start the walkthrough, open WALKTHROUGH.md in preview and follow the instructions there.
If you have already created a codespace, it will be listed in the Codespaces tab of the Code dropdown.