README.md

KDE Event-Based Model

The Event-Based Model (EBM) is a simple, robust model for the estimation of the most likely order of events in a degenerative disease. This version uses nonparametric (kernel density estimate) distributions within the mixture modelling step.

Installation instructions: see INSTALL file.

You can now try out the walkthrough notebook on Binder. Just click the Launch Binder badge above.

Important Links

• Issue tracker

KDE EBM paper

• Firth, et al., Alzheimer's & Dementia, 2020

EBM Papers

• Fonteijn et al., NeuroImage, 2012
• Young et al., Brain, 2014

Dependencies

See INSTALL for installation instructions.

• NumPy
• SciPy
• Matplotlib
• awkde

The code depends heavily on NumPy, uses SciPy to calculate some stats and do some optimisation and uses Matplotlib just to do the plotting. awkde is for variable bandwidth KDE (meged into main/master branch in Feb 2020).

Contributing

Please read the CONTRIBUTING.md file before making any contributions.

Tweaks

1. Variable bandwidth KDE (awkde) mixture modelling

   Improved mixture model fitting in low-density areas such as the tail of a skewed distribution

2. Prioritised controls

   Option for the controls to be 'fixed', i.e., very unlikely to be relabelled as 'abnormal' in the mixture model