Part11. Ansys 向导简介

ACT向导可以创建半自动化的自定义引导流程，将仿真流程分为多个步骤，一步步完成仿真工作，仿真向导可以是基于标准流程也可以是标准流程与混合流程相结合。向导(Wizard)用于启动和控制不同目标的应用程序。

Wizard分为三种类型，分别是Target Wizard、Project Wizard和Mixed Wizard。

• Target Wizard

1. 目标应用向导完全在指定的Ansys目标应用程序（Mechanical、SpaceClaim、 Fluent）中执行。
2. 只能在指定的目标应用中启动。
3. 利用目标程序提供的脚本开发功能，在应用中仿真向导界面中提仿真流程的指导。

• Project Wizard

1. 只能在Project界面打开使用。
2. 可以将Ansys Workbench任何具有Workbench日志和脚本功能的应用程序集成在一起，不用打开具体的应用程序如（Mechanical、SpaceClaim、Fluent）就能完成仿真分析。

• Mixed Wizard

1. 在ANSYS Workbench项目标签页和一个或多个支持脚本功能的目标应用程序中执行；
2. 混合向导在Project标签页和目标应用程序中都提供了仿真向导，支持在目标应用中进行界面交互。
3. 结合了项目向导和目标应用向导的功能，提供全流程的仿真流程的封装与定制。向导可用于启动和控制不同的目标应用程序 向导可能以混合向导（在此过程中使用不同的应用程序）或简单向导（一个唯一的目标应用程序）的形式出现 如果可能，向导可用于WorkBnech平台和独立应用程序 仅Workbench应用环境下：

• DesignModeler
• Mechanical Workbench和独立应用程序：
• SpaceClaim
• Fluent、Fluent Meshing
• Electronics Desktop

Part22.仿真向导定义

向导完全是ACT的一部分。因此，在定义向导时还需要进行ACT的每个常用组件Wizard需要的定义插件的XML文件和其引用的IronPython脚本:

1. 与标准ACT插件所需相同，并使用相同的XML和IronPython语法；
2. 可选的自定义帮助文件包含文本、图像、图标或其他控件类型的HTML文件，用于为Wizard提供详细使用说明；对于Wizard，帮助文件可以储存在插件目录中的任何文件夹中；执行向导时，文件内容将显示在向导的交互界面中。

Part33.XML文件定义

1主要组成

1. extension 元素包含特定扩展的不同属性：名称、版本...
2. guid 元素。它将确保扩展的唯一身份。
3. author和 description 会出现在扩展的摘要信息中，author是作者信息，description是插件介绍
4. script元素包含将在扩展中使用的 python 文件。
5. interface 用于定义创建的ACT插件在哪个应用程序中，如Mechanical、SpaceClaim、Fluent中；也可用用来指定ACT工具图标的文件目录。
6. uidefinition用于自定义布局和向导面板,如果不定义，则使用默认的布局
7. wizard 元素包含所有步骤控制元素
8. simdata元素是可选的，如果除向导本身之外还需要其他自定义功能，则使用该元素，该元素在《APDL命令封装为Mechanical用户自定义插件》中有使用，主要创建自定义功能。

2wizard定义

1. wizard元素中包含以下属性和子元素，包括如下： name:向导名称;

version:向导版本号;

context:向导的所属的应用程序；

icon:向导图标

description:向导的简介

2. step元素包含以下属性和子元素:

name：步骤名称、version：步骤版本

caption：步骤标题、HelpFile：-帮助文件

description：步骤功能描述

callbacks：执行步骤时调用的回调函数

property和propertygroup：定义实现回调函数时需输入的属性或属性组，是step中的最关键的元素，提供外界与ACT插件交互的控件

下图中以第一个step为例，展示了xml文件与ACT插件界面对应关系，其他step界面与此界面类似。

3. Property元素定义 在 元素中插入 元素来创建步骤的属性， 输入类型由control属性定义，常用的control类型如下： fileopen：选择文件

folderopen：选择文件夹

integer：整数输入框

text：文本输入框

float：数字输入框

select：属性选择框

scope：几何选择框

tabulardata：表格数据

4. 回调函数Callbacks 在ACT开发中，我们通过指定XML中的回调函数来绑定界面事件，回调函数需定义在对应的IronPython脚本中。向导(Wizard)中每个步骤(Step)中可以包含3种类型的回调函数；

• onupdate：单击Next按钮时调用此回调函数；在最后一步时，单击Finish按钮也会调用它。例如，创建项目组件系统，执行组件中IronPython脚本命令等。
• onrefresh：每次刷新向导面板的UI时都会调用此回调函数。例如，用来绘制图形。
• onreset：用于在一个步骤中删除和重置操作时。用于在一个步骤中删除和重置操作，单击Back按钮时调用它；回调需要在步骤N中定义，并且单击步骤N+1的Back按钮时将调用它。上述三个回调函数中：onupdate回调是必需的，其他两个是可选的。每个回调函数中都只使用一个参数step：表示当前步骤；我们可以通过访问step对象的Properties属性访问输入控件属性值，如下:

Part44.ACT插件加载

定义好XML文件、IronPython脚本以及其他帮助和图标文件后，需要将脚本文件通常放在与XML文件同名的文件夹中，如下结构。

打开Workbench软件，在菜单栏Extensions-ACT Start Page进入ACT插件界面，按照下图所示加载插件

以上就是本期内容，关注微信公众号，有技术问题或项目合作可以直接在微信公众号后台留言,公众号回复“MixedWizard”获取ACT代码。