Installation

Operating System

PyBNF can be installed on any recent Linux or macOS operating system.

PyBNF can also be installed on Windows, but functionality on Windows has been less extensively tested (in particular, Windows clusters and multicore workstations have not been tested).

Python

PyBNF requires an installation of Python version 3.5 or higher.

Linux and Mac

Python 3 comes built-in on many new Linux and Mac operating systems. To check if you have Python 3, run the command python3. This will start Python and print the version number, or will give an error if you don’t have Python 3.

Also confirm that your Python 3 has the pip package manager, which is used to install PyBNF. Run the command python3 -m pip. This will give a help message if you have pip, or an error if not.

If you are missing python3 or pip, an easy way to get them is by installing the Anaconda Python distribution for Python v3.5 or higher. Instructions for installing on various platforms can be found on the Anaconda website.

Windows

Windows does not come with built-in Python, so it must be installed separately. Additionally, if BioNetGen will be used, Perl installation is required in the same environment as the python installation (i.e., the commands python and perl must both work on the same command line).

Our recommended configuration consists of installing Strawberry Perl and Anaconda Python 3. The Windows distribution of Anaconda includes the application “Anaconda Prompt”, which provides a command line. This is the command line that you should use whenever this documentation refers to the command line or terminal. After installing both Anaconda and Strawberry Perl, a system restart may be required for Anaconda Prompt to find the Perl installation.

For troubleshooting, or more advanced configuration, note that the requirement is to have both Python 3 and Perl on the current path. The current path can be checked with the command echo %PATH% and set (temporarily) with the command set PATH=[newpath], where [newpath] is a semicolon-delimited list of directories to search.

PyBNF

Installing from PyPI

Simply type the following in a terminal:

python3 -m pip install pybnf

Windows users running Anaconda Python 3 from “Anaconda Prompt” should instead type only pip install pybnf.

The above command will use your current version of Python 3 to install the most recent version of PyBNF released on the Python Package Index, along with all required dependencies.

Depending on your Python configuration, the above command may require root access and install PyBNF for all users on the computer. If you don’t want to do this, you may add the flag --user to the end of the command, to install without root access for only the current user.

Advanced Python users may consider installing PyBNF in a virtualenv (which also does not require root access) to avoid conflicts between PyBNF’s dependencies and other uses of Python on the computer.

Installing from source

To use bleeding edge PyBNF, the source code may be found on GitHub at https://github.com/lanl/PyBNF . To use, simply download or clone the repository and run the following command in the repository’s root directory:

python3 -m pip install -e .

This also allows developers to modify the source code while still having access to the commmand line functionality anywhere in the filesystem.

Installation of External Simulators

BioNetGen

PyBNF is designed to work with simulators present in the BioNetGen software suite, version 2.3, available for download from the BioNetGen website. Note that for Linux distributions other than Ubuntu, the pre-built binary is unreliable, and it is necessary to rebuild BioNetGen from source. For Windows, Perl must be installed separately, as described above. The current BioNetGen distribution includes support for both network-based simulations and network-free simulations.

PyBNF will need to know the location of BioNetGen – specifically the location of the script BNG2.pl within the BioNetGen installation. This path can be included in the PyBNF configuration file with the bng_command key. A convenient alternative is to set the environment variable BNGPATH to the BioNetGen directory using the following command:

export BNGPATH=/path/to/bng2

where /path/to/bng2 is the path to the folder containing BNG2.pl, not including the “BNG2.pl” file name. This setting may be made permanent as of your next login, by copying above command into the file .bash_profile in your home directory.

On Windows systems, the equivalent commands are set BNGPATH=C:\path\to\bng2 to set on the current command line, and setx BNGPATH C:\path\to\bng2 to permanently set for all future command lines (but not the current one).

SBML

PyBNF runs simulations of SBML models using libroadrunner, which is installed automatically through pip as part of PyBNF installation.

To work with SBML files, it is useful to install software such as COPASI that is capable of reading and writing models in SBML format.