Code

A graphical user interface for antibody-drug conjugate simulations

A graphical user interface for antibody-drug conjugate simulations. For this model, users with MATLAB installed are able to run the executable file directly. Otherwise, the MATLAB Runtime for R2023a is needed, which can be downloaded and installed from this link on the MathWorks website.


Cilliers et al ADC model

from: Cilliers, C., H. Guo, J. Liao, N. Christodolu, and G. M. Thurber. Multiscale Modeling of Antibody-Drug Conjugates: Connecting Tissue and Cellular Distribution to Whole Animal Pharmacokinetics and Potential Implications for Efficacy. AAPS Journal. 2016; 18(5): 1117-30.


GUI screenshot

from: Bhatnagar, S., E. Deschenes, J. Liao, C. Cilliers, and G.M. ThurberMultichannel imaging to quantify four classes of pharmacokinetic distribution in tumors. J Pharm Sci. 2014; 103(10): 3276-86.


SimADC Download Guide

Please follow the instructions to download a GUI version of our cancer model, SimADC, as described in the publication listed below. Running this model requires the use of VirtualBox and the file download size is about 14 GB. Please refer to the supplementary information in the paper on how to run the model.

Agent-based modeling demonstrates how target-independent processes supplement killing by antibody-drug conjugates in cancer therapy. Melissa C. Calopiz, Jennifer J. Linderman, Greg M. Thurber. bioRxiv 2025.12.26.696346; doi: https://doi.org/10.64898/2025.12.26.696346. [preprint]

Installing VirtualBox

  1. Open the VirtualBox website. Go to https://www.virtualbox.org in your computer’s Internet browser. This is the website from which you’ll download the VirtualBox setup file.
  2. Click Download VirtualBox. It’s a blue button in the middle of the page. Doing so will open the downloads page
  3. Click [Linux hosts]. You’ll see this link below the “VirtualBox 7.x.x platform packages” heading. The VirtualBox RPM/DEB file will begin downloading onto your computer.
  4. Open the VirtualBox RPM/DEB file. Go to the location to which the RPM/DEB file downloaded and double-click the file. Doing so will open the VirtualBox installation window.
  5. Navigate through the installation prompts. Do the following:
    • Click Next on the first three pages.
    • • Click Yes when prompted.
    • • Click Install.
    • • Click Yes when prompted.
  6. Click [Install] when prompted. Doing so will allow VirtualBox to begin installing on your computer.
  7. Click [Finish] when prompted. It’s in the lower-right side of the window. Doing so will close the installation window and open VirtualBox.
  8. Download the Simulator Virtualbox Appliance.
  9. From Virtualbox, type CTRL-I and select the downloaded Simulator Virtualbox Appliance to import into Virtualbox.
  10. When prompted, check the box to reinitialize the MAC address of all network cards.
  11. Click [Import].

Running the Model in a Virtualbox Appliance

  1. Start Virtualbox
  2. Start the SimADC virtual machine.
  3. Logon as Guest. No password is required.
  4. Open a terminal window, Applications | Accessories | Terminal

– OR –

This will display the contents of file README.txt.

To run the model, in the terminal window do the following:

  1. To run the model with default options and a default parameter file, type: ‘./run-model‘ and hit return.
  2. The program initialization takes about 10 seconds and will print some initial status information.
  3. Once initialization is complete, a user interface window will open, along with a window showing the simulation environment. When you’ve selected the desired simulation settings in the user interface window, click ‘Start Simulation’ in the bottom left to start the simulation.
  4. To exit the program type the letter ‘q’ in either the main window or the graphics window.
  5. Type ‘./model -h’ for the model command line options.
  6. o run with a different parameter file or different options, type: ./model -i NameOfParameterFileToUse.xml MORE_OPTIONS and hit return, where MORE_OPTIONS is replaced with any additional command line options.

*Please send requests for any other code to Dr. Greg Thurbergthurber AT umich.edu