CM Editor Primer

Introduction

Getting Started

Creating a View

 

Introduction

About

This tutorial is a supplement to the Guidelines document, utilising existing models to provide a step-by-step demonstration on how to design basic views for different types of clinical decision support (CDS) applications using the Clinical Model Editor.

Before starting the modelling process, it is of vital importance to understand that the model of a clinical concept must be constructed based upon a solid scientific basis. It is therefore essential to thoroughly review the available scientific literature prior to commencing the construction of the archetype to minimise the potential risk of errors. Once the model has been published, users should be able to quickly access the scientific material upon which the model is based upon; always make sure to list the references.

Resources containing more in-depth information about the archetype definition language (ADL) are listed at the end of the document for quick access in case they are needed. There is also a link to our CDS Apps Overview page on GitHub available in this section, containing over 100 demo applications (using 250+ archetypes and 200+ guidelines).

The document has been written by the Clinical Modelling Group at Cambio Healthcare Systems. If you have any questions regarding the modelling process or if you want to provide us with feedback – please send us an e-mail at models@cambiocds.com.

All the best,
Clinical Modelling Group

Contributors
Eneimi Allwell-Brown
Jimmy Axelsson
Syeeda S. Farruque
Dennis Forslund

 

Getting Started

Views are visual components designed to display the results of executed guidelines in real time, and can be interactive based on the use case. This tutorial will build on the previous ones in the series and displays the final steps of the process on how to create a fully functioning, web-based Clinical Decision Support application using the Apgar score model as an example.

Download the Clinical Model Editor

In order to create a view, the Clinical Model Editor needs to be installed. This is the software used to facilitate the authoring and development of views.

The Clinical Model Editor is available for download at: http://bit.ly/2pHXkYG

Extract the files and then simply open the executable jar file named cds-cm-editor.

Preparation

Add a copy of the created Apgar score guideline to the guidelines subfolder in the cds-cm-editor-1.0.8 folder.

Creating a View

Start-up Menu

When launching the Clinical Model Editor, a blank screen will be displayed. Simply follow the instructions below in order to get started.

  1. Click on File.
  2. Choose Create new view from the Create clinical model submenu.

Definition

In accordance with the previous guides on the construction of the Apgar score model, the usable application will be based on the execution of one sole guideline for the calculation of a total score. This is submitted under the Definition tab.

  1. In the Execution guidelines section, click on Modify selected guidelines.
  2. Select the Apgar score guideline.
  3. Click on Accept.

Metadata

To add metadata, proceed on to the Description tab.

  1. Name the view.
  2. Enter the author details including organisation and date of creation.
  3. Select Author draft from the Authorship lifecycle drop-down menu, and enter the copyright if relevant.
  4. Use the + to add and – to remove keywords. The pencil icon can be used to edit existing keywords.
  5. Enter the name of any contributors.

Next, enter text into the 1. Description, 2. Purpose, 3. Use, 4. Misuse and 5. References sections:

Once all the metadata is filled in, ensure the model is saved.

Cosmic Knowledge Manager

All the building blocks required to constitute the foundation of a web-based Clinical Decision Support application have now been created. The final step is to upload all models to the Cosmic Knowledge Manager in order to display it in the form of a generated view; detailed information on this is provided in the KM Upload Guide, which can be downloaded from the same source as this tutorial.