ANSYS workbench脚本开发指南

ANSYS workbench 脚本开发指南

目录

1. 脚本的概述

1.1. 日志和脚本功能。

1.1.1. 日志记录。

1.1.1.1. 设置日志的偏好。

1.1.1.2. 手动记录日志。

1.1.1.3. 使用命令窗口

1.1.2. 脚本

2.1ANSYS Workbench 对象

2.2. 单位

2.3. 在 ANSYS Workbench

2.4 中的文件路径处理。用法示例

2.4.1. 自动更新所有受设计修改影响的项目

2.4.2。与项目中的文件交互

2.4.3. 材料属性和表格数据

2.4.4. 机械 APDL 和发送命令到集成应用程序…

2.4.5. 从 Excel 更新工作台项目和参数

3. 已知的问题和限制一般

在本文档中，ANSYS Workbench 指的是在 Workbench 环境下运行的所有应用程序和工具，

包括 Project 选项卡、Parameter Manager 和 AIM。如果特性只适用于特定的应用程序或工具，

这将被指出。

日志和脚本使用小数点作为小数点分隔符，逗号作为列表项的分隔符，而不管区域设置

如何。GUI 将使用当前地区设置显示值和列表。

1.1. 日志和脚本功能通过 GUl 执行的大多数操作都会被记录下来。一些没有记录的行为

包括:

只支持 gui 的操作，例如:

中断解决操作

紧凑型运行模式

启动帮助(包括快速帮助和侧边栏帮助)

从 VistaTF 的解决方案单元格运行视图

求解器输出选项

．如脚本和数据集成应用程序中所述，在一些数据集成应用程序中所采取的操作(第 6

页)

．一些图形场景动作，如隐藏身体和旋转。

1.1.1. Journaling

日志是在会话期间修改数据的所有操作的记录。根据您的首选项设置，完整会话的日志

可以自动保存到您指定的位置。有关更多信息，请参见设置日志记录首选项(p. 2)。您还可

1.1.1.1. 设置日志的偏好您可以设置日志首选项，如自动为每个项目生成日志，日志写入的

默认目录，以及日志文件的保存时间:

1. 在 ANSYS Workbench 中，选择“Tools > Options > Journals and Logs”。

2. 如果要让 ANSYS Workbench 自动写入日志文件，选择“Record journal files”。

3. 指定要写入日志文件的默认位置。当您选择开始记录日志时，文件浏览器将在此位置自

动打开。在保存特定日志之前，您仍然可以浏览到不同的位置。

4. 指定保存日志文件的天数。

5. 指定运行日志文件时每个命令之间的暂停时间(以秒为单位)。

6. 单击 OK 保存设置。

1.1.1.2. 手动记录日志您可以手动记录日志:

1. 启动 ANSYS Workbench。

2. 选择“File > Scripting > Record Journal”。

3. 指定日志文件的名称和位置，然后单击 Save。

1.1.1.3. 使用命令窗口您可以使用命令窗口调用命令，访问数据实体属性，并交互式地调用

数据实体和数据容器方法，每次调用一个:

2. 输入要运行的命令，一次一个。当您输入每个命令时，适当的操作将在 ANSYS Workbench

数据库中发生，如果适用的话，在 GUI 中也会发生。

命令窗口使用

在记录日志的同时，ANSYS Workbench 为项目中包含数据的对象引用创建了许多变量。例如，

考虑日志中的下列行:

在这个日志中，template1 和 system1 是关联数据对象引用的变量。在日志中使用变量来访

用 ImportJournalVariables()命令时，您应该注意以下几点:

*变量的定义基于当前记录的日志。默认情况下，该日志是由用户首选项控制的自动记录日

志。有关更多信息，请参阅设置日志首选项(p. 2)。如果您已经手动启动了部分会话的日志

记录，变量定义取自手动记录的日志。有关更多信息，请参见手动记录日志(p. 2)。

*如果您有任何与日志变量同名的手动定义变量，那么您的变量将被日志变量覆盖。

日志中的变量定义。

*ImportJournalVariables()命令可以在一个会话中执行多次，并将基于当前记录的日志更新变

量。

键来方便您的窗口交互。

文本光标键盘键在输入命令或语句时，可以使用以下特殊键移动文本光标:

复制粘贴键盘键您可以从命令窗口复制文本到剪贴板或粘贴文本从剪贴板作为输入到命令

窗口。下面的键允许你复制和粘贴文本:

命令历史

命令补全

命令窗口提供了命令补全(tab-补全)功能，可以自动补全部分输入的变量和命令，以节省繁

琐的输入。键入一个或多个字符，并按一次或多次 Tab 键，可以查看已定义的变量和命令，

它们的名称以您键入的字符开头。用点(.)输入一个对象变量名，然后按 Tab 键，将遍历该对

象已定义的属性和方法。

在点后面输入一个或多个字符会将补全结果限制为那些以这些字符开头的属性和方法。下面

1.1.2. 脚本

脚本是发给 ANSYS Workbench 的一组指令。脚本可以是修改过的日志，也可以是直接编写

的一组全新的指令。ANSYS Workbench 采用了基于对象的方法。对于脚本，了解面向对象编

IronPython 的更多信息，请参见 http://ironpython.net/。

IronPython 通常与现有的标准 Python 脚本兼容。然而，并不是所有基于 c 语言的 Python 库

模块都可以在 IronPython 中使用，就像在 IronPython 网站上讨论的那样。

有关 Python 的更多信息，包括标准语言参考，请参见 http://www.python.org/。

有关 ansi 发布的数据容器(第 47 页)、命名空间命令(第 1341 页)和数据类型(第 1413 页)的完

整列表，请参阅本文档后面的参考材料。

1.1.2.1. 脚本向后兼容

如果您想运行一个为 ANSYS Workbench 以前版本创建的脚本，您必须在脚本文件的开头插

入一个 SetScriptVersion (p. 1394)命令，指示脚本最初创建的版本。此外，如果您从旧脚本复

制 命 令 并 将 它 们 粘 贴 到 命 令 窗 口 ， 那 么 在 将 脚 本 命 令 粘 贴 到 窗 口 之 前 ， 必 须 输 入

ANSYS Workbench 可以从操作系统命令行执行，并接受许多命令行参数，以方便自动化和脚

本回放。在命令行运行 ANSYS Workbench 可以使用如下命令:

ANSYS_INSTALL_PATH/v193/Framework/bin/PLATFORM/runwb2

“平台”是以下之一(适用于您正在使用的应用程序或工具):

Win64

Linux64

例如，要在 Windows 64 位系统上从默认安装位置运行 ANSYS Workbench，命令如下:

C:\Program Files\ANSYS Inc\V193\Framework\bin\win64\runwb2

下表描述了在启动时用于控制 ANSYS Workbench 文件操作和执行行为的命令行参数。

控制台窗口控制台窗口与命令窗口相同，但在批处理模式下运行时存在，以提供一种在用户

界面之外直接处理命令的方式。

1.1.3. 你可以交互式地玩日志或脚本:

1. 选择“文件>脚本>运行脚本文件”。

2. 选择要播放的日志或脚本文件，单击“打开”。

记录的操作将被执行。

在 ANSYS AIM 中，您还可以通过选择研究面板中的脚本图标播放日志或脚本。要使用命令行