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
.
Recommended: Install AMMBER_python
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:
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