Pyansys基本介绍及环境配置

关于Pyansys，实际上已经有不少文章对这个库进行了介绍，但都较为分散，本期及后面几篇文章，水哥将站在结构工程师的角度来详细剖析下这个库的基本使用方法。

一、Pyansys的发展史

Pyansys最早于2016年由Alex Kaszynski在Github上开源，项目最开始的时候虽然叫Pyansys，但实际上驱动的是MAPDL，也即现在的Pyansys-PyMAPDL。

水哥于2017年首次试用过这个库，当时的体验感确实较差，因为那时候还没有官方维护，使用文档也没有，各种Bug，好在现在通过官方维护后，各种Bug已经修复了不少，且还在稳定更新中，现在使用起来感觉还是不错的。

2021年，ANSYS 公司正式采纳并扩展该项目，发布 PyAnsys家族首批四大开源包（PyMAPDL、PyDPF-Core、PyDPF-Post、 PyAEDT），采用 MIT 许可证，并在 PyPI提供一键安装。

2022~2023年，ANSYS官方持续增加模块：PyFluent、PyTwin、PyMechanical等，覆盖流体、数字孪生、结构多物理场；同时官方提供统一文档、示例与 GitHub 社区支持。

2024~2025年，ANSYS官方推出面向医疗、芯片、数字孪生的专用扩展（如 PyAnsys-Heart、PyTwinROM 部署工具），并整合 AI 工作流。

可以预见，利用Python+AI已是后续的发展趋势。对仿真工程师而言，结合Python+AI来进行仿真已经开始从加分项逐渐过渡到必备项了。

那么Pyansys到底有什么作用呢？

一句话：用现代编程的方式去驾驭强大的ANSYS，降低重复劳动的枯燥感，提升仿真工作的生产力。

二、Pyansys基本介绍

Pyansys实际上是多个包的集合，每个包都有自己的API，用户需要结合自己使用的模块来选择相应库。

官网如下所示：

用户可点击自己的模块来进行相应的API学习，同时官方提供了不少的案例，可加快掌握。

如下这是PyMAPDL的学习界面：

如下这是PyFluent的学习界面：

三、PyANSYS环境搭建

要使用这个库，必须首先进行环境的搭建，环境搭建主要分为四个方面：

1、Python的安装

Python目前有多个版本，最新的版本为3.15，选择合适的版本可能直接决定后续Pyansys是否能安装成功。

安装的时候不要选择太新，也不要选择太老的Python版本，中间的版本即可。若Python版本太新，由于Pyansys里面的部分库还依赖于其他的Python库，而其他有的库有可能还没适配新版本的Python，这会直接导致Pyansys不可用。

目前官方推荐的版本如下：

灰色表示不再支持，蓝色表示目前支持，红色表示将来会支持。

水哥这里较为推荐Python3.12版本，实际使用过程中暂未发现因为版本不适而导致的不可用问题。

2、编程IDE软件的安装

IDE软件有许多选择，用户可以选择主流的老牌IDE软件，比如PyCharm、Visual Studio，也可以选择AI时代的IDE软件比如Cursor等，看大家的心情。

水哥这里推荐Pycharm，目前Pycharm已经可以用社区版了，使用感觉还不错。

3、ANSYS软件的安装

同上面Python版本的选择，在实际使用过程，建议大家选择中间版本，不要太新，也不要太老，比如可选择2022到2025之间的版本。

4、Pyansys的安装

Pyansys支持PyPi方式安装，也即和其他库的安装方式一样，只需要pip安装即可，默认是安装最新稳定版本，也可以指定具体的版本，如下：

python -m pip install pyansys

python -m pip install pyansys==2025.2.1

Pyansys库比较多，若直接安装，由于是境外服务器，下载速度略慢，可以采用镜像安装。

安装后的测试，以MAPDL为例，运行如下代码：

复制代码

from ansys.mapdl.core import launch_mapdl mapdl = launch_mapdl() print(mapdl)

若能打印出版本信息，即可说明安装成功，同理，如果你是其他的模块，则需要查看相应模块的使用用法，测试是否安装成功。

若有同学需要系统性的学习PyANSYS-PyMAPDL，可参考水哥下面这篇文章：