pyFluent：利用python控制Fluent

Fluent 2022R2版本推出了pyFluent，这实际上是提供了一个利用python访问Fluent进程的工具，利用此工具可以实现利用python控制Fluent，可以实现在不启用Fluent GUI的情况下，完成参数设置、计算求解以及或数据结果输出的功能。本文描述pyFluent的安装及文档编译过程。

 

注：pyFluent只能在Fluent 2022R2版本及其后续版本下使用。

”

pyFluent的官方说明资料非常少，在文档中搜索也只有下面这么一个结果。

打开之后可以找到一个文件下载链接https://github.com/pyansys/pyfluent。

打开这个网址可以看到所有的内容。（ANSYS动作还是麻利，昨天晚上看还是404，没想到现在有内容了）。

网站中有详细的安装说明，下面简单描述一下安装方式。

1 安装

后处理会用到numpy和matplotlib，怕麻烦的话可以先安装anaconda（网址https://www.anaconda.com/）。然后在开始菜单中打开Anaconda Prompt，在其中输入命令进行安装。若为Liunx系统，则确保系统中安装了pip或pip3。

• 利用下面的命令安装pyfluent：

pip install ansys-fluent-core

如下图所示。

****慢的话就多试几次。如果连接github速度比较快的话，也可以尝试使用下面的命令进行安装：

pip install git https://github.com/pyansys/pyfluent.git

可以在这里找到一些简单的使用信息。https://pypi.org/project/ansys-fluent-core/

为方便使用，可以配套安装Fluent参数化模块及后处理模块。利用下面的命令安装：

pip install ansys-fluent-parametric
pip install ansys-fluent-visualization

安装后处理模块会涉及到pySide6模块及vtk模块的安装，这两货的个头都很大，建议切换到国内镜像源，否则速度慢吞吞会把人急死。

2 文档编译

pyfluent资料比较少，最好的资料无异于源代码自带的文档。

• 从网站https://github.com/pyansys/pyfluent下载所有的源代码，放到一个英文路径下，如本文放到g:盘下

• 由于文档编译需要使用到sphinx，所以需要提前安装。同时在编译的过程中还涉及到了一堆的外置模块，也需要预先安装。这里在经过若干次报错之后，搞清楚的需要安装模块如下所示。可以通过下面的命令进行安装。

pip install Sphinx
pip install sphinx-gallery
pip install jupyter_sphinx
pip install sphinx-notfound-page
pip install ansys_sphinx_theme
pip install sphinx-autodoc-typehints
pip install sphinx-copybutton
pip install sphinxemoji

• 启动anaconda prompt，利用cd命令进入到pyfluent的doc路径下，运行命令

make html

等其编译完毕后（编译时间很长，编译中还运行了几个算例，真是牛逼），即可在doc文件夹的_build/html子文件夹下找到index.html文件进行打开。

这里除了可以编译成html格式外，还能够输出epub格式。其实sphinx本身是可以输出pdf格式的，没搞懂为什么不让输出pdf。

3 使用

目前这方面的资料比较少，还没有仔细了解，看了看模块的一些源代码，发现好多函数都是tui命令的封装。待有时间把文档研究一波再聊。

可以使用下面的简单代码测试是否安装成功。

• 进入python，输入下面的代码

import ansys.fluent.core as pyfluent
session = pyfluent.launch_fluent()
session.check_health()

若第一行代码不报错则表示安装成功。

如下图所示，输出为SERVING则表示Fluent已经启动成功，后面就可以用session为所欲为了。

（完毕）