.. |.changelog| replace:: Change Log
.. _.changelog: https://pages.nist.gov/fipy/en/latest/CHANGELOG.html#changelog
.. |.examples.diffusion.mesh1D| replace:: ``examples.diffusion.mesh1D``
.. _.examples.diffusion.mesh1D: https://github.com/usnistgov/fipy/blob/4d751fba3419f47e65c5e8ccd810bbeb4c58ae39/examples/diffusion/mesh1D.py
.. |.faq| replace:: Frequently Asked Questions
.. _.faq: https://pages.nist.gov/fipy/en/latest/FAQ.html#faq
.. |.FiPy| replace:: FiPy
.. _.FiPy: https://pages.nist.gov/fipy/en/latest/glossary.html#term-FiPy
.. |.installation| replace:: Installation
.. _.installation: https://pages.nist.gov/fipy/en/latest/INSTALLATION.html#installation
.. |.Python| replace:: Python
.. _.Python: https://pages.nist.gov/fipy/en/latest/glossary.html#term-Python
.. |.usage| replace:: Using FiPy
.. _.usage: https://pages.nist.gov/fipy/en/latest/USAGE.html#usage
========
Overview
========
| |Tests|_ |Documentation|_ |nix|_
| |GitHub|_ |PyPI|_ |CondaForge|_ |Binder|_
| |gitter|_ |OpenHub|_
|.FiPy|_ is an object oriented, partial differential equation (PDE)
solver, written in |.Python|_, based on a standard finite volume
(FV) approach. The framework has been developed in the Materials Science
and Engineering Division (MSED_) and Center for Theoretical and
Computational Materials Science (CTCMS_), in the Material Measurement
Laboratory (MML_) at the National Institute of Standards and Technology
(NIST_).
The solution of coupled sets of PDEs is ubiquitous to the numerical
simulation of science problems. Numerous PDE solvers exist, using a
variety of languages and numerical approaches. Many are proprietary,
expensive and difficult to customize. As a result, scientists spend
considerable resources repeatedly developing limited tools for
specific problems. Our approach, combining the FV method and |.Python|_,
provides a tool that is extensible, powerful and freely available. A
significant advantage to |.Python|_ is the existing suite of tools for
array calculations, sparse matrices and data rendering.
The |.FiPy|_ framework includes terms for transient diffusion,
convection and standard sources, enabling the solution of arbitrary
combinations of coupled elliptic, hyperbolic and parabolic PDEs. Currently
implemented models include phase field `BoettingerReview:2002`
`ChenReview:2002` `McFaddenReview:2002` treatments of polycrystalline,
dendritic, and electrochemical phase transformations, as well as drug
eluting stents `Saylor:2011p2794`, reactive wetting `PhysRevE.82.051601`,
photovoltaics `Hangarter:2011p2795` and a level set treatment of the
electrodeposition process `NIST:damascene:2001`.
The latest information about |.FiPy|_ can be found at
http://www.ctcms.nist.gov/fipy/.
See the latest updates in the |.changelog|_.
---------------------------------
Even if you don't read manuals...
---------------------------------
...please read |.installation|_, |.usage|_ and |.faq|_, as well
as |.examples.diffusion.mesh1D|_.
-------------------------
Download and Installation
-------------------------
Please refer to |.installation|_ for details on download and
installation. |.FiPy|_ can be redistributed and/or modified
freely, provided that any derivative works bear some notice that they
are derived from it, and any modified versions bear some notice that
they have been modified.
-------
Support
-------
We offer several modes to communicate with the |.FiPy|_ developers and
with other users.
* `Contact <https://pages.nist.gov/fipy/en/latest/CONTACT.html>`_
* `GitHub Discussions <https://pages.nist.gov/fipy/en/latest/CONTACT.html#github-discussions>`_
* `GitHub Issues <https://pages.nist.gov/fipy/en/latest/CONTACT.html#github-issues>`_
* `StackOverflow <https://pages.nist.gov/fipy/en/latest/CONTACT.html#stackoverflow>`_
* `Mailing List <https://pages.nist.gov/fipy/en/latest/CONTACT.html#mailing-list>`_
* `List Archive <https://pages.nist.gov/fipy/en/latest/CONTACT.html#list-archive>`_
|
We welcome collaborative efforts on this project.
------------------------
Conventions and Notation
------------------------
|.FiPy|_ is driven by |.Python|_ script files than you can view or modify in any
text editor. |.FiPy|_ sessions are invoked from a command-line shell, such
as `tcsh` or `bash`.
Throughout, text to be typed at the keyboard will appear ``like this``.
Commands to be issued from an interactive shell will appear::
$ like this
where you would enter the text ("``like this``") following the shell prompt,
denoted by "``$``".
Text blocks of the form::
>>> a = 3 * 4
>>> a
12
>>> if a == 12:
... print "a is twelve"
...
a is twelve
are intended to indicate an interactive session in the |.Python|_ interpreter.
We will refer to these as "interactive sessions" or as "doctest blocks".
The text "``>>>``" at the beginning of a line denotes the *primary prompt*,
calling for input of a |.Python|_ command. The text "``...``" denotes the
*secondary prompt*, which calls for input that continues from the line
above, when required by |.Python|_ syntax. All remaining lines, which begin
at the left margin, denote output from the |.Python|_ interpreter. In all
cases, the prompt is supplied by the |.Python|_ interpreter and should not be
typed by you.
.. list-table::
:header-rows: 1
* - 🚩 Warning
* - |.Python|_ is sensitive to indentation and care should be taken to enter
text exactly as it appears in the examples.
When references are made to file system paths, it is assumed that the
current working directory is the |.FiPy|_ distribution directory, referred to
as the "base directory", such that::
examples/diffusion/steadyState/mesh1D.py
will correspond to, *e.g.*::
/some/where/FiPy-X.Y/examples/diffusion/steadyState/mesh1D.py
Paths will always be rendered using POSIX conventions (path elements
separated by "``/``"). Any references of the form::
examples.diffusion.steadyState.mesh1D
are in the |.Python|_ module notation and correspond to the equivalent POSIX
path given above.
We may at times use a
.. list-table::
:header-rows: 1
* - 📝 Note
* - to indicate something that may be of interest
or a
.. list-table::
:header-rows: 1
* - 🚩 Warning
* - to indicate something that could cause serious problems.
.. _MML: http://www.nist.gov/mml/
.. _CTCMS: http://www.ctcms.nist.gov/
.. _MSED: http://www.nist.gov/mml/msed/
.. _NIST: http://www.nist.gov/
.. |GitHub| image:: https://img.shields.io/github/contributors/usnistgov/fipy.svg
.. _GitHub: https://github.com/usnistgov/fipy
.. |gitter| image:: https://badges.gitter.im/usnistgov/fipy.svg
.. _gitter: https://gitter.im/usnistgov/fipy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge
.. |Tests| image:: https://dev.azure.com/guyer/FiPy/_apis/build/status/usnistgov.fipy?branchName=master
.. _Tests: https://dev.azure.com/guyer/FiPy/_build?definitionId=2
.. |Documentation| image:: https://github.com/usnistgov/fipy/actions/workflows/Docs4NIST.yml/badge.svg
.. _Documentation: https://github.com/usnistgov/fipy/actions/workflows/Docs4NIST.yml
.. |nix| image:: https://github.com/usnistgov/fipy/actions/workflows/nix.yml/badge.svg
.. _nix: https://github.com/usnistgov/fipy/actions/workflows/nix.yml
.. |OpenHub| image:: https://www.openhub.net/p/fipy/widgets/project_thin_badge.gif
.. _OpenHub: https://www.openhub.net/p/fipy
.. |PyPI| image:: https://img.shields.io/pypi/v/fipy.svg
.. _PyPI: https://pypi.python.org/pypi/FiPy
.. |CondaForge| image:: https://img.shields.io/conda/pn/conda-forge/fipy?label=conda-forge
.. _CondaForge: https://anaconda.org/conda-forge/fipy
.. |Binder| image:: https://mybinder.org/badge.svg
.. _Binder: https://mybinder.org/v2/gh/usnistgov/fipy/master?filepath=examples%2Findex.ipynb
Raw data
{
"_id": null,
"home_page": null,
"name": "FiPy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Jonathan Guyer, Daniel Wheeler, Jim Warren",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/77/5b/38049e5b5765804f8dab1faf0ca392f8678bf73398ed3882ee34b8f65416/fipy-4.0.1.tar.gz",
"platform": null,
"description": ".. |.changelog| replace:: Change Log\n.. _.changelog: https://pages.nist.gov/fipy/en/latest/CHANGELOG.html#changelog\n.. |.examples.diffusion.mesh1D| replace:: ``examples.diffusion.mesh1D``\n.. _.examples.diffusion.mesh1D: https://github.com/usnistgov/fipy/blob/4d751fba3419f47e65c5e8ccd810bbeb4c58ae39/examples/diffusion/mesh1D.py\n.. |.faq| replace:: Frequently Asked Questions\n.. _.faq: https://pages.nist.gov/fipy/en/latest/FAQ.html#faq\n.. |.FiPy| replace:: FiPy\n.. _.FiPy: https://pages.nist.gov/fipy/en/latest/glossary.html#term-FiPy\n.. |.installation| replace:: Installation\n.. _.installation: https://pages.nist.gov/fipy/en/latest/INSTALLATION.html#installation\n.. |.Python| replace:: Python\n.. _.Python: https://pages.nist.gov/fipy/en/latest/glossary.html#term-Python\n.. |.usage| replace:: Using FiPy\n.. _.usage: https://pages.nist.gov/fipy/en/latest/USAGE.html#usage\n\n\n========\nOverview\n========\n\n\n\n| |Tests|_ |Documentation|_ |nix|_\n| |GitHub|_ |PyPI|_ |CondaForge|_ |Binder|_\n| |gitter|_ |OpenHub|_\n\n|.FiPy|_ is an object oriented, partial differential equation (PDE)\nsolver, written in |.Python|_, based on a standard finite volume\n(FV) approach. The framework has been developed in the Materials Science\nand Engineering Division (MSED_) and Center for Theoretical and\nComputational Materials Science (CTCMS_), in the Material Measurement\nLaboratory (MML_) at the National Institute of Standards and Technology\n(NIST_).\n\nThe solution of coupled sets of PDEs is ubiquitous to the numerical\nsimulation of science problems. Numerous PDE solvers exist, using a\nvariety of languages and numerical approaches. Many are proprietary,\nexpensive and difficult to customize. As a result, scientists spend\nconsiderable resources repeatedly developing limited tools for\nspecific problems. Our approach, combining the FV method and |.Python|_,\nprovides a tool that is extensible, powerful and freely available. A\nsignificant advantage to |.Python|_ is the existing suite of tools for\narray calculations, sparse matrices and data rendering.\n\nThe |.FiPy|_ framework includes terms for transient diffusion,\nconvection and standard sources, enabling the solution of arbitrary\ncombinations of coupled elliptic, hyperbolic and parabolic PDEs. Currently\nimplemented models include phase field `BoettingerReview:2002`\n`ChenReview:2002` `McFaddenReview:2002` treatments of polycrystalline,\ndendritic, and electrochemical phase transformations, as well as drug\neluting stents `Saylor:2011p2794`, reactive wetting `PhysRevE.82.051601`,\nphotovoltaics `Hangarter:2011p2795` and a level set treatment of the\nelectrodeposition process `NIST:damascene:2001`.\n\nThe latest information about |.FiPy|_ can be found at\nhttp://www.ctcms.nist.gov/fipy/.\n\nSee the latest updates in the |.changelog|_.\n\n---------------------------------\nEven if you don't read manuals...\n---------------------------------\n\n...please read |.installation|_, |.usage|_ and |.faq|_, as well\nas |.examples.diffusion.mesh1D|_.\n\n-------------------------\nDownload and Installation\n-------------------------\n\nPlease refer to |.installation|_ for details on download and\ninstallation. |.FiPy|_ can be redistributed and/or modified\nfreely, provided that any derivative works bear some notice that they\nare derived from it, and any modified versions bear some notice that\nthey have been modified.\n\n-------\nSupport\n-------\n\nWe offer several modes to communicate with the |.FiPy|_ developers and\nwith other users.\n\n* `Contact <https://pages.nist.gov/fipy/en/latest/CONTACT.html>`_\n\n * `GitHub Discussions <https://pages.nist.gov/fipy/en/latest/CONTACT.html#github-discussions>`_\n * `GitHub Issues <https://pages.nist.gov/fipy/en/latest/CONTACT.html#github-issues>`_\n * `StackOverflow <https://pages.nist.gov/fipy/en/latest/CONTACT.html#stackoverflow>`_\n * `Mailing List <https://pages.nist.gov/fipy/en/latest/CONTACT.html#mailing-list>`_\n\n * `List Archive <https://pages.nist.gov/fipy/en/latest/CONTACT.html#list-archive>`_\n\n\n\n |\n\n\n\nWe welcome collaborative efforts on this project.\n\n------------------------\nConventions and Notation\n------------------------\n\n|.FiPy|_ is driven by |.Python|_ script files than you can view or modify in any\ntext editor. |.FiPy|_ sessions are invoked from a command-line shell, such\nas `tcsh` or `bash`.\n\nThroughout, text to be typed at the keyboard will appear ``like this``.\nCommands to be issued from an interactive shell will appear::\n\n $ like this\n\nwhere you would enter the text (\"``like this``\") following the shell prompt,\ndenoted by \"``$``\".\n\nText blocks of the form::\n\n >>> a = 3 * 4\n >>> a\n 12\n >>> if a == 12:\n ... print \"a is twelve\"\n ...\n a is twelve\n\nare intended to indicate an interactive session in the |.Python|_ interpreter.\nWe will refer to these as \"interactive sessions\" or as \"doctest blocks\".\nThe text \"``>>>``\" at the beginning of a line denotes the *primary prompt*,\ncalling for input of a |.Python|_ command. The text \"``...``\" denotes the\n*secondary prompt*, which calls for input that continues from the line\nabove, when required by |.Python|_ syntax. All remaining lines, which begin\nat the left margin, denote output from the |.Python|_ interpreter. In all\ncases, the prompt is supplied by the |.Python|_ interpreter and should not be\ntyped by you.\n\n\n.. list-table::\n :header-rows: 1\n \n * - \ud83d\udea9 Warning\n * - |.Python|_ is sensitive to indentation and care should be taken to enter\n text exactly as it appears in the examples.\n\n\nWhen references are made to file system paths, it is assumed that the\ncurrent working directory is the |.FiPy|_ distribution directory, referred to\nas the \"base directory\", such that::\n\n examples/diffusion/steadyState/mesh1D.py\n\nwill correspond to, *e.g.*::\n\n /some/where/FiPy-X.Y/examples/diffusion/steadyState/mesh1D.py\n\nPaths will always be rendered using POSIX conventions (path elements\nseparated by \"``/``\"). Any references of the form::\n\n examples.diffusion.steadyState.mesh1D\n\nare in the |.Python|_ module notation and correspond to the equivalent POSIX\npath given above.\n\nWe may at times use a\n\n\n.. list-table::\n :header-rows: 1\n \n * - \ud83d\udcdd Note\n * - to indicate something that may be of interest\n\n\nor a\n\n\n.. list-table::\n :header-rows: 1\n \n * - \ud83d\udea9 Warning\n * - to indicate something that could cause serious problems.\n\n\n.. _MML: http://www.nist.gov/mml/\n.. _CTCMS: http://www.ctcms.nist.gov/\n.. _MSED: http://www.nist.gov/mml/msed/\n.. _NIST: http://www.nist.gov/\n\n.. |GitHub| image:: https://img.shields.io/github/contributors/usnistgov/fipy.svg\n.. _GitHub: https://github.com/usnistgov/fipy\n.. |gitter| image:: https://badges.gitter.im/usnistgov/fipy.svg\n.. _gitter: https://gitter.im/usnistgov/fipy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge\n.. |Tests| image:: https://dev.azure.com/guyer/FiPy/_apis/build/status/usnistgov.fipy?branchName=master\n.. _Tests: https://dev.azure.com/guyer/FiPy/_build?definitionId=2\n.. |Documentation| image:: https://github.com/usnistgov/fipy/actions/workflows/Docs4NIST.yml/badge.svg\n.. _Documentation: https://github.com/usnistgov/fipy/actions/workflows/Docs4NIST.yml\n.. |nix| image:: https://github.com/usnistgov/fipy/actions/workflows/nix.yml/badge.svg\n.. _nix: https://github.com/usnistgov/fipy/actions/workflows/nix.yml\n.. |OpenHub| image:: https://www.openhub.net/p/fipy/widgets/project_thin_badge.gif\n.. _OpenHub: https://www.openhub.net/p/fipy\n.. |PyPI| image:: https://img.shields.io/pypi/v/fipy.svg\n.. _PyPI: https://pypi.python.org/pypi/FiPy\n.. |CondaForge| image:: https://img.shields.io/conda/pn/conda-forge/fipy?label=conda-forge\n.. _CondaForge: https://anaconda.org/conda-forge/fipy\n\n.. |Binder| image:: https://mybinder.org/badge.svg\n.. _Binder: https://mybinder.org/v2/gh/usnistgov/fipy/master?filepath=examples%2Findex.ipynb\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A finite volume PDE solver in Python",
"version": "4.0.1",
"project_urls": {
"Homepage": "https://github.com/usnistgov/fipy",
"Issues": "https://github.com/usnistgov/fipy/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "44dd65fbf45784466652b4559528bfafc511ac66f65c44e6ad2b092db53377a6",
"md5": "146f31e59fda721dec822a197750eb93",
"sha256": "5fdb30aaf349f31445cbe82e2159b1f8881e9a81ee7d8d96b262730ace41c62f"
},
"downloads": -1,
"filename": "fipy-4.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "146f31e59fda721dec822a197750eb93",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 449001,
"upload_time": "2025-09-16T18:35:27",
"upload_time_iso_8601": "2025-09-16T18:35:27.630333Z",
"url": "https://files.pythonhosted.org/packages/44/dd/65fbf45784466652b4559528bfafc511ac66f65c44e6ad2b092db53377a6/fipy-4.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "775b38049e5b5765804f8dab1faf0ca392f8678bf73398ed3882ee34b8f65416",
"md5": "152f9845e11071ff05e317a8fb998fb8",
"sha256": "5f233591990189a09846012df478059fd1c91ff412e9291c831915a48141dfae"
},
"downloads": -1,
"filename": "fipy-4.0.1.tar.gz",
"has_sig": false,
"md5_digest": "152f9845e11071ff05e317a8fb998fb8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 20155756,
"upload_time": "2025-09-16T18:35:29",
"upload_time_iso_8601": "2025-09-16T18:35:29.594705Z",
"url": "https://files.pythonhosted.org/packages/77/5b/38049e5b5765804f8dab1faf0ca392f8678bf73398ed3882ee34b8f65416/fipy-4.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-16 18:35:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "usnistgov",
"github_project": "fipy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "fipy"
}
JSON
