PyGL: statistical field theory in Python

About | Documentation | News | Installation | Examples | Publications | Support | License

About

PyGL is a numerical library for statistical field theory in Python. The name GL corresponds to the Ginzburg–Landau theory. The library has been specifically designed to study field theories without time-reversal symmetry. The library can be used to study models of statistical physics of various symmetries and conservation laws. In particular, we allow models with mass and momentum conservations. The library constructs differentiation matrices using finite-difference and spectral methods. To study the role of momentum conservation, the library also allows computing fluid flow from the solution of the Stokes equation.

Installation

From a checkout of this repository

Install PyGL and required dependencies using

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

Install PyGL and its dependencies in a pygl environment:

>> git clone https://github.com/rajeshrinet/pygl.git
>> cd pygl
>> make env
>> conda activate pygl
>> make

Pip

Alternatively, install the latest PyPI version

>> pip install pygl 

Examples

See the examples folder for a list of examples.

Publications

• Hydrodynamically interrupted droplet growth in scalar active matter. Rajesh Singh and Michael E. Cates. Phys. Rev. Lett. 123, 148005 (2019).

• Self-propulsion of active droplets without liquid-crystalline order. Rajesh Singh, Elsen Tjhung, and Michael E. Cates. Phys. Rev. Research 2, 032024(R) (2020).

News

• Our paper has been highlighted in the Journal Club for Condensed Matter Physics with a commentary.

Support

Please use the issue tracker 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. Our choice is guided by the excellent article on Licensing for the scientist-programmer.