AMMBER-PRISMS-PF

AMMBER-PRISMS-PF is an open-source suite of multi-component, multi-phase-field model implementations with a simple, flexible interface for defining a system of thermodynamic and kinetic parameters.

AMMBER-PRISMS-PF Features:

  • Open-source
  • Multi-component
  • Multi-phase
  • Simple, flexible input file
  • Automatic parameter selection
  • High-performance Code
  • Adaptive Mesh Refinement (AMR)

Quick Start Guide

Install:

AMMBER-PRISMS-PF can be installed on Linux and MacOS.
In the terminal, clone this repository and its submodule, and navigate inside.

git clone --recurse-submodules https://github.com/UMThorntonGroup/AMMBER-PRISMS-PF.git
cd AMMBER-PRISMS-PF

If you have already cloned the repository without the submodule, you can run

git submodule update --init --recursive

to initialize it.

Next, you will need to install the PRISMS-PF library included as a submodule. For more information on installing PRISMS-PF and its dependencies, see https://prisms-center.github.io/phaseField/doxygen/install.html.

If you already have the dependencies installed, you can run

cd phaseField
cmake .
make -j <nprocs>

or simply, make.

pip install ammber

Running an application

Each application in this suite has a more detailed README, explaining how to use each model. PRISMS-PF also has documentation explaining the requirements of an app. To run an application without any modifications, you just need to navigate to the application directory and compile first. For example:

cd grandPotential-paraboloid
cmake .
make -j <nprocs>

Next, you can run the simulation in parallel using

mpirun -n <nprocs> ./main

(nprocs=8 for most desktops) or just ./main for serial.

Visualization:

Output of the fields is in standard vtk format (parallel:.pvtu, serial:.vtu files) which can be visualized with the following open source applications:

  1. VisIt
  2. Paraview

License:

GNU Lesser General Public License (LGPL).

Links

AMMBER-PRISMS-PF Repository
AMMBER_python Repository
PRISMS-PF Homepage
PRISMS-PF Repository
PRISMS-PF User Forum