pigreads 0.4.5.dev0

Python-integrated GPU-enabled reaction-diffusion solver

Pigreads

Pigreads stands for Python-integrated GPU-enabled reaction-diffusion solver.

Getting started

Requirements

Pigreads uses OpenCL for calculations on the graphics cards. OpenCL is usually included in the drivers for your graphics card. The following pages may help installing and accessing OpenCL:

• ArchWiki: OpenCL on Arch Linux
• OpenCL-Guide: OpenCL on Ubuntu Linux
• OpenCL-Guide: OpenCL on Windows

You can use clinfo to verify you have an OpenCL platform installed.

If instead of the GPU, you want to use CPUs, you can install PoCL as an OpenCL platform to compute on the main processors.

To compile and use the module, you may also need to install the following tools:

• Python with the pip package manager
• CMake
• GNU Make
• GNU C++ compiler

Installation

Install this Python package in the standard way using pip, for instance from PyPI or from a local copy of this repository, see the Python documentation for details. For the command line interface (CLI), also install the optional dependency cli:

$ pip install pigreads[cli] # from PyPI
$ pip install .[cli] # from current directory

Usage

Simulations can be performed via calls to the Python module (API) or using the CLI. See the API and CLI sections in the documentation for annotated examples, or the examples directory in the Pigreads repository.