CM Editor Primer
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 firstname.lastname@example.org.
All the best,
Clinical Modeling Group
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.
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.
Add a copy of the created Apgar score guideline to the guidelines subfolder in the cds-cm-editor-1.0.8 folder.
When launching the Clinical Model Editor, a blank screen will be displayed. Simply follow the instructions below in order to get started.
- Click on File.
- Choose Create new view from the Create clinical model submenu.
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.
- In the Execution guidelines section, click on Modify selected guidelines.
- Select the Apgar score guideline.
- Click on Accept.
To add metadata, proceed on to the Description tab.
- Name the view.
- Enter the author details including organisation and date of creation.
- Select Author draft from the Authorship lifecycle drop-down menu, and enter the copyright if relevant.
- Use the + to add and – to remove keywords. The pencil icon can be used to edit existing keywords.
- 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.
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.
The 20 latest Blog Posts
- Aulia Zahrina, finalist of the CDS App Challenge 2018
- Göteborg 2019-02-21
- Linköping 2019-09-19
- Pulmonary Embolism Imaging Referral (ENG)
- Colonoscopy Alert (ENG)
- Coeliac Disease Alert (ENG)
- High Risk Medication Avoidance (ENG)
- Acute Kidney Injury (ENG)
- Chronic Pain Management (ENG)
- Medicines Review (ENG)
- Nursing Support (ENG)
- Individuella vårdplaner för kroniskt sjuka patienter (SWE)
- Pharros (SWE)
- Akut skalltrauma (SWE)
- Vårdskadeprevention – Munhälsa (SWE)
- SVF Prostate Cancer Referral (SWE)
- C3-cloud personalized care plans and decision support for patients with multiple chronic conditions (type-2 diabetes, heart failure, depression, kidney failure). It’s developed for EU research project, and we want the KGC to order it properly.
- Pharros, Clinical Pharmacology Test Result Interpretation (ENG)
- Acute Head Injury App
- SVF Prostate Cancer Referral App (ENG)
- (Archived) CDS Summer App Challenge 2017
- (Archived) CDS Summer App Challenge 2018
- (Archived) Clinical Decision Support
- (Archived) Guides and Tutorials
- About us
- Archetype Editor Primer
- Assessment criteria
- CDS App Challenge
- CDS App Challenge IPR
- CDS Community
- CDS Road Show
- CDS Summer App Challenge 2017
- CDS Summer App Challenge 2018
- Clinical Decision Support
- GDPR and Intellectual Property
- Guides and Tutorials
- How to
- Open standards and open source
- Social media posts
- What is CDS?
- What’s in it for me?
- Archetype Tutorial I
- Archetype Tutorial II
- GDL Editor Primer
- Guideline Tutorial I
- Guideline Tutorial II
- Clinical Models Download Guide
- Knowledge Manager Primer
- CM Editor Primer