| Name | phasefieldx JSON |
| Version |
0.0.6
JSON |
| download |
| home_page | None |
| Summary | PhaseFieldX: An Open-Source Framework for Advanced Phase-Field Simulations |
| upload_time | 2024-10-30 10:07:02 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT License Copyright (c) 2023, Miguel Castillón Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
allen cahn
fatigue
finite element
fracture
phase field
phase-field
solidification
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
gmsh
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
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>`_
.. image:: https://readthedocs.org/projects/phasefieldx/badge/?version=latest
:target: https://phasefieldx.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://img.shields.io/pypi/v/phasefieldx
:target: https://pypi.org/project/phasefieldx/
:alt: PyPI Version
.. image:: https://img.shields.io/pypi/dm/phasefieldx.svg?label=Pypi%20downloads
:target: https://pypi.org/project/phasefieldx/
:alt: PyPI Downloads
.. image:: https://img.shields.io/github/license/CastillonMiguel/phasefieldx
:target: https://github.com/CastillonMiguel/phasefieldx/blob/main/LICENSE
:alt: License
.. image:: https://joss.theoj.org/papers/7111b621625200b3d2c4b199ea9568c0/status.svg
:target: https://joss.theoj.org/papers/7111b621625200b3d2c4b199ea9568c0
:alt: Joss
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, `mpi4py`, `numpy`, `pandas`, ... from the `conda-forge` channel:
.. code-block:: sh
conda install -c conda-forge fenics-dolfinx=0.9.0 mpi4py numpy pyvista pandas pyvista
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.To get started, please review our `Contributing Guidelines <https://phasefieldx.readthedocs.io/en/latest/extras/DeveloperNotes/main.html>`_ 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.
Raw data
{
"_id": null,
"home_page": null,
"name": "phasefieldx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "allen cahn, fatigue, finite element, fracture, phase field, phase-field, solidification",
"author": null,
"author_email": "Miguel Castillon <phasefieldx@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/ff/8b/1126a93b33c2ef59868baac4fc87a63d926885a4eb5704ff1a15268f5572/phasefieldx-0.0.6.tar.gz",
"platform": null,
"description": "PhaseFieldX\n===========\n\n.. image:: https://raw.githubusercontent.com/CastillonMiguel/phasefieldx/main/docs/source/_static/logo_name.png\n :target: https://phasefieldx.readthedocs.io/en/latest/index.html\n :alt: PhaseFieldX\n\n\nWelcome to **PhaseFieldX**. `documentation <https://phasefieldx.readthedocs.io/en/latest/index.html>`_\n\n.. image:: https://readthedocs.org/projects/phasefieldx/badge/?version=latest\n :target: https://phasefieldx.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n \n.. image:: https://img.shields.io/pypi/v/phasefieldx\n :target: https://pypi.org/project/phasefieldx/\n :alt: PyPI Version\n\n.. image:: https://img.shields.io/pypi/dm/phasefieldx.svg?label=Pypi%20downloads\n :target: https://pypi.org/project/phasefieldx/\n :alt: PyPI Downloads\n\n.. image:: https://img.shields.io/github/license/CastillonMiguel/phasefieldx\n :target: https://github.com/CastillonMiguel/phasefieldx/blob/main/LICENSE\n :alt: License\n\n.. image:: https://joss.theoj.org/papers/7111b621625200b3d2c4b199ea9568c0/status.svg\n :target: https://joss.theoj.org/papers/7111b621625200b3d2c4b199ea9568c0\n :alt: Joss\n \n\nIntroduction\n------------\nThe **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.\n\n\nPurpose\n-------\nThe **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\u2019s pursuit of knowledge in complex material behaviors.\n\n\nKey Features\n------------\n- **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.\n\n- **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.\n \n- **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.\n\n- **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.\n\n\nInstallation Instructions\n--------------------------\nTo 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`.\n\nFollow these steps to set up your environment:\n\n1. Create a new conda environment\n \n .. code-block::\n \n conda create -n phasefieldx-env\n\n2. Activate the new environment\n \n .. code-block::\n \n conda activate phasefieldx-env\n\n3. Install FEniCSx, `mpi4py`, `numpy`, `pandas`, ... from the `conda-forge` channel:\n \n .. code-block:: sh\n \n conda install -c conda-forge fenics-dolfinx=0.9.0 mpi4py numpy pyvista pandas pyvista\n\n4. Install `gmsh`\n \n .. code-block::\n \n pip install --upgrade gmsh\n \n\n5. Finally, install the code from this repository\n \n .. code-block::\n \n pip install phasefieldx\n\n\nThese 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.\n\nFor more detailed installation options and information, please visit the `FEniCSx Project download page <https://fenicsproject.org/download/>`_.\n\n\nExamples\n--------\nThere 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.\n\n\nAPI Documentation\n-----------------\nFor 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>`_.\n\n\nContributions and Feedback\n--------------------------\nWe 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 <https://phasefieldx.readthedocs.io/en/latest/extras/DeveloperNotes/main.html>`_ to share your insights and collaborate with fellow developers.\n\nThank 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.\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2023, Miguel Castill\u00f3n Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "PhaseFieldX: An Open-Source Framework for Advanced Phase-Field Simulations",
"version": "0.0.6",
"project_urls": {
"Documentation": "https://phasefieldx.readthedocs.io",
"Homepage": "https://github.com/CastillonMiguel/phasefieldx",
"Issues": "https://github.com/CastillonMiguel/phasefieldx/issues"
},
"split_keywords": [
"allen cahn",
" fatigue",
" finite element",
" fracture",
" phase field",
" phase-field",
" solidification"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9172a0982f88f8105db93f682a96475774e14b86ff17a0cf1b3b5da520ca26f5",
"md5": "940deb8166251765aa7e1af8409aa52a",
"sha256": "c1fc4bac1edda43638c9eede63c4ddff5f4d838bfee00babbcd2c7a2b446cae7"
},
"downloads": -1,
"filename": "phasefieldx-0.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "940deb8166251765aa7e1af8409aa52a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 55744,
"upload_time": "2024-10-30T10:06:59",
"upload_time_iso_8601": "2024-10-30T10:06:59.040942Z",
"url": "https://files.pythonhosted.org/packages/91/72/a0982f88f8105db93f682a96475774e14b86ff17a0cf1b3b5da520ca26f5/phasefieldx-0.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ff8b1126a93b33c2ef59868baac4fc87a63d926885a4eb5704ff1a15268f5572",
"md5": "9d2bc726438d310e170c79fc85b99b82",
"sha256": "91a33ca2ff3e5ec4c2e58ba48f45230a1c98660a90864db9053584826c02b5b9"
},
"downloads": -1,
"filename": "phasefieldx-0.0.6.tar.gz",
"has_sig": false,
"md5_digest": "9d2bc726438d310e170c79fc85b99b82",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 32364430,
"upload_time": "2024-10-30T10:07:02",
"upload_time_iso_8601": "2024-10-30T10:07:02.172136Z",
"url": "https://files.pythonhosted.org/packages/ff/8b/1126a93b33c2ef59868baac4fc87a63d926885a4eb5704ff1a15268f5572/phasefieldx-0.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-30 10:07:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CastillonMiguel",
"github_project": "phasefieldx",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "gmsh",
"specs": []
}
],
"lcname": "phasefieldx"
}
