Metadata-Version: 2.3
Name: phasefieldx
Version: 0.0.2
Summary: PhaseFieldX: An Open-Source Framework for Advanced Phase-Field Simulations
Project-URL: Homepage, https://github.com/CastillonMiguel/phasefieldx
Project-URL: Issues, https://github.com/CastillonMiguel/phasefieldx/issues
Author-email: Miguel Castillon <phasefieldx@gmail.com>
License-File: AUTHORS.rst
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/x-rst

PhaseFieldX
===========

.. image:: https://raw.githubusercontent.com/CastillonMiguel/phasefieldx/main/docs/source/_static/logo_name.png
   :target: https://phasefieldx.readthedocs.io/en/latest/index.html
   :alt: PhaseFieldX


Welcome to **PhaseFieldX**. `documentation <https://phasefieldx.readthedocs.io/en/latest/index.html>`_

Introduction
------------
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.


Purpose
-------
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.


Key Features
------------
- **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.


Installation Instructions
--------------------------
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. 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
   
   .. code-block::
   
      conda create -n phasefieldx-env

2. Activate the new environment
   
   .. code-block::
   
      conda activate phasefieldx-env

3. Install FEniCSx, `mpich`, `pyvista`, and `pandas` from the `conda-forge` channel:
   
   .. code-block::
   
      conda install -c conda-forge fenics-dolfinx mpich pyvista pandas

4. Install `gmsh`
   
   .. code-block::
   
      pip install --upgrade gmsh
   

5. Finally, install the code from this repository
   
   .. code-block::
   
      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 <https://fenicsproject.org/download/>`_.


Examples
--------
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 <https://phasefieldx.readthedocs.io/en/latest/index.html>`_ to learn more.


API Documentation
-----------------
For detailed API documentation, including class references, function definitions, and usage examples, please refer to the `API documentation <https://phasefieldx.readthedocs.io/en/latest/api/index.html>`_.


Contributions and Feedback
--------------------------
We welcome contributions and feedback from the community to enhance the code's functionality, reliability, and user experience. Engage with us through our `GitHub repository <https://github.com/CastillonMiguel/phasefieldx>`_ to share your insights.

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.
