Giter VIP home page Giter VIP logo

davaug / mipd-warfarin Goto Github PK

View Code? Open in Web Editor NEW
1.0 1.0 0.0 383.21 MB

This GitHub repository serves as documentation and reproduction source for our article: Augustin D, Lambert B, Robinson M, Wang K, Gavaghan D (2023) Simulating clinical trials for model-informed precision dosing: Using warfarin treatment as a use case.

Home Page: https://doi.org/10.3389/fphar.2023.1270443

Jupyter Notebook 97.30% Python 2.69% Makefile 0.01%
deep-reinforcement-learning neural-network pkpd-modelling precision-medicine clinical-trial-simulation mipd

mipd-warfarin's Introduction

Simulating clinical trials for model-informed precision dosing: Using warfarin treatment as a use case

This GitHub repository serves as documentation and reproduction source for the results published in XX. It contains the raw data, the data derived during the analysis, the model specifications (SBML format) and executable scripts (Python scripts as well as Jupyter notebooks).

Looking at the results

The results are documented by multiple notebooks. To open the notebooks, please follow the links below:

  1. MIPD trial results & dosing strategies of models

To inspect the scripts used to generate data, implement models and to estimate model parameters, please follow the links below:

Datasets

Clinical dataset published by Warfarin Consortium (March 2008):

  1. INR measurements under maintenance warfarin treatment [Raw dataset] [Preprocessing script]

Simulated measurements:

  1. Clinical trial phase I [Data-generating script]
  2. Clinical trial phase II [Data-generating script]
  3. Clinical trial phase III [Data-generating script]
  4. MIPD trial cohort [Data-generating script]
  5. MIPD trial results: Regression model [Data-generating script]
  6. MIPD trial results: Deep RL model [Data-generating script]
  7. MIPD trial results: PKPD model [Data-generating script]

Model implementations

  1. Warfarin clinical trial model [SBML file (in vivo model)] [SBML file (INR test model)] [Parameters]
  2. Regression model [Training script] [Model weights]
  3. Deep RL model [Training script] [Model weights]
  4. PKPD model [SBML file] [Inference script (CTI)] [Inference script (CTII)] [Inference script (CTIII)] [Posterior distribution]

MIPD trial simulation

Scripts used in all MIPD trial simulations:

  1. Monitoring data simulation

Scripts specific to the different MIPD models:

  1. Regression model
  2. Deep RL model
  3. PKPD model

Reproducing the results

To reproduce the results, the GitHub repository can be cloned, and the scripts can be executed locally. For ease of execution, we prepared a Makefile that runs the scripts in the correct order. Please find a step-by-step instruction how to install the dependencies and how to reproduce the results, once the repostory has been cloned.

1. Install dependencies

  • 1.1 Install CVODE (myokit uses CVODE to solve ODEs)

For Ubuntu:

apt-get update && apt-get install libsundials-dev

For MacOS:

brew update-reset && brew install sundials

For Windows: No action required. Myokit installs CVODE automatically.

  • 1.2 Install Python dependencies
pip install -r requirements.txt

2. Reproduce results

You can reproduce the results using the Makefile. First install nbconvert which helps to execute the notebooks from the terminal

pip install nbconvert

You can now reproduce all data and figures in the article using

make all

This may take a while (hours to days), because you are re-running all scripts sequentially.

To reproduce only the plots from the existing data you can run

make run_mipd_trial_deep_rl_model

You can also run each script individually, but be aware that some scripts are dependent on the data derived in other scripts.

mipd-warfarin's People

Contributors

davaug avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.