Skip to content

colabobio/ebola-care-guidelines

Repository files navigation

Ebola Care Guidelines app

This app offers evidence-based guidelines for the care and management for Ebola Virus Disease (EVD) patients. It also incorporates machine learning prognostic models to calculate the severity risk of a patient at triage based on the demographics information, clinical signs and symptoms, and available laboratory results. The manuscript describing the prognostic models is available as a pre-print on bioRxiv, and the app itself can be freely installed on any Android device from Google Play Store.

The sections below provide an overview of the app's functionality, and the wiki section describes how to customize the app with new models and guidelines.

Using the app

Upon launching the Ebola Care Guidelines app, it will present a scrollable list of recommendations for the care of management of EVD patients across across different categories:

After selecting any category, another screen will open up providing more in-depth information about the selected recommendation, and specific intervention guides related to the recommendation:

Clicking on an intervention guide will direct the user to the corresponding page in either the Clinical management of patients with viral haemorrhagic fever or the Manual for the care and management of patients in Ebola Care Units/Community Care Centres describing that intervention in detail:

Entering patient information

The app can be used simply to access WHO's recommendations and intervention guides from a smartphone, but it offers the possibility of calculating a severity score of a patient at triage based on the available information (demographics, clinical features, laboratory data). This inforamtion can be entered into the app using two different methods: a default data-entry form or with a complementary CommCare app.

Using the default data-entry form

The default data-entry form is accessed by clicking on the "Enter Patient Data" button. This form comprises four tabs:

  1. Patient (basic information including demographics and physical measures)

  1. Triage (clinical signs and symptoms recorded at triage)

  1. Lab (laboratory results, PCR and malaria test)

The PCR results include not only the CT value, but the overall mean and standard deviation of the CT from the cases seen at the site, depending on the PCR assay in use. This is needed to perform "feature scaling" and normalize the CT values so they can entered into the prognostic models, which are not-site specific.

  1. Wellness (an observational wellness assessment)

There is no need to enter all the information, depending on what's available, the app will use a prognostic model to calculate a severity score for the patient. The numerical value of the score will be displayed at the top of the home screen:

Certain recommendations are be highlighted depending on which signs/symptoms are present, e.g.: oral dehydration is highlighted if the patient presents with nausea, diarrhoea , loss of appetite, haemorrhagic eyes, bloody diarrhoea, or confusion, or wellness scale is equal or higher than 4.

Using the CommCare data-entry app

CommCare is a platform to build data-collection apps. CommCare apps are defined through XML files that specifiy the forms (for example, triage) that make up a cases (for example, an incoming patients). These XML files get compiled as Android apps that can be distributed among the team tasked with a particular data-collection campaign. CommCare apps first store the data locally on the device and then upload them to a secure, HIPPA-compliant cloud server. It is required to have a CommCareHQ account in order to create and deploy data-collection apps.

Ebola Care Guidelines can retrieve data from a CommCare app collecting the variables defined in the default data-entry form described before. This CommCare app is not provided for installation, but the commcare folder in the repo provides the XML files specifying the two forms needed in this app: the patient registration form (where all the variables seen above get entered) and the follow-up form (to enter the final disposition of the patient). These XML files can be loaded into a CommCareHQ account to build the data-entry app. Once this app is installed in the device, the settings have to be changed to switch from the default data-entry form to the CommCare app:

To open the CommCare app from the Ebola Care Guidelines app, the same "Enter Patient Data" button is to be clicked. The first time this is done, the following sequence of screens will show up, with the middle one asking for permission to read the data from the CommCare app:

The "Use CommCare to" menu allows to enter a brand new case or to lookup an existing case, which is convenient since it allows to run the severity score calculation on existing data wihout having to enter it again (which is what happens with the default built-in form). Creating a new case opens the CommCare app where the same variables shown before are entered in succesive screens, some of which are shown below:

Finally, the CommCare data can be imported into the guidelines app by selecting the corresponding case from the case selection list:

A CommCare case is no longer available on the device once the final disposition is entered into the CommCare app.

Severity Score

Irrespective of whether the patient data is entered using the default form or CommCare's app, the Ebola Care Guidelines app will calculate the severity score for the patient after selecting a prognostic model that's suitable to the available information (check the wiki on how to add new models to the app). The care recommendations will be highlighed in the home screen based on the present signs/symptoms, and their contribution to the total score:

Clicking on the "Severity Score" button, the app will show a visualization of the score broken down into the individual contributors from each predictor, based on the logistic regression charts from Van Belle and Van Calster: