strengths 0.0.15

A package for the modeling and simulation of reaction-diffusion systems.

Introduction

Strengths is a modeling and simulation tool for reaction diffusion systems, interfaced as a Python package. It stands for “Simulation and modeling Tool for Reaction diffusion Networks in Graphs and Tridimensional Heterogenous Systems”. The design of reaction-diffusion systems is facilitated by the use of dictionary as a way to define most of the key objects.

Installing and using Strengths

For Strengths to work properly, a few dependencies have to be installed first, including NumPy (required) and Matplotlib (optional). All dependencies can be installed at once with

pip install -r "https://raw.githubusercontent.com/ThibaultFillion/strengths/main/requirements.txt"

The package can then be installed from the Python Package Index with

pip install strengths

Alternatively, you can build Strengths from source. More details on how to do so are given in the documentation, in the “Building Strengths from source” section.

Once it is successfully installed, you should be able to import it in Python. Below is a short example, featuring the simulation of the trajectory for a simple reaction system:

# importing strengths

import strengths as strn
import strengths.plot as strnplt

# defining a reaction system:
# this one have two species, A
# and B. One can be converted to the other,
# through the reversible reaction A <=> B.

system = strn.rdsystem_from_dict({
    "network" : {
        "species" : [
            {"label" : "A", "density" : 150},
            {"label" : "B", "density" : 50}
            ],
        "reactions" : [
            {"eq" : "A -> B", "k+" : 0.01, "k-" : 0.012}
            ]
        }
    })

# running a simulation
trajectory = strn.simulate(system, t_sample=list(range(500)))

# plotting the trajectories of A and B
strnplt.plot_trajectory(trajectory, ["A", "B"])

More examples, using more advanced features - especially diffusion -, are available in the documentation, in the “Using Strengths” section.

Documentation

Detailed information on the package and how to use it are given in the documentation. Especially, to get started with the package, you may look at the “Using Strengths” section, which presents the key functionalities through examples. For detailed and more exhaustive information on the accessible interface, please refer to the “API Reference” section, where all relevant functions, classes, methods and attributes are covered in detail.

Source code and contribution

Strengths has a repository hosted on GitHub.

If you wish to contribute to the package, whether by giving your feedback, reporting bugs or errors, improving the documentation or writing code, please refer to the project’s community and contribution guidelines.

Testing

Running run_all_tests.py in the tests directory will execute at once all unit tests for the package.

Licence

Strengths’s source code and documentation are licensed under the terms of the MIT Licence. You’ll find the licence text in your strengths installation root file, or in the root file of the project’s GitHub repository.

Authors

• Thibault Fillion

• Francesco Piazza