Mango-Selm | Fluctuating Hydrodynamics

Mango-Selm: Fluid-Structure Interaction and Fluctuating Hydrodynamics Simulation Package

Now available with Jupyter Notebook and Python interfaces for readily setting up models and simulations, see git-hub page.

Mango-Selm is a package for performing fluid-structure interaction simulations in LAMMPS MD. The package includes methods for

hydrodyamic coupling between particles and microstructures handled though continuum stochastic fluid equations.
implicit-solvent coarse-grained simulations, for example colloids / polymers / membranes.
general fluid-structure interactions subject to thermal fluctuations (selms / immersed boundary models).
shear boundary conditions for micro-rheology studies, for example rheology of soft materials / complex fluids.
deterministic fluid-structure simulations are also possible by setting temperature parameter to zero.

Allows for SELM, Immersed Boundary Methods, and related hydrodynamic solvers to be used in conjunction with LAMMPS MD simulations. LAMMPS is a Molecular Dynamics (MD) package providing many interaction potentials and analysis tools for modeling and simulation. Interaction methods include particle-mesh electrostatics, common coarse-grained potentials, many-body interactions, and others.

Quick Start

To install for Python use

>> pip install selm-lammps

To test the package installed run

>> python -c "from selm_lammps.tests import t1; t1.test()"

This includes pre-compiled binaries for (Debian 9+ / Ubuntu x86_64 and Centos 7+ / Python 3.6+).

Examples (clone github):

>> git clone https://github.com/atzberg/mango-selm.git

See the git-hub page for models and scripts at [link].

Examples: Jupyter notebooks, python scripts, and models can be found at github/mango-selm.

Other ways to install the package For running prototype models and simulations on a desktop, such as Windows and MacOS, we recommend using Docker container. For example, install Docker Desktop or docker for linux and then load a standard ubuntu container by using in the terminal "docker run -it ubuntu:20.04 /bin/bash". You then use "apt update; apt install python3-pip", and can then pip install and run the simulation package as above. Note use command "python3" in place of "python" when calling scripts.

The source package and additional binaries are available on the download page.

For more information on other ways to install or compile the package, please see the document page.

Git-Hub Page: github: mango-selm

Related Talks:

Tutorial for Mango-Selm Package: How to Setup the Models and Simulations using Jupyter Notebooks and Python.
Interactive Session
Fluid-Structure Interaction Modeling and Simulation

Download Mango-Selm Package

Slides: [PDF]

Package Details:

The Mango-Selm package has been implemented using a combination of programming languages including Python, Java, and C++. Jupyter notebook integration for setting up models and simulations using python is also provided. The core SELM package is implemented in C++ and uses data files represented using standardized formats, such as XML and VTK. The SELM package is integrated with LAMMPS. LAMMPS is a dynamics package for modeling mechanical systems and provides common force laws, different types of degrees of freedom, and statistical analysis methods. Mango-Selm (USER-SELM) allows for using these capabilities when performing fluctuating hydrodynamics simulations.

Mango is a user interface for the specification of simulation models and numerical parameters. MANGO can be used to setup models and simulations for the SELM package.

MANGO provides a platform independent graphical user interface using the Java programming language. MANGO allows for the graphical specification of the model geometry, solution domain, force interactions, and numerical integration parameters. For basic models, MANGO graphical interface can be used. For more complicated models, the python interface can be used.

Python / Jython To allow for a programmatic specification of models and simulations, Python-based scripts have been developed. This allows for model specifications leveraging standard packages. This has also been incorporated into the MANGO interface using Jython. Jython scripts also allow for extending the capabilities of the interface with customized control panels for new features.

References:

When reporting results using this package, please cite

Fluctuating Hydrodynamics Methods for Dynamic Coarse-Grained Implicit-Solvent Simulations in LAMMPS, Y. Wang, J. K. Sigurdsson, and P.J. Atzberger, SIAM J. Sci. Comp., 38(5), S62�S77, (2016) [preprint] [paper link]

@article{atz_selm_lammps_fluct_hydro,
title = {Fluctuating Hydrodynamics Methods for Dynamic Coarse-Grained Implicit-Solvent Simulations in LAMMPS},
author = {Wang, Y. and Sigurdsson, J. K. and Atzberger, P. J.},
journal = {SIAM Journal on Scientific Computing},
volume = {38},
number = {5},
pages = {S62-S77},
year = {2016},
doi = {10.1137/15M1026390},
URL = {https://doi.org/10.1137/15M1026390},
}

@article{atz_selm_shear_methods,
title = {Incorporating shear into stochastic Eulerian{\textendash}Lagrangian 
         methods for rheological studies of complex fluids and soft materials},
author = {Paul J. Atzberger},
journal = {Physica D: Nonlinear Phenomena},
publisher = {Elsevier {BV}},
volume = {265},
pages = {57--70},
year = {2013},
doi = {10.1016/j.physd.2013.09.002},
url = {https://doi.org/10.1016%2Fj.physd.2013.09.002},
}