pygibbs 0.0.2
PyGibbs is a numerical library for simulations of field theories in Python.
License: MIT

![Imagel](https://raw.githubusercontent.com/rajeshrinet/pygibbs/master/examples/banner.jpg)

## PyGibbs: Field theoretic simulations in Python [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/rajeshrinet/pygibbs/master?filepath=examples) 
![Installation](https://github.com/rajeshrinet/pygibbs/workflows/Installation/badge.svg)
![Notebooks](https://github.com/rajeshrinet/pygibbs/workflows/Notebooks/badge.svg)
[![Documentation Status](https://readthedocs.org/projects/pygibbs/badge/?version=latest)](https://pygibbs.readthedocs.io/en/latest/?badge=latest)
[![PyPI version](https://badge.fury.io/py/pygibbs.svg)](https://badge.fury.io/py/pygibbs)
[![Downloads](https://pepy.tech/badge/pygibbs)](https://pepy.tech/project/pygibbs)
![License](https://img.shields.io/github/license/rajeshrinet/pygibbs) 

[About](#about) |  [Documentation](https://pygibbs.readthedocs.io/en/latest/) | [News](#news) | [Installation](#installation) | [Examples](#examples) | [Publications ](#publications)| [Support](#support) | [License](#license)


## About
[PyGibbs](https://github.com/rajeshrinet/pygibbs) is a numerical library for simulations of field theories in Python. The library constructs differentiation matrices using finite-difference and spectral methods. It also allows to solve Stokes equation using a spectral method, which satisfies compressibility exactly. The library currently offers support for doing field theoretical simulation and a direct numerical simulation of the Stokes equation (implementation for non-zero Reynolds number is planned) in both two and three space dimensions.
 
 
## News
* Our paper has been highlighted in the Journal Club for Condensed Matter Physics with a [commentary](https://doi.org/10.36471/JCCM_March_2020_01).


## Installation
Clone (or download) the repository and use a terminal to install using

```
>> git clone https://github.com/rajeshrinet/pygibbs.git
>> cd pygibbs
>> pip install -r requirements.txt
>> python setup.py install
``` 

PyGibbs requires the following software 


- Python 2.6+ or Python 3.4+
- [Cython 0.25.x+](http://docs.cython.org/en/latest/index.html) |  [Matplotlib 2.0.x+](https://matplotlib.org) | [NumPy 1.x+](http://www.numpy.org) | [SciPy 1.1.x+](https://www.scipy.org/) 

## Pip
Alternatively install latest PyPI version

```
>> pip install pygibbs 
```


## Examples

See the [examples folder](https://github.com/rajeshrinet/pygibbs/tree/master/examples) for a list of examples. 

## Publications
* [Hydrodynamically interrupted droplet growth in scalar active matter](https://doi.org/10.1103/PhysRevLett.123.148005). Rajesh Singh and Michael E. Cates. Phys. Rev. Lett. 123, 148005 (2019).

* [Self-propulsion of active droplets without liquid-crystalline order](https://arxiv.org/abs/2004.06064). Rajesh Singh, Elsen Tjhung, and Michael E. Cates. arXiv:2004.06064.  


## Support
Please use the [issue tracker](https://github.com/rajeshrinet/pygibbs/issues) on GitHub.

## License
We believe that openness and sharing improves the practice of science and increases the reach of its benefits. This code is released under the [MIT license](http://opensource.org/licenses/MIT). Our choice is guided by the excellent article on [Licensing for the scientist-programmer](http://www.ploscompbiol.org/article/info%3Adoi%2F10.1371%2Fjournal.pcbi.1002598).