leedaga / pygl Goto Github PK

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

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.

The above simulation is done using PyGL. It shows steady-state microphase separation (phase separation arrested to a length-scale) in an active scalar field theory. A self-shearing instability interrupts the growth of droplets by splitting them. Read more: https://arxiv.org/abs/1907.04819

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

Alternatively, install the latest PyPI version

>> pip install pygl 

See the examples folder for a list of examples.

• 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).

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

Please use the issue tracker on GitHub.

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.