本文介绍pyansys的一些基础内容。

注：文中内容取自pyansys官方介绍。

”

1 基本介绍

pyansys包含了一系列用于操控ANSYS产品的Python程序包，主要包括：

• PyAEDT：提供了AEDT的python接口

• PyDPF-Core：提供了DPF(Data Processing Framework)的python接口，用于建立更高级和定制的工作流程

• PyDPF-Post：DPF后处理工具箱的python接口，用于操作和转换模拟的数据

• PyFluent：提供了操作Fluent的python接口

• PyMAPDL：提供了操作MAPDL的python接口

• PyPIM：提供了与PIM（Product Instance Management）API通信的python接口

• Granta M1 BoM Analytics：与Granta MI BoM分析服务的python接口

• Shared Components：共享软件组件，以实现软件包的互操作性并尽量减少维护工作

除此以外，还有一些其他的ANSYS产品的python接口，如PyMechanical、PyOptisLang、PySeascape、PySystemCoupling等，详情可见其官网介绍。

pypi地址：https://pypi.org/project/pyansys/github地址：https://github.com/pyansys文档地址：https://docs.pyansys.com/version/dev/

”

2 模块安装

pyANSYS是一个python程序包，其中包含了一些对科学计算库的依赖，为了避免麻烦，可以先安装Anaconda或Miniconda。

Anaconda下载地址：https://www.anaconda.com/download/Miniconda下载地址：https://docs.conda.io/en/latest/miniconda.html

”

这里以Anaconda为例，从其官网下载后进行安装，一路next即可。

Anaconda安装完毕后，从开始菜单中打开Anaconda Prompt。

在其中输入命令：pip install pyansys进行pyansys安装，如下图所示。

注：也可以使用pip install pyansys[fluent-all]安装更多模块，附加安装的模块包括：shiboken6, PySide6-Essentials, PySide6-Addons, pyside6, pyvistaqt, ansys-fluent-parametric, widgetsnbextension, ipywidgets, ipyevents, ipycanvas, ipyvtklink, ansys-fluent-visualization等。

”

如下面这样则表示安装完毕。

接下来可以测试一下是否可用。

在Anaconda Prompt中输入ipython启动IPython，如下图所示，随便输入语句import ansys.fluent.core as pyfluent，若无报错，则表示安装成功。

3 编译本地文档

pyansys线上文档地址为：https://docs.pyansys.com/version/dev/

不过有时候可能需要离线查阅文档，此时可以利用源码编译本地文档。

• 从pyansys官网https://github.com/pyansys/pyansys或网址https://codeload.github.com/pyansys/pyansys/zip/refs/heads/main下载pyansys并解压

• 从anaconda prompt进入到解压后的文件夹中的doc路径下，运行命令：make.bat html，此时可能会出现下图所示的错误信息，表示没有安装ansys_sphinx_theme

• 利用pip install ansys_sphinx_theme安装该模块，安装完毕后继续make.bat html，后面缺啥模块就直接用pip进行安装。（本机上需要安装的模块包括：sphinx_design、sphinx_copybutton）

文档编译了似乎也没啥用，只有一个和线上文档一样的主页面，模块的文档还是线上的。不过各子模块的文档编译过程是一样的。

4 后记

pyansys目前还缺少一个能打的建模模块，若能将SCDM或DM搞进来就好用了。现在建模采用APDL，用起来不是一般的难受。也可以选择导入CAD，不过这样做的话就难以实现几何参数化。

pyansys遵循MIT协议，此协议较为宽松，可闭源商用。

（完）