Welcome to PhaseFieldX. documentation
The PhaseFieldX project is designed to simulate and analyze material behavior using phase-field models, which provide a continuous approximation of interfaces, phase boundaries, and discontinuities such as cracks. Leveraging the robust capabilities of FEniCSx, a renowned finite element framework for solving partial differential equations, this project facilitates efficient and precise numerical simulations. It supports a wide range of applications, including phase-field fracture, solidification, and other complex material phenomena, making it an invaluable resource for researchers and engineers in materials science.
The PhaseFieldX project aims to advance phase-field modeling through open-source contributions. By leveraging the powerful FEniCSx framework, our goal is to enhance and broaden the application of phase-field simulations across various domains of materials science and engineering. We strive to make these advanced simulation techniques more accessible, enabling researchers and engineers to conduct more accurate and comprehensive scientific investigations. Through collaborative efforts, our mission is to deepen understanding, foster innovation, and contribute to the broader scientific community’s pursuit of knowledge in complex material behaviors.
- Phase-Field Method: The code employs the phase-field method, a versatile mathematical framework for modeling phenomena such as fracture, phase transitions, and pattern formation as diffuse processes. It enables the simulation of complex behaviors and multiple interacting phenomena within a unified framework.
- FEniCSx Integration: Integrated with FEniCSx, a powerful finite element framework, the code provides robust capabilities for solving partial differential equations governing phase-field simulations. This integration ensures efficient computation and adaptive mesh refinement, enhancing simulation accuracy and scalability.
- User-Friendly Interface: Designed with usability in mind, the code features an intuitive interface for defining material properties, boundary conditions, and simulation parameters. This interface caters to both novice users and experienced researchers, facilitating straightforward setup and execution of simulations.
- Advanced Visualization: The code includes advanced visualization tools to depict simulation results effectively. These tools enable comprehensive analysis of crack propagation, stress distributions, and other key quantities, supporting insightful interpretations and comparisons across simulations.
To use this repository, you need to have the latest stable release of FEniCSx installed. The latest stable release of FEniCSx is version 0.9. 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:
Create a new conda environment
conda create -n phasefieldx-env
Activate the new environment
conda activate phasefieldx-env
Install FEniCSx, mpi4py, numpy, pandas, ... from the conda-forge channel:
conda install -c conda-forge fenics-dolfinx=0.9.0 mpi4py numpy pyvista pandas pyvista
Install gmsh
pip install --upgrade gmsh
Finally, install the code from this repository
pip install phasefieldx
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 detailed installation options and information, please visit the FEniCSx Project download page.
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
There are numerous examples available to demonstrate the usage of PhaseFieldX for various phase-field simulations. These examples cover different scenarios such as phase-field fracture, phase-field fatigue, and more complex material behavior simulations. Explore the examples in the documentation to learn more.
For detailed API documentation, including class references, function definitions, and usage examples, please refer to the API documentation.
We welcome contributions and feedback from the community to enhance the code's functionality, reliability, and user experience.To get started, please review our Contributing Guidelines to share your insights and collaborate with fellow developers.
Thank you for choosing our Phase-Field Fracture simulation code. We trust this tool will prove invaluable in advancing your understanding of fracture mechanics and its practical applications.