Installation manual

To use this repository, you need to have the latest stable release of FEniCSx installed. The latest stable release of FEniCSx is version 0.8, which was released in April 2024. The easiest way to start using FEniCSx on MacOS and other systems is to install it using conda.

Follow these steps to set up your environment:

1. Create a new conda environment:

   conda create -n phasefieldx-env
   

2. Activate the new environment:

   conda activate phasefieldx-env
   

3. Install FEniCSx, mpi4py, numpy, pandas, … from the conda-forge channel:

   conda install -c conda-forge fenics-dolfinx=0.10.0 scifem mpi4py numpy pyvista pandas pyvista
   

4. Install gmsh

   pip install --upgrade gmsh
   

5. Finally, install the code from this repository:

   pip install phasefieldx
   

Note

For functionalities related to image post-processing, such as crack measurement, additional dependencies are required. You can install them using pip:

pip install imageio scikit-image

These steps will set up all the necessary dependencies for running the code in this repository. Make sure to activate the phasefieldx-env environment whenever you work with this project.

For more information and additional installation options, please visit the [FEniCSx Project download page](https://fenicsproject.org/download/).

We also provide a pre-built docker image with FEniCSx and phasefieldx installed. You pull this image using the command

docker pull ghcr.io/castillonmiguel/phasefieldx:main