Advanced Material Exchange API

Advanced Material Exchange 提供了应用程序编程接口 (API),可用于自动执行部分工作流。API 通过名为 API.vbs 的脚本访问。此脚本的详细信息在下方提供。

运行 API.vbs 脚本的步骤:

  1. 打开命令提示
  2. 导航到包含 API.vbs 脚本的目录
  3. 输入 API.vbs 以执行脚本
注意:首次使用 Advanced Material Exchange 的新版本运行 API.vbs 脚本时,将需要先执行以下操作,再完成上述步骤 1-3:
  1. 以管理员身份打开命令提示
  2. 导航到 Advanced Material Exchange 的安装目录(通常为 C:\Program Files\Helius PFA 20XX\ame\bin)
  3. 在命令提示中输入 ame.exe /unregister 以注销 OLE 接口
  4. 在命令提示中输入 ame.exe /register 以注册 OLE 接口

可用的关键字

Option Explicit

Option Explicit 关键字要求所有变量通过 Dim 或 ReDim 关键字进行明确声明。 使用 Option Explicit 关键字时,在声明前使用的任何变量都将导致错误。 建议使用此关键字,因为它可以减少编程错误。

SetLocale("en-us")

当存在 SetLocale("en-us") 关键字时,它将强制非英语系统以 en-us 格式解释数值。 如果未包括此关键字,那么数值将以系统的本机语言进行解释。

Dim Synergy
Set Synergy = CreateObject("ame.Synergy')

这两行创建一个 OLE 自动化对象,此对象将启动最近运行的 Synergy(Advanced Material Exchange 用户界面)版本。同一时刻只能运行一个 Synergy 版本。

Synergy.SetUnits "SYSTEM"

其中 SYSTEM 参数可以设置为:

Synergy.OpenProject "PATH"

其中 PATH 参数指定已保存项目的完整目录路径(例如,“C:\AME\project.mps”)。此关键字将打开指定的项目。

Synergy.MapStructuralResults

此关键字用于将 Moldflow 分析中的结果映射到结构模型。使用此关键字之前,模型必须对齐(确保工作目录中存在 alignment.res 文件)。

Synergy.SelectMaterialModel #

其中 # 参数用于选择材料模型。# 可以设置为:

Synergy.ExportStructuralFiles "PATH",#,RESIDUAL STRAINS

其中 PATH 参数指定要输出的输入文件的完整目录路径和文件名(例如,“C:\AME\project.inp”),# 参数标识要选择的材料环境,RESIDUAL STRAINS 参数确定是否要将残余应变输出到 .sif 文件。

# 可以采用以下值:

RESIDUAL STRAINS 可以采用以下值:

示例 API 脚本

下面的脚本将打开一个现有的 Advanced Material Exchange 项目、将结果映射到结构模型、通过第一个材料环境选择弹塑性材料模型,然后输出结果。

'@
'@ Open project, map results, choose material model, choose environment, export
'@
'@
'@@
Option Explicit
SetLocale("en-us")
Dim Synergy
Set Synergy = CreateObject("ame.Synergy")
Synergy.SetUnits "METRIC"

Synergy.OpenProject "C:\Testing\example.mps"
Synergy.MapStructuralResults
Synergy.SelectMaterialModel 1
Synergy.ExportStructuralFiles "C:\Testing\example.inp",1, False, False

'
' Put remainder of code here.
'
MsgBox "Script Complete"
Wscript.Quit