Skip to content
Simulator of Antibiotic Therapy Effects on the Dynamics of Bacterial Populations
Python Other
  1. Python 99.6%
  2. Other 0.4%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
wiki images
.gitignore
LICENSE
README.md
SimulATe.pyw
install_dependencies.py
pyinstaller_build_for_mac.sh
pyinstaller_build_for_windows.bat
screenshot.png

README.md

Simulator of Antibiotic Therapy Effects on the Dynamics of Bacterial Populations

icon

SimulATe (Simulator of Antibiotic Therapy Effects on the dynamics of bacterial populations) is a program that simulates the effects of the administration of antibiotics on microbial populations. Its main goals are: a) to be used as a teaching tool for students, to facilitate learning about microbial population dynamics and, more precisely, the role of antibiotics as resistance selection agents and as microbiome disruption agents; and b) to be used as a testing tool for researchers in the field of antibiotic resistance.

Authors: Pedro HC David, Xana Sá-Pinto, Teresa Nogueira

Screenshot

How to install

Note 1: Kivy requires OpenGL 2.0 or higher to run. This should not be a problem for most recent systems, as graphics cards drivers usually ship with some form of OpenGL 2.0 or higher. If for some reason you come across an error mentioning old OpenGL versions, you should try to update your graphics card drivers. If that isn't possible, this program won't be able to run on your system.

Note 2: install_dependencies.py requires an internet connection to install dependencies.

Windows

The easiest way to install SimulATe on Windows is by downloading the latest release available from the releases page and unzipping. No extra dependencies required.

You can also download or clone this repository and install the following dependencies:

  • Python 2.7
  • Python Module dependencies (can be installed by running install_dependencies.py):
    • Kivy
    • kivy.deps.glew
    • kivy.deps.sdl2

Linux

To install SimulATe on Linux, download or clone this repository and install the following dependencies:

  • Python 2.7
  • Kivy (follow the installation guide here. I recommend using conda, as the dependencies are correctly installed that way)

MacOS

To install SimulATe on MacOS, download or clone this repository and install the following dependencies:

  • Python 2.7
  • Python Module dependencies (can be installed by running install_dependencies.py):
    • Cython
    • Kivy
  • Kivy dependencies (can also be installed by running install_dependencies.py):
    • pkg-config
    • sdl2
    • sdl2_image
    • sdl2_ttf
    • sdl2_mixer
    • gstreamer

How to use

If you downloaded the latest Windows release, running SimulATe is as easy as launching the SimulATe.exe found inside the program folder. If you downloaded or cloned this repository, run the SimulATe.pyw script with python 2.7, on all platforms.

When running the program you will first have to choose a simulation scenario:

  • Single Population: Antibiotic effects on a single pathogenic bacterial population, composed of both antibiotic resistant and antibiotic sensitive bacteria. The host's immune system may or may not also come into play.
  • Microbiome: Antibiotic effects on a human gut microbiome. Assumes equilibrium with the host's immune system, which means it will not directly come into play. This scenario aims at simulating the selective pressure exerced by antibiotics on the human gut microbial population.

In each scenario you will be presented with a lot of customizable parameters which allows the simulation to be tailored to your needs.

For a more detailed usage guide, please refer to the wiki.

Publication

Pedro H C David, Xana Sá-Pinto, Teresa Nogueira, Using SimulATe to model the effects of antibiotic selective pressure on the dynamics of pathogenic bacterial populations, Biology Methods and Protocols, Volume 4, Issue 1, 2019, bpz004, https://doi.org/10.1093/biomethods/bpz004

Other Research

Teresa Nogueira, Pedro H C David, Joël Pothier, Antibiotics as both friends and foes of the human gut microbiome: The microbial community approach, Drug Development Research, 80: 86– 97, 2019, https://doi.org/10.1002/ddr.21466

Acknowledgments

License

You can’t perform that action at this time.