PyTecplot

TecPLUS™ 订阅用户可访问 PyTecplot，这是一个高级 API，能将您的 Python 脚本与 Tecplot 360 可视化引擎的强大功能相连接。熟悉 Tecplot 360 及其宏语言会有所帮助，但并非必需。

PyTecplot 需要 64 位 Python 2.7 或 3.4+ 版本，以及 Tecplot 360 2017 R1 或更高版本（需包含 TecPLUS™ 维护服务）。PyTecplot 不支持 32 位 Python。

请参阅PyTecplot Guide了解安装说明、环境设置及完整参考手册。以下章节仅涉及 Tecplot 360 中 PyTecplot 的用户界面部分。

PyTecplot 录制

Tecplot 360 的PyTecplot Recorder功能可在您交互执行一系列操作时录制 Python 脚本。脚本采用 PyTecplot Python（.py）格式。PyTecplot Python 脚本在 Tecplot 360 外部运行，可通过命令行或任何 Python IDE 执行。

录制脚本后，您可以使用纯文本编辑器编辑脚本文件，以删除冗余操作、将重复操作压缩为循环、用变量名替换文件引用，或进行其他修改，使脚本更具通用性和灵活性。

要使用PyTecplot Recorder对话框录制宏，请从Scripting菜单中选择“Record PyTecplot”。在Write Script (.py)对话框中指定文件名，点击“Save”开始录制。录制过程中，Macro Recorder对话框将保持打开状态。

录制期间自动重绘功能将被禁用。如有需要，您可以通过点击绘图侧边栏中的“Redraw”按钮手动重绘图形。

有关宏录制器对话框的详细信息，请参阅Macro Creation.

PyTecplot 连接

PyTecplot 连接对话框允许远程 Python 实例控制 GUI 并与已加载数据进行交互。目前，该服务器的唯一可用客户端是PyTecplot，即 Python 官方包仓库PyPI.

Server Configuration

上提供的“tecplot”Python 模块。要允许服务器处理传入请求，请进入 Tecplot 360 的主菜单，选择Scripting→PyTecplot Connections…​，PyTecplot 连接对话框将出现：

pytecplot 连接

点击“Accept connections”旁的复选框可立即启用服务器。如果所选端口已被其他进程（甚至另一个正在运行的 Tecplot 360 实例）占用，将显示以下错误信息：

pytecplot 连接警告

在这种情况下，您可以选择其他未使用的端口号，并重新尝试启用“Accept connections”选项。

默认情况下，TecUtil 服务器仅监听来自本地主机的请求。取消勾选"仅监听本地主机"选项后，服务器将处理来自任何远程主机的传入请求，具体受运行 Tecplot 360 的计算机防火墙和安全设置约束。

Connecting from the PyTecplot Client Script

要通过 Python 脚本连接服务器，必须安装 PyTecplot Python 包。请参阅PyTecplot’s documentation了解 PyTecplot 入门详细说明。在 Python 脚本中，使用 tecplot.session.connect() 方法连接正在运行的 Tecplot 360 实例：

import tecplot
tecplot.session.connect(port=7600)

连接成功后，Python 脚本将继续运行，Tecplot 360 将实时更新。

Activating Server with a Macro File

要通过宏在 Tecplot 360 中激活 TecUtil 服务器插件，请将此宏命令添加到单独的.mcr文件中：

$!EXTENDEDCOMMAND
 COMMANDPROCESSORID = "TecUtilServer"
 COMMAND = R"(
 AcceptRequests = Yes
 ListenOnAddress = localhost
 ListenOnPort = 7600
 )"

要在启动时使用此功能，只需在启动 Tecplot 360 时播放该宏文件：

tec360 -p startConnector.mcr