PyFluent documentation 0.11.0#


Ansys Fluent is a state-of-the-art computational fluid dynamics (CFD) software package for modeling fluid flow, heat transfer, and chemical reactions in complex geometries.

Fluent provides complete mesh flexibility, including the ability to solve your flow problems using unstructured meshes that can be generated about complex geometries with relative ease. Supported mesh types include:

  • 2D triangular and quadrilateral

  • 3D tetrahedral, hexahedral, pyramid, wedge, and polyhedral

  • Mixed (hybrid)

Fluent also enables you to refine or coarsen your mesh based on the flow solution.

You can read your mesh into Fluent or, for 3D geometries, create your mesh using Fluent’s meshing mode. All other operations are performed within Fluent’s solution mode, including:

  • Setting boundary conditions

  • Defining fluid properties

  • Executing the solution

  • Refining the mesh

  • Running a parametric study

  • Postprocessing and viewing results

What is PyFluent?#

PyFluent is part of the PyAnsys ecosystem that lets you use Fluent within a Python environment of your choice in conjunction with other PyAnsys libraries and external Python libraries.

PyFluent implements a client-server architecture. It uses Google remote procedure calls, or gRPC interfaces, to launch or connect with a running Fluent process as a server. However, you only need to interact with the Python interface.

You can use PyFluent to programmatically create, interact with, and control a Fluent session to create your own customized workspace. In addition, you can use PyFluent to enhance your productivity with highly configurable, customized scripts.


Some of the many features in this primary PyFluent package, ansys-fluent-core, allow you to:

  • Launch the Fluent solver in serial or parallel and connect to already-running Fluent sessions. For more information, see Launching Fluent locally.

  • Script using Fluent’s meshing capabilities. For more information, see Meshing.

  • Script using all of Fluent’s TUI (text user interface) commands. For more information, see Using TUI commands.

  • Run more than one Fluent session asynchronously. For more information, see PyFluent utility functions.

  • Retrieve Fluent field data as numpy arrays for custom postprocessing using standard Python packages such as matplotlib. For more information, see Field data.

  • Register function callbacks on Fluent solver events such as when a case file or data file is read or when the Fluent solver completes an iteration. For more information, see EventsManager.

  • Retrieve solver monitors such as residuals. For more information, see MonitorsManager.

Documentation and issues#

In addition to installation and usage information, the PyFluent documentation provides API reference, Examples, and Contributing sections.

On the PyFluent Issues page, you can create issues to submit questions, report bugs, and request new features. To reach the PyAnsys support team, email


PyFluent is licensed under the MIT license.

PyFluent makes no commercial claim over Ansys whatsoever. This library extends the functionality of Ansys Fluent by adding a Python interface to Fluent without changing the core behavior or license of the original software. The use of the interactive control of Fluent control of PyFluent requires a legally licensed copy of Fluent.

For more information on Fluent, see the Ansys Fluent page on the Ansys website.

Project index#