gillespy2


Namegillespy2 JSON
Version 1.8.3 PyPI version JSON
download
home_pagehttps://github.com/StochSS/GillesPy2
SummaryPython interface for Gillespie-style biochemical simulations
upload_time2024-09-19 19:06:50
maintainerSee AUTHORS
docs_urlNone
authorSee AUTHORS
requires_pythonNone
licenseGPL
keywords biochemical simulation gillespie algorithm stochastic simulation biology
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage
            <p align="left">
<img src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/gillespy2-logo.png">
</p>

GillesPy2 is a Python 3 package for stochastic simulation of biochemical systems.  It offers an object-oriented approach for creating mathematical models of biological systems, as well as a variety of methods for performing time simulation of those models.  The methods include the [Gillespie direct method (SSA)](https://en.wikipedia.org/wiki/Gillespie_algorithm), several variant stochastic simulation methods including [tau-Leaping](https://en.wikipedia.org/wiki/Tau-leaping), and numerical integration of ODEs.  The solvers support a variety of user environments, with optimized code for C++, and [NumPy](https://numpy.org).  GillesPy2 also supports [SBML](https://en.wikipedia.org/wiki/SBML).

<table><tr><td><b>
<img width="20%" align="right" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/stochss-logo.png">
<a href="https://docs.google.com/forms/d/12tAH4f8CJ-3F-lK44Q9uQHFio_mGoK0oY829q5lD7i4/viewform">PLEASE REGISTER AS A USER</a>, so that we can prove GillesPy2 has many users when we seek funding to support development. GillesPy2 is part of the <a href="http://www.stochss.org">StochSS</a> project.
</td></tr></table>

![PyPI - License](https://img.shields.io/pypi/l/gillespy2.svg?color=informational)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/gillespy2.svg)
[![PyPI](https://img.shields.io/pypi/v/gillespy2.svg)](https://pypi.org/project/gillespy2)
[![Conda (channel only)](https://img.shields.io/conda/vn/conda-forge/gillespy2)](https://anaconda.org/conda-forge/gillespy2)
![PyPI - Downloads](https://img.shields.io/pypi/dm/GillesPy2?color=informational&label=pypi%20downloads)
![Conda](https://img.shields.io/conda/dn/conda-forge/GillesPy2?color=informational&label=conda-forge%20downloads)

Table of contents
-----------------

- [Table of contents](#table-of-contents)
- [Installation](#installation)
  - [_Using PyPI_](#using-pypi)
  - [_Using the source code repository_](#using-the-source-code-repository)
- [Usage](#usage)
  - [_Simple example to illustrate the use of GillesPy2_](#simple-example-to-illustrate-the-use-of-gillespy2)
- [Getting help](#getting-help)
- [Contributing](#contributing)
- [License](#license)
- [Authors and history](#authors-and-history)
- [Acknowledgments](#acknowledgments)

Installation
------------

GillesPy2 can be installed on your computer using different methods, as described below.

### _Using PyPI_

On **Linux**, **macOS**, and **Windows** operating systems, you should be able to install GillesPy2 with `pip`. Please review the official pip [documentation](https://pip.pypa.io/en/stable/installing/) for installation instructions and additional information.

Then, to install GillesPy2 from the Python package repository, run the following command:
```sh
python3 -m pip install gillespy2 --user --upgrade
```

### _Using the source code repository_

As an alternative to getting it from PyPI, you can instruct `pip` to install GillesPy2 directly from the GitHub repository:
```sh
python3 -m pip install https://github.com/StochSS/GillesPy2/archive/main.zip --user --upgrade
```

As a final alternative, you can first use `git` to clone a copy of the GillesPy2 source tree from the GitHub repository to your local computer disk, and then install GillesPy2 using that copy:
```sh
git clone https://github.com/StochSS/GillesPy2.git
cd GillesPy2
python3 -m pip install  .  --user --upgrade
```

**NOTE:** to import/export SMBL, libSBML must be installed.  It is not installed by default with GillesPy2.  To include libSBML in the installation of GillesPy2 use `pip install gillespy2[sbml]`.  If GillesPy2 is already installed use `pip install python_libSBML`.


Usage
-----

GillesPy2 provides simple object-oriented abstractions for defining a model of a biochemical system and simulating that model using efficient stochastic simulation algorithms.  The basic steps to use GillesPy2 are:

1. Create a `GillesPy2.Model` containing molecular species, parameters, and reactions (or import it from an [SBML](http://sbml.org) file)
2. Invoke the model's `.run()` method.

The `run()` method can be customized using keyword arguments to select different solvers, random seed, data return type and more.  For more detailed examples on how to use GillesPy2, please see the [Getting Started](https://github.com/StochSS/GillesPy2/tree/main/examples/Start_Here.ipynb) Jupyter notebook contained in the [examples](https://github.com/StochSS/GillesPy2/tree/main/examples) subdirectory.

### _Simple example to illustrate the use of GillesPy2_

[Dimerization](https://www.ncbi.nlm.nih.gov/books/NBK26830) is a process in which two molecules of some molecular species (known as a "monomer" in this situation &ndash; let's call it "M" for short) come together to create a new molecule (call it "D"), but do so in a way that is reversible, meaning the combined structure can also decay or dissociate back into "M".  A simple model of the dimerization process represents it as two reactions: a reaction in which one molecule of "M" reacts with another molecule of "M" to form one new molecule ("D"), and another reaction in which a molecule of "D" breaks apart into two molecules of "M".  In terms of biochemical reactions, it looks like this (where _k<sub>c</sub>_ and _k<sub>d</sub>_ represent the rate constants for creation and dissociation of the dimer, respectively; _M_ represents the number of molecules of "M"; and _D_ is the number of molecules of "D"):

<p align="center">
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<i>k<sub>c</sub></i><br>
  <i>2 M</i>&nbsp;&nbsp;⟷ <i>D</i><br>
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<i>k<sub>d</sub></i><br>
</p>

In GillesPy2, a model is expressed as an object.  Components, such as the reactions, molecular species, and characteristics such as the time span for simulation, are all defined within the model.  The following Python code represents our dimerization model using GillesPy2's facility:

```python
def create_dimerization(parameter_values=None):
    # First call the gillespy2.Model initializer.
    model = gillespy2.Model(name='Dimerization')

    # Define parameters for the rates of creation and dissociation.
    k_c = gillespy2.Parameter(name='k_c', expression=0.005)
    k_d = gillespy2.Parameter(name='k_d', expression=0.08)
    model.add_parameter([k_c, k_d])

    # Define variables for the molecular species representing M and D.
    m = gillespy2.Species(name='monomer', initial_value=30)
    d = gillespy2.Species(name='dimer',   initial_value=0)
    model.add_species([m, d])

    # The list of reactants and products for a Reaction object are each a
    # Python dictionary in which the dictionary keys are Species objects
    # and the values are stoichiometries of the species in the reaction.
    r_c = gillespy2.Reaction(name="r_creation", rate=k_c, reactants={m:2}, products={d:1})
    r_d = gillespy2.Reaction(name="r_dissociation", rate=k_d, reactants={d:1}, products={m:2})
    model.add_reaction([r_c, r_d])

    # Set the timespan for the simulation.
    tspan = gillespy2.TimeSpan.linspace(t=100, num_points=101)
    model.timespan(tspan)
    return model
```

Given the model creation function above, the model can be simulated by first instantiating the model object, and then invoking the run() method on the object. The following code will run the model 10 times to produce 10 sample trajectories:

```python
model = create_dimerization()
results = model.run(number_of_trajectories=10)
```

The results are then stored in a class `Results` object for single trajectory or for multiple trajectories.  Results can be plotted with matplotlib using `plot()` or in plotly (offline) using `plotplotly()`.  For additional plotting options such as plotting from a selection of species, or statistical plotting, please see the documentation.:

```python
results.plot()
```

<p align="center">
<img width="500px" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/dimerization-example-plot.png">
</p>

Alternatively, the results object inherits python-builtin `UserDict` for single trajectories, and `UserList` for multiple trajectories.  Results can be plotted easily using any plotting library such as matplotlib as shown below:

```python
for index in range(0, 10):
    trajectory = results[index]
    plt.plot(trajectory['time'], trajectory['monomer'], 'r')
    plt.plot(trajectory['time'], trajectory['dimer'],   'b')
```

With a few additional Python matplotlib commands to create figure labels and such, we end up with a plot like this:

<p align="center">
<img width="500px" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/dimerization-example-matplotlib.png">
</p>

Getting help
------------

GillesPy2's [online documentation](https://stochss.github.io/GillesPy2) provides more details about using the software.  If you find any problem with GillesPy2 or the documentation, please report it using the [GitHub issue tracker](https://github.com/StochSS/GillesPy2/issues) for this repository.  You can also contact Dr. [Brian Drawert](http://www.cs.unca.edu/~drawert) directly with questions and suggestions.

Contributing
------------

We would be happy to receive your help and participation with enhancing GillesPy2!  The [UML class diagram](UML_CLASS_DIAGRAM.md) and [Pynsource](https://pynsource.com/) [UML class model](gillespy2-UML-class-model.pyns) may help you familiarize yourself with the existing code. Please follow the guidelines described in [CONTRIBUTING.md](https://github.com/StochSS/GillesPy2/tree/main/CONTRIBUTING.md).

New developments happen primarily in the [`develop`](https://github.com/StochSS/GillesPy2/commits/develop) branch.  New releases are put in the `main` branch.

<p align="center">

| Main Branch   | Develop Branch | Test Coverage | Maintainability |
|:---------------:|:--------------:|:--------:|:---------------:|
| [![Build Status](https://travis-ci.org/StochSS/GillesPy2.svg?branch=main)](https://travis-ci.org/StochSS/GillesPy2) | [![Build Status](https://travis-ci.org/StochSS/GillesPy2.svg?branch=develop)](https://travis-ci.org/StochSS/GillesPy2) | [![Test Coverage](https://api.codeclimate.com/v1/badges/990ac9d778d681d32eea/test_coverage)](https://codeclimate.com/github/GillesPy2/GillesPy2/test_coverage) | [![Maintainability](https://api.codeclimate.com/v1/badges/990ac9d778d681d32eea/maintainability)](https://codeclimate.com/github/GillesPy2/GillesPy2/maintainability) |

License
-------

GillesPy2 is licensed under the GNU General Public License version 3.  Please see the file [LICENSE](https://github.com/StochSS/GillesPy2/blob/main/LICENSE) for more information.

Authors and history
---------------------------

* [**Dr. Brian Drawert** ](https://github.com/briandrawert)
* [**Dr. Kevin Sanft**](https://github.com/kevinsanft)
* [**Ghilman Brock**](https://github.com/GhilmanBrock)
* [**Eliot Dixon**](https://github.com/edixon1)
* [**Dalton Nickerson**](https://github.com/Thisisnotdalton)
* [**Sean Matthew**](https://github.com/seanebum)
* [**Matthew Geiger**](https://github.com/popensesame)
* [**Kassidy Hall** ](https://github.com/technodivergent)
* [**W.R. Jackson** ](https://github.com/JustJackson)
* [**Samuel Hodges**](https://github.com/hodgespodge)
* [**Emma Weisgerber**](https://github.com/eweisger)
* [**Adrien Coulier**](https://github.com/Aratz)
* [**Mike Hucka**](https://github.com/mhucka)
* [**Fredrik Wrede**](https://github.com/Wrede)
* [**Prashant Singh**](https://github.com/prasi372)
* [**Bryan Rumsey**](https://github.com/BryanRumsey)  
* [**Mason Kidwell**](https://github.com/makdl)
* [**Jesse Reeve**](https://github.com/jdreeve)
* [**Fin Carter**](https://github.com/Fin109)
* [**Ethan Green**](https://github.com/ethangreen-dev)
* [**Josh Cooper**](https://github.com/jtcooper10)
* [**Matthew Dippel**](https://github.com/mdip226)
* [**Joshua Fisher-Caudill**](https://github.com/joshuafisherc)


Acknowledgments
---------------

This work has been funded by National Institutes of Health (NIH) NIBIB Award No. 2R01EB014877-04A1.

GillesPy2 uses numerous open-source packages, without which it would have been effectively impossible to develop this software with the resources we had.  We want to acknowledge this debt.  In alphabetical order, the packages are:

* [Jupyter](https://jupyter.org) &ndash; web application for creating documents containing code, visualizations and narrative text
* [libSBML](http://sbml.org/Software/libSBML) &ndash; a library for reading, writing, and manipulating SBML content
* [lxml](https://lxml.de) &ndash; an XML parsing library for Python
* [MatplotLib](https://matplotlib.org/index.html) &ndash; Python plotting library
* [Plotly](https://plot.ly/) &ndash; Graphing library for making interactive, publication-quality graphs
* [Numpy](https://www.numpy.org/) &ndash; the fundamental package for scientific computing with Python
* [Scipy](https://www.scipy.org/) &ndash; Python-based ecosystem of open-source software for mathematics, science, and engineering

Finally, we are grateful for institutional resources made available by the [University of North Carolina at Asheville](https://www.unca.edu), the [University of California at Santa Barbara](https://ucsb.edu), [Uppsala University](https://www.it.uu.se), and the [California Institute of Technology](https://www.caltech.edu).

<div align="center">
  <a href="https://www.nigms.nih.gov">
    <img width="100" height="100" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/US-NIH-NIGMS-Logo.png">
  </a>
  &nbsp;&nbsp;
  <a href="https://www.unca.edu">
    <img height="102" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/UNCASEAL_blue.png">
  </a>
  &nbsp;&nbsp;
  <a href="https://www.ucsb.edu">
    <img height="108" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/ucsb-seal-navy.jpg">
  </a>
  &nbsp;&nbsp;
  <a href="https://www.it.uu.se">
    <img height="115" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/uppsala-universitet-logo-svg-vector.png">
  </a>
  &nbsp;&nbsp;
  <a href="https://www.caltech.edu">
    <img width="115" src="https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/caltech-round.png">
  </a>
</div>



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/StochSS/GillesPy2",
    "name": "gillespy2",
    "maintainer": "See AUTHORS",
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": "briandrawert@gmail.com",
    "keywords": "biochemical simulation, Gillespie algorithm, stochastic simulation, biology",
    "author": "See AUTHORS",
    "author_email": "briandrawert@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/02/b0/c13e3c4f2f66412b4603234e9c2dfd6bec68926c89b40d8339479cdbcd11/gillespy2-1.8.3.tar.gz",
    "platform": null,
    "description": "<p align=\"left\">\n<img src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/gillespy2-logo.png\">\n</p>\n\nGillesPy2 is a Python 3 package for stochastic simulation of biochemical systems.  It offers an object-oriented approach for creating mathematical models of biological systems, as well as a variety of methods for performing time simulation of those models.  The methods include the [Gillespie direct method (SSA)](https://en.wikipedia.org/wiki/Gillespie_algorithm), several variant stochastic simulation methods including [tau-Leaping](https://en.wikipedia.org/wiki/Tau-leaping), and numerical integration of ODEs.  The solvers support a variety of user environments, with optimized code for C++, and [NumPy](https://numpy.org).  GillesPy2 also supports [SBML](https://en.wikipedia.org/wiki/SBML).\n\n<table><tr><td><b>\n<img width=\"20%\" align=\"right\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/stochss-logo.png\">\n<a href=\"https://docs.google.com/forms/d/12tAH4f8CJ-3F-lK44Q9uQHFio_mGoK0oY829q5lD7i4/viewform\">PLEASE REGISTER AS A USER</a>, so that we can prove GillesPy2 has many users when we seek funding to support development. GillesPy2 is part of the <a href=\"http://www.stochss.org\">StochSS</a> project.\n</td></tr></table>\n\n![PyPI - License](https://img.shields.io/pypi/l/gillespy2.svg?color=informational)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/gillespy2.svg)\n[![PyPI](https://img.shields.io/pypi/v/gillespy2.svg)](https://pypi.org/project/gillespy2)\n[![Conda (channel only)](https://img.shields.io/conda/vn/conda-forge/gillespy2)](https://anaconda.org/conda-forge/gillespy2)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/GillesPy2?color=informational&label=pypi%20downloads)\n![Conda](https://img.shields.io/conda/dn/conda-forge/GillesPy2?color=informational&label=conda-forge%20downloads)\n\nTable of contents\n-----------------\n\n- [Table of contents](#table-of-contents)\n- [Installation](#installation)\n  - [_Using PyPI_](#using-pypi)\n  - [_Using the source code repository_](#using-the-source-code-repository)\n- [Usage](#usage)\n  - [_Simple example to illustrate the use of GillesPy2_](#simple-example-to-illustrate-the-use-of-gillespy2)\n- [Getting help](#getting-help)\n- [Contributing](#contributing)\n- [License](#license)\n- [Authors and history](#authors-and-history)\n- [Acknowledgments](#acknowledgments)\n\nInstallation\n------------\n\nGillesPy2 can be installed on your computer using different methods, as described below.\n\n### _Using PyPI_\n\nOn **Linux**, **macOS**, and **Windows** operating systems, you should be able to install GillesPy2 with `pip`. Please review the official pip [documentation](https://pip.pypa.io/en/stable/installing/) for installation instructions and additional information.\n\nThen, to install GillesPy2 from the Python package repository, run the following command:\n```sh\npython3 -m pip install gillespy2 --user --upgrade\n```\n\n### _Using the source code repository_\n\nAs an alternative to getting it from PyPI, you can instruct `pip` to install GillesPy2 directly from the GitHub repository:\n```sh\npython3 -m pip install https://github.com/StochSS/GillesPy2/archive/main.zip --user --upgrade\n```\n\nAs a final alternative, you can first use `git` to clone a copy of the GillesPy2 source tree from the GitHub repository to your local computer disk, and then install GillesPy2 using that copy:\n```sh\ngit clone https://github.com/StochSS/GillesPy2.git\ncd GillesPy2\npython3 -m pip install  .  --user --upgrade\n```\n\n**NOTE:** to import/export SMBL, libSBML must be installed.  It is not installed by default with GillesPy2.  To include libSBML in the installation of GillesPy2 use `pip install gillespy2[sbml]`.  If GillesPy2 is already installed use `pip install python_libSBML`.\n\n\nUsage\n-----\n\nGillesPy2 provides simple object-oriented abstractions for defining a model of a biochemical system and simulating that model using efficient stochastic simulation algorithms.  The basic steps to use GillesPy2 are:\n\n1. Create a `GillesPy2.Model` containing molecular species, parameters, and reactions (or import it from an [SBML](http://sbml.org) file)\n2. Invoke the model's `.run()` method.\n\nThe `run()` method can be customized using keyword arguments to select different solvers, random seed, data return type and more.  For more detailed examples on how to use GillesPy2, please see the [Getting Started](https://github.com/StochSS/GillesPy2/tree/main/examples/Start_Here.ipynb) Jupyter notebook contained in the [examples](https://github.com/StochSS/GillesPy2/tree/main/examples) subdirectory.\n\n### _Simple example to illustrate the use of GillesPy2_\n\n[Dimerization](https://www.ncbi.nlm.nih.gov/books/NBK26830) is a process in which two molecules of some molecular species (known as a \"monomer\" in this situation &ndash; let's call it \"M\" for short) come together to create a new molecule (call it \"D\"), but do so in a way that is reversible, meaning the combined structure can also decay or dissociate back into \"M\".  A simple model of the dimerization process represents it as two reactions: a reaction in which one molecule of \"M\" reacts with another molecule of \"M\" to form one new molecule (\"D\"), and another reaction in which a molecule of \"D\" breaks apart into two molecules of \"M\".  In terms of biochemical reactions, it looks like this (where _k<sub>c</sub>_ and _k<sub>d</sub>_ represent the rate constants for creation and dissociation of the dimer, respectively; _M_ represents the number of molecules of \"M\"; and _D_ is the number of molecules of \"D\"):\n\n<p align=\"center\">\n    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<i>k<sub>c</sub></i><br>\n  <i>2 M</i>&nbsp;&nbsp;\u27f7 <i>D</i><br>\n    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<i>k<sub>d</sub></i><br>\n</p>\n\nIn GillesPy2, a model is expressed as an object.  Components, such as the reactions, molecular species, and characteristics such as the time span for simulation, are all defined within the model.  The following Python code represents our dimerization model using GillesPy2's facility:\n\n```python\ndef create_dimerization(parameter_values=None):\n    # First call the gillespy2.Model initializer.\n    model = gillespy2.Model(name='Dimerization')\n\n    # Define parameters for the rates of creation and dissociation.\n    k_c = gillespy2.Parameter(name='k_c', expression=0.005)\n    k_d = gillespy2.Parameter(name='k_d', expression=0.08)\n    model.add_parameter([k_c, k_d])\n\n    # Define variables for the molecular species representing M and D.\n    m = gillespy2.Species(name='monomer', initial_value=30)\n    d = gillespy2.Species(name='dimer',   initial_value=0)\n    model.add_species([m, d])\n\n    # The list of reactants and products for a Reaction object are each a\n    # Python dictionary in which the dictionary keys are Species objects\n    # and the values are stoichiometries of the species in the reaction.\n    r_c = gillespy2.Reaction(name=\"r_creation\", rate=k_c, reactants={m:2}, products={d:1})\n    r_d = gillespy2.Reaction(name=\"r_dissociation\", rate=k_d, reactants={d:1}, products={m:2})\n    model.add_reaction([r_c, r_d])\n\n    # Set the timespan for the simulation.\n    tspan = gillespy2.TimeSpan.linspace(t=100, num_points=101)\n    model.timespan(tspan)\n    return model\n```\n\nGiven the model creation function above, the model can be simulated by first instantiating the model object, and then invoking the run() method on the object. The following code will run the model 10 times to produce 10 sample trajectories:\n\n```python\nmodel = create_dimerization()\nresults = model.run(number_of_trajectories=10)\n```\n\nThe results are then stored in a class `Results` object for single trajectory or for multiple trajectories.  Results can be plotted with matplotlib using `plot()` or in plotly (offline) using `plotplotly()`.  For additional plotting options such as plotting from a selection of species, or statistical plotting, please see the documentation.:\n\n```python\nresults.plot()\n```\n\n<p align=\"center\">\n<img width=\"500px\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/dimerization-example-plot.png\">\n</p>\n\nAlternatively, the results object inherits python-builtin `UserDict` for single trajectories, and `UserList` for multiple trajectories.  Results can be plotted easily using any plotting library such as matplotlib as shown below:\n\n```python\nfor index in range(0, 10):\n    trajectory = results[index]\n    plt.plot(trajectory['time'], trajectory['monomer'], 'r')\n    plt.plot(trajectory['time'], trajectory['dimer'],   'b')\n```\n\nWith a few additional Python matplotlib commands to create figure labels and such, we end up with a plot like this:\n\n<p align=\"center\">\n<img width=\"500px\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/dimerization-example-matplotlib.png\">\n</p>\n\nGetting help\n------------\n\nGillesPy2's [online documentation](https://stochss.github.io/GillesPy2) provides more details about using the software.  If you find any problem with GillesPy2 or the documentation, please report it using the [GitHub issue tracker](https://github.com/StochSS/GillesPy2/issues) for this repository.  You can also contact Dr. [Brian Drawert](http://www.cs.unca.edu/~drawert) directly with questions and suggestions.\n\nContributing\n------------\n\nWe would be happy to receive your help and participation with enhancing GillesPy2!  The [UML class diagram](UML_CLASS_DIAGRAM.md) and [Pynsource](https://pynsource.com/) [UML class model](gillespy2-UML-class-model.pyns) may help you familiarize yourself with the existing code. Please follow the guidelines described in [CONTRIBUTING.md](https://github.com/StochSS/GillesPy2/tree/main/CONTRIBUTING.md).\n\nNew developments happen primarily in the [`develop`](https://github.com/StochSS/GillesPy2/commits/develop) branch.  New releases are put in the `main` branch.\n\n<p align=\"center\">\n\n| Main Branch   | Develop Branch | Test Coverage | Maintainability |\n|:---------------:|:--------------:|:--------:|:---------------:|\n| [![Build Status](https://travis-ci.org/StochSS/GillesPy2.svg?branch=main)](https://travis-ci.org/StochSS/GillesPy2) | [![Build Status](https://travis-ci.org/StochSS/GillesPy2.svg?branch=develop)](https://travis-ci.org/StochSS/GillesPy2) | [![Test Coverage](https://api.codeclimate.com/v1/badges/990ac9d778d681d32eea/test_coverage)](https://codeclimate.com/github/GillesPy2/GillesPy2/test_coverage) | [![Maintainability](https://api.codeclimate.com/v1/badges/990ac9d778d681d32eea/maintainability)](https://codeclimate.com/github/GillesPy2/GillesPy2/maintainability) |\n\nLicense\n-------\n\nGillesPy2 is licensed under the GNU General Public License version 3.  Please see the file [LICENSE](https://github.com/StochSS/GillesPy2/blob/main/LICENSE) for more information.\n\nAuthors and history\n---------------------------\n\n* [**Dr. Brian Drawert** ](https://github.com/briandrawert)\n* [**Dr. Kevin Sanft**](https://github.com/kevinsanft)\n* [**Ghilman Brock**](https://github.com/GhilmanBrock)\n* [**Eliot Dixon**](https://github.com/edixon1)\n* [**Dalton Nickerson**](https://github.com/Thisisnotdalton)\n* [**Sean Matthew**](https://github.com/seanebum)\n* [**Matthew Geiger**](https://github.com/popensesame)\n* [**Kassidy Hall** ](https://github.com/technodivergent)\n* [**W.R. Jackson** ](https://github.com/JustJackson)\n* [**Samuel Hodges**](https://github.com/hodgespodge)\n* [**Emma Weisgerber**](https://github.com/eweisger)\n* [**Adrien Coulier**](https://github.com/Aratz)\n* [**Mike Hucka**](https://github.com/mhucka)\n* [**Fredrik Wrede**](https://github.com/Wrede)\n* [**Prashant Singh**](https://github.com/prasi372)\n* [**Bryan Rumsey**](https://github.com/BryanRumsey)  \n* [**Mason Kidwell**](https://github.com/makdl)\n* [**Jesse Reeve**](https://github.com/jdreeve)\n* [**Fin Carter**](https://github.com/Fin109)\n* [**Ethan Green**](https://github.com/ethangreen-dev)\n* [**Josh Cooper**](https://github.com/jtcooper10)\n* [**Matthew Dippel**](https://github.com/mdip226)\n* [**Joshua Fisher-Caudill**](https://github.com/joshuafisherc)\n\n\nAcknowledgments\n---------------\n\nThis work has been funded by National Institutes of Health (NIH) NIBIB Award No. 2R01EB014877-04A1.\n\nGillesPy2 uses numerous open-source packages, without which it would have been effectively impossible to develop this software with the resources we had.  We want to acknowledge this debt.  In alphabetical order, the packages are:\n\n* [Jupyter](https://jupyter.org) &ndash; web application for creating documents containing code, visualizations and narrative text\n* [libSBML](http://sbml.org/Software/libSBML) &ndash; a library for reading, writing, and manipulating SBML content\n* [lxml](https://lxml.de) &ndash; an XML parsing library for Python\n* [MatplotLib](https://matplotlib.org/index.html) &ndash; Python plotting library\n* [Plotly](https://plot.ly/) &ndash; Graphing library for making interactive, publication-quality graphs\n* [Numpy](https://www.numpy.org/) &ndash; the fundamental package for scientific computing with Python\n* [Scipy](https://www.scipy.org/) &ndash; Python-based ecosystem of open-source software for mathematics, science, and engineering\n\nFinally, we are grateful for institutional resources made available by the [University of North Carolina at Asheville](https://www.unca.edu), the [University of California at Santa Barbara](https://ucsb.edu), [Uppsala University](https://www.it.uu.se), and the [California Institute of Technology](https://www.caltech.edu).\n\n<div align=\"center\">\n  <a href=\"https://www.nigms.nih.gov\">\n    <img width=\"100\" height=\"100\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/US-NIH-NIGMS-Logo.png\">\n  </a>\n  &nbsp;&nbsp;\n  <a href=\"https://www.unca.edu\">\n    <img height=\"102\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/UNCASEAL_blue.png\">\n  </a>\n  &nbsp;&nbsp;\n  <a href=\"https://www.ucsb.edu\">\n    <img height=\"108\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/ucsb-seal-navy.jpg\">\n  </a>\n  &nbsp;&nbsp;\n  <a href=\"https://www.it.uu.se\">\n    <img height=\"115\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/uppsala-universitet-logo-svg-vector.png\">\n  </a>\n  &nbsp;&nbsp;\n  <a href=\"https://www.caltech.edu\">\n    <img width=\"115\" src=\"https://raw.githubusercontent.com/StochSS/GillesPy2/develop/.graphics/caltech-round.png\">\n  </a>\n</div>\n\n\n",
    "bugtrack_url": null,
    "license": "GPL",
    "summary": "Python interface for Gillespie-style biochemical simulations",
    "version": "1.8.3",
    "project_urls": {
        "Download": "https://pypi.org/project/gillespy2/#files",
        "Homepage": "https://github.com/StochSS/GillesPy2",
        "Source": "https://github.com/StochSS/GillesPy2",
        "Tracker": "https://github.com/StochSS/GillesPy2/issues"
    },
    "split_keywords": [
        "biochemical simulation",
        " gillespie algorithm",
        " stochastic simulation",
        " biology"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ba58e2bc558d9bb5b9745cb847833cc817318fa0549bd62af566e5a13d392d87",
                "md5": "b1841095509ed623be46d57fb3c99406",
                "sha256": "7907880eaf5e542ca1efad598f5d59d306f01355262ef35f9217a49d825692f0"
            },
            "downloads": -1,
            "filename": "gillespy2-1.8.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b1841095509ed623be46d57fb3c99406",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 398878,
            "upload_time": "2024-09-19T19:06:48",
            "upload_time_iso_8601": "2024-09-19T19:06:48.441891Z",
            "url": "https://files.pythonhosted.org/packages/ba/58/e2bc558d9bb5b9745cb847833cc817318fa0549bd62af566e5a13d392d87/gillespy2-1.8.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "02b0c13e3c4f2f66412b4603234e9c2dfd6bec68926c89b40d8339479cdbcd11",
                "md5": "1c4ba298e9ea65a1115e90eda98d4f37",
                "sha256": "8eed59b5ba12614225a7fdb42ebb72e461bbd3a1e23947fef359e16eeaed845f"
            },
            "downloads": -1,
            "filename": "gillespy2-1.8.3.tar.gz",
            "has_sig": false,
            "md5_digest": "1c4ba298e9ea65a1115e90eda98d4f37",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 313887,
            "upload_time": "2024-09-19T19:06:50",
            "upload_time_iso_8601": "2024-09-19T19:06:50.695566Z",
            "url": "https://files.pythonhosted.org/packages/02/b0/c13e3c4f2f66412b4603234e9c2dfd6bec68926c89b40d8339479cdbcd11/gillespy2-1.8.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-19 19:06:50",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "StochSS",
    "github_project": "GillesPy2",
    "travis_ci": true,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "lcname": "gillespy2"
}
        
Elapsed time: 0.43894s