1. 通用 General

1.1. API连接 API Connection

1.1.1. API Key Comp_00_General.MidasKey

连接MIDAS Gen API并获取许可

(1) 输入端

名称 缩写 默认值 可选 描述
URL URL https://moa-engineers.midasit.cn:443/gen MIDAS API Base URL
Key K - MAPI-Key,打开midasGen2024及以上,工具->API Connect后,复制MAPI-Key

(2) 输出端

名称 缩写 描述
success suc 连接成功?
MRequest M MIDAS API请求对象

用于连接MIDAS Gen API。需要先在MIDAS Gen中开启API Connect功能,然后复制MAPI-Key和Base URL。

使用步骤:

  1. 打开MIDAS Gen 2024及以上版本
  2. 点击菜单 工具 -> API Connect
  3. 复制MAPI-Key和Base URL
  4. 将Key和URL输入此组件

1.2. 文件操作 File Operations

1.2.1. 保存 Comp_00_General.Save

保存当前MIDAS模型

(1) 输入端

名称 缩写 默认值 可选 描述
Run R false 运行开关
MRequest M - MIDAS API请求对象

(2) 输出端

名称 缩写 描述
Result Res 保存结果

用于保存当前MIDAS Gen中的模型文件。需要先通过API Key组件获取MRequest对象。

1.2.2. 另存为 Comp_00_General.SaveAs

将MIDAS模型另存为指定文件

(1) 输入端

名称 缩写 默认值 可选 描述
Run R false 运行开关
FilePath Path C:\1.mgb 保存文件路径,.mgb格式
MRequest M - MIDAS API请求对象

(2) 输出端

名称 缩写 描述
Result Res 保存结果

用于将当前MIDAS Gen中的模型另存为指定路径的.mgb文件。需要先通过API Key组件获取MRequest对象。

2. 定义 Define

2.1. 截面 Section

2.1.1. MIDAS阻尼器截面 Comp_midasLinkSec

定义MIDAS阻尼器截面

(1) 输入端

名称 缩写 默认值 可选 描述
secName N sec1 阻尼器名称
mfix F bool[6] 固定,6个自由度的固定状态
vals K double[6] 刚度,6个自由度的刚度值
dj2 Y 0.5 剪切相对位置y,中点为0.5
dj3 Z 0.5 剪切相对位置z,中点为0.5
mType T GEN 类型:GEN/INTERNAL/EXTERNAL

(2) 输出端

名称 缩写 描述
section S 阻尼器截面对象

用于定义MIDAS阻尼器截面属性。支持三种类型:

通过右键菜单切换阻尼器类型。

3. 荷载 Load

3.1. 动力荷载 Dynamic Load

3.1.1. 动力点荷载 Comp_01_Load.DynamicPointLoad

创建动力点荷载对象

(1) 输入端

名称 缩写 默认值 可选 描述
Point P - 荷载作用点
Load Case LC - 时程工况对象
Function F - 时程函数对象
Direction D - 荷载方向向量

(2) 输出端

名称 缩写 描述
Dynamic Point Load DPL 动力点荷载对象

用于创建动力点荷载对象。输入荷载作用点、时程工况、时程函数和方向向量,输出动力点荷载对象供后续分析使用。

3.1.2. 添加节点动力荷载 Comp_01_Load.AddDynamicNodalLoad

通过API添加节点动力荷载

(1) 输入端

名称 缩写 默认值 可选 描述
Load Name Name - 荷载名称
Functions Func - 时程函数名称列表
Directions Dir - 方向列表,O-X,1-Y,2-Z
Node IDs IDs - 节点编号列表
Scale Factors SF - 比例系数,树形结构
MRequest M - MIDAS API请求对象
Arrive Time AT 0 到达时间
Run R false 运行开关

(2) 输出端

名称 缩写 描述
Result Res 添加结果

用于通过MIDAS API向模型添加节点动力荷载。需要先定义时程函数,然后指定荷载名称、作用节点、方向和比例系数。

方向说明:

3.1.3. 时程函数 Comp_01_Load.AddTimeHisFunction

通过API添加时程函数

(1) 输入端

名称 缩写 默认值 可选 描述
ID ID - 函数ID
MRequest M - MIDAS API请求对象
Function Name Name - 函数名称
Times T - 时间点列表
Values V - 数值列表
Function Type Type TimeFunction 函数类型
Data Type DT NormalizedAccel 数据类型
Scale Method SM ScaleFactor 缩放方法
Scale Factor SF 1.0 缩放系数
Gravity G 9.81 重力加速度
Run R false 运行开关

(2) 输出端

名称 缩写 描述
Result Res 添加结果

用于通过MIDAS API添加时程函数。时程函数可用于动力分析中的荷载定义。

函数类型:

数据类型:

3.1.4. 添加时程工况 Comp_01_Load.AddTimeHisLoadCase

通过API添加时程分析工况

(1) 输入端

名称 缩写 默认值 可选 描述
Load Name Name - 工况名称
End Time ET - 结束时间
Time Step TS - 时间步长
ID ID - 工况ID
MRequest M - MIDAS API请求对象
Damping D 0.05 阻尼比
Run R false 运行开关

(2) 输出端

名称 缩写 描述
Result Res 添加结果

用于通过MIDAS API添加线性时程分析工况。需要指定工况名称、分析时长、时间步长和阻尼比。

3.2. MIDAS API荷载 MIDAS API Load

3.2.1. 节点风压时程 Comp_MIDASAPI_NFXWindLoadTH

通过MIDAS API施加节点风压时程荷载

(1) 输入端

名称 缩写 默认值 可选 描述
MIDAS API Key Key - MIDAS API许可
NFX CFD Result CFD - NFX CFD结果对象
Node Tag Tag - 节点号列表
Nodal Force F - 节点力,树形数据结构
TimeStep DT - 时间步长
damp D 0.02 阻尼比
EigvNumber Eigv 10 特征值数
LoadCase Name LC TgTH 时程工况名称
Toggle T false 开关

(2) 输出端

名称 缩写 描述
Run Flag R 运行标志

用于通过MIDAS API向模型施加节点风压时程荷载。支持两种加载方式:

通过右键菜单切换加载方式和单位设置(力单位:N/kN,长度单位:mm/m)。

3.2.2. 节点风压 Comp_MIDASAPI_NFXWindLoad_NodalWay

通过MIDAS API施加节点风压荷载

(1) 输入端

名称 缩写 默认值 可选 描述
MIDAS API Key Key - MIDAS API许可
NFX CFD Result CFD - NFX CFD结果对象
Plate Tags Tag - 面单元号列表
Plate Mesh M - 网格列表
Pressure P - 面风压,树形数据结构
Load Case LC - 工况名称列表
Toggle T false 开关

(2) 输出端

名称 缩写 描述
Run Flag R 运行标志

用于通过MIDAS API向模型施加节点风压荷载。将面单元上的风压转换为节点荷载并施加到模型上。

通过右键菜单设置单位(力单位:N/kN,长度单位:mm/m)。

4. 模型 Model

4.1. 模型获取 Model Retrieval

4.1.1. 查询节点坐标 Comp_05_Model.MidasGetNodes

通过节点编号获取MIDAS中的节点坐标

(1) 输入端

名称 缩写 默认值 可选 描述
Run R false 运行开关
MRequest M - MIDAS API请求对象
Node Tags Tags - 节点编号列表

(2) 输出端

名称 缩写 描述
Points P 节点坐标列表

用于通过节点编号获取MIDAS模型中对应节点的坐标。输入节点编号列表,输出Rhino Point3d坐标列表。

4.1.2. 从MIDAS获取模型 Comp_05_Model.MidasGetModel

API联动方式获取MIDAS中选中的几何模型

(1) 输入端

名称 缩写 默认值 可选 描述
Run R false 运行开关
MRequest M - MIDAS API请求对象

(2) 输出端

名称 缩写 描述
Node Tags NT 节点编号列表
Points P 节点坐标列表
Beam Tags BT 梁单元编号列表
Beam SecID BS 梁截面ID列表
Beam MatID BM 梁材料ID列表
Beam Curves BC 梁几何曲线列表
Truss Tags TT 桁架单元编号列表
Truss SecID TS 桁架截面ID列表
Truss MatID TM 桁架材料ID列表
Truss Curves TC 桁架几何曲线列表
Area Tags AT 面单元编号列表
Area SecID AS 面截面ID列表
Area MatID AM 面材料ID列表
Meshes M 面单元网格列表

用于通过API获取MIDAS Gen中当前选中的模型几何。需要先在MIDAS中选择要导出的节点和单元,然后运行此组件。

输出包括:

4.2. 分析控制 Analysis Control

4.2.1. 运行分析 Comp_05_Model.MidasRunAnalyze

运行MIDAS结构分析

(1) 输入端

名称 缩写 默认值 可选 描述
Run R false 运行开关
MRequest M - MIDAS API请求对象

(2) 输出端

名称 缩写 描述
Result Res 分析结果

用于触发MIDAS Gen执行结构分析。运行前请确保模型已正确设置边界条件、荷载工况等。

4.2.2. 非线性分析控制 Comp_05_Model.NonliearAnalyze

设置非线性分析控制参数

(1) 输入端

名称 缩写 默认值 可选 描述
Run R false 运行开关
MRequest M - MIDAS API请求对象
Nonlinear Type Type - 非线性类型
Iteration Method Method - 迭代方法
Energy Norm EN - 能量收敛容差
Displacement Norm DN - 位移收敛容差
Force Norm FN - 力收敛容差
Num Steps NS 1 分析步数
Max Iterations MI 30 最大迭代次数

(2) 输出端

名称 缩写 描述
Result Res 设置结果

用于设置MIDAS非线性分析的控制参数。

非线性类型包括:

迭代方法包括:

5. 结果 Result

5.1. 截图与结果提取

5.1.1. 截图 Comp_MIDASAPI_Capture

截取MIDAS模型视图并保存为图片

(1) 输入端

名称 缩写 默认值 可选 描述
MIDAS Key Key - MIDAS密钥
mode M - 模式:pre/post
save dir Dir C:\myMidas 保存目录
runIt R false 运行开关
——– - - 分隔线
h H 720 图片高度
w W 1080 图片宽度
active A - 激活设置
angle Ang - 视角设置
display D - 显示设置
resultGraph RG - 结果设置

(2) 输出端

名称 缩写 描述
midas key Key MIDAS密钥
file path Path 文件路径
success S 是否成功

用于截取MIDAS模型视图并保存为图片。支持两种模式:

可配合激活设置、视角设置、显示设置、结果设置等组件使用,实现自动化截图。

5.1.2. 分析结果2 Comp_MIDASAPI_TableResult_New

通过MIDAS API提取分析结果表格(新版)

(1) 输入端

名称 缩写 默认值 可选 描述
midas key Key - MIDAS许可
table type TT - 表格类型,可通过右键选择
runIt R false 运行开关
——– - - 分隔线
unit U - 单位设置
style S - 样式设置
nodeelemt NE - 节点或杆件编号封装
loadcase LC - 荷载工况列表
components C - 提取分量列表

(2) 输出端

名称 缩写 描述
unitF F 力单位
unitLength L 长度单位
headers H 数据表头
datas D 数据,树形结构

用于通过MIDAS API提取分析结果表格。支持多种表格类型,包括节点位移、单元内力、反力等。

荷载工况格式:

通过右键菜单选择表格类型。

5.2. 节点与单元 Nodes & Elements

5.2.1. 节点或单元 Comp_NodeElm

创建节点或单元标识对象

(1) 输入端

名称 缩写 默认值 可选 描述
Tags T - 标签列表

(2) 输出端

名称 缩写 描述
NodeElem NE 节点或单元对象

用于创建节点或单元标识对象,供其他组件使用。输入节点号或单元号列表,输出对应的标识对象。

5.2.2. 样式 Comp_Style

定义数值显示样式

(1) 输入端

名称 缩写 默认值 可选 描述
format F Fixed 格式:Fixed/Scientific/General
place P 2 小数位数

(2) 输出端

名称 缩写 描述
style S 样式对象

用于定义数值显示样式。支持三种格式:

5.2.3. 单位 Comp_Unit

定义MIDAS单位系统

(1) 输入端

名称 缩写 默认值 可选 描述
Force F KN 力单位:N/KN/TONF/KGF/LBF
Length L M 长度单位:MM/CM/M/IN/FT
Heat H KCAL 热量单位
TEMP T C 温度单位

(2) 输出端

名称 缩写 描述
Unit U 单位对象

用于定义MIDAS模型的单位系统。力单位支持N、KN、TONF、KGF、LBF;长度单位支持MM、CM、M、IN、FT。

5.3. 视图设置

5.3.1. 激活 Comp_Active

设置MIDAS视图中的激活对象

(1) 输入端

名称 缩写 默认值 可选 描述
nodeTag N - 节点标签列表
elemTag E - 元素标签列表
grouplabel G - 组标签列表

(2) 输出端

名称 缩写 描述
active A 激活设置对象

用于设置MIDAS视图中的激活对象。可以通过节点号、单元号或组名来指定要显示的对象。

如果同时输入节点/单元标签和组标签,优先使用组标签。

5.3.2. 视角 Comp_Angle

设置MIDAS视图视角

(1) 输入端

名称 缩写 默认值 可选 描述
horizental H 45 水平角度
vertical V 45 垂直角度

(2) 输出端

名称 缩写 描述
angle A 角度对象

用于设置MIDAS视图的视角。水平角度和垂直角度以度为单位。

5.3.3. 结果图形 Comp_ResultGraphics

设置MIDAS结果图形显示

(1) 输入端

名称 缩写 默认值 可选 描述
mode M - 模式
load case comb LC - 荷载组合
components C - 组件
type of display TD - 显示类型

(2) 输出端

名称 缩写 描述
result graphics RG 结果图形对象

用于设置MIDAS结果图形的显示方式。需要配合荷载组合、组件和显示类型等组件使用。

5.3.4. 显示类型 Comp_typeOfDisplay

设置MIDAS结果显示类型

(1) 输入端

名称 缩写 默认值 可选 描述
contour C - 云图设置
legend L - 图例设置
defrom D - 变形设置
values V - 数值显示设置

(2) 输出端

名称 缩写 描述
type of display TD 显示类型对象

用于设置MIDAS结果的显示类型。可分别设置云图、图例、变形和数值显示等选项。

5.4. 显示选项 Display Options

5.4.1. 云图 Comp_tod_Contour

设置云图显示选项

(1) 输入端

名称 缩写 默认值 可选 描述
showIt S true 是否显示云图

(2) 输出端

名称 缩写 描述
contour C 云图设置对象

用于设置是否在结果视图中显示云图。

5.4.2. 图例 Comp_tod_Legend

设置图例显示选项

(1) 输入端

名称 缩写 默认值 可选 描述
showIt S true 是否显示图例

(2) 输出端

名称 缩写 描述
legend L 图例设置对象

用于设置是否在结果视图中显示图例。

5.4.3. 数值显示 Comp_tod_Value

设置数值显示选项

(1) 输入端

名称 缩写 默认值 可选 描述
showIt S true 是否显示数值
decimal place D - 小数位数

(2) 输出端

名称 缩写 描述
value V 数值显示设置对象

用于设置是否在结果视图中显示数值以及数值的小数位数。

5.4.4. 变形显示 Comp_tod_deform

设置变形显示选项

(1) 输入端

名称 缩写 默认值 可选 描述
showIt S true 是否显示变形

(2) 输出端

名称 缩写 描述
deform D 变形设置对象

用于设置是否在结果视图中显示变形。

5.5. 荷载与组件 Load & Components

5.5.1. 荷载组合 Comp_rg_LoadCaseComb

定义荷载工况或组合

(1) 输入端

名称 缩写 默认值 可选 描述
name N - 工况名称,模态工况输入如"Mode 1"
type T - 类型
minmax MM - 最小最大选项:max/min/all
step S - 步长
th_option TH - 时程选项

(2) 输出端

名称 缩写 描述
loadcasecomb LC 荷载组合对象

用于定义荷载工况或组合。支持模态分析结果提取(如输入"Mode 1"提取第一模态结果)。

type选项包括:ST(静力)、TH(时程)、RS(反应谱)、MV(移动荷载)等。

5.5.2. 组件 Comp_rg_Components

定义结果组件类型

(1) 输入端

名称 缩写 默认值 可选 描述
comp name N - 组件名称,如"DX"、"FX"等

(2) 输出端

名称 缩写 描述
components C 组件对象

用于定义要提取或显示的结果组件类型。常见组件名称包括:

5.5.3. 组件名称列表 Comp_ComponentNames

输出各类结果组件的名称列表

(1) 输出端

名称 缩写 描述
vib buck VB 特征值|屈曲组件名称列表
displ deform DD 位移|变形组件名称列表
plane stress PS 壳应力组件名称列表
plane strain PN 壳应变组件名称列表

用于输出各类结果组件的名称列表,方便用户查询可用的组件名称。

6. 工具 Utility

6.1. MGT文件处理

6.1.1. MGT 提取表头 Comp_MGT_ExtractTItle

从MIDAS MGT文件中提取表头名称

(1) 输入端

名称 缩写 默认值 可选 描述
MGT FilePath Path - MIDAS MGT文件路径
Toggle T false 开关

(2) 输出端

名称 缩写 描述
Title T 表头名称列表

用于从MIDAS Gen的MGT文件中提取所有表头名称,便于了解文件结构。

6.1.2. MGT 读取模型 Comp_MIDAS_GetModel

从MIDAS MGT文件读取模型数据

(1) 输入端

名称 缩写 默认值 可选 描述
MGT FilePath Path - MIDAS MGT文件路径
Toggle T false 开关

(2) 输出端

名称 缩写 描述
Point P 点列表
Line L 线列表
Mesh M 网格列表
Line Type LT 线类型
Line Material LM 线材料号
Line Sect LS 线截面号
Mesh Type MT 面类型
Mesh Material MM 面材料号
Mesh Sect MS 面截面号
Section S 截面对象列表
Material M 材料对象列表
Frame F 框架单元列表
Beam Tags BT 线单元编号
Plate Tags PT 面单元编号

用于从MIDAS Gen的MGT文件中读取完整的模型数据,包括节点、单元、材料、截面等信息,并转换为Grasshopper几何对象。

6.1.3. MGT 提取内容 Comp_MIDAS_GetPart

从MIDAS MGT文件中提取指定表头的内容

(1) 输入端

名称 缩写 默认值 可选 描述
MGT FilePath Path - MGT文件路径
Title T - 表头名称
Toggle TG false 开关

(2) 输出端

名称 缩写 描述
Title T 提取的内容列表

用于从MIDAS Gen的MGT文件中提取指定表头下的内容数据。

6.2. CFD风荷载 CFD Wind Load

6.2.1. NFX CFD 结果解析 Comp_ParseNFXCFDResult

解析NFX CFD风洞模拟结果

(1) 输入端

名称 缩写 默认值 可选 描述
CFD Result Path Path - CFD文本路径(txt或excel)
Toggle T false 开关

(2) 输出端

名称 缩写 描述
Node N 节点列表
Pressure P 压强,树形数据结构
CFD Result Wrapper CFD NFX CFD结果对象

用于解析NFX CFD风洞模拟结果文件。支持两种输入模式:

通过右键菜单切换输入模式和解析方式(TXT/EXCEL)。支持设置坐标和数值的缩放系数。

6.2.2. NFX CFD 风速剖面 Comp_NFXWindProfile

定义风速剖面

(1) 输入端

名称 缩写 默认值 可选 描述
v10 V 25 10m高度处风速(m/s)
alpha A 0.22 地面粗糙度指数
h H 300 最大高度

(2) 输出端

名称 缩写 描述
Wind Profile Wrapper WP 风速剖面对象
Height H 高度列表
Value V 风速列表
Function F 函数表达式

用于定义风速剖面。根据风速剖面公式:,生成不同高度处的风速值。

alpha值根据地面粗糙度类别取值:A类0.12、B类0.16、C类0.22、D类0.30。

6.2.3. NFX CFD 匹配数据 Comp_NFXMatchValue2

将CFD结果匹配到结构网格

(1) 输入端

名称 缩写 默认值 可选 描述
CFD Result Wrapper CFD - NFX CFD结果对象
Plate Tags Tag - 面元标签
Mesh M - 网格列表
Wind Profile WP - 风速剖面
Tolerance Tol 0.1 容差
StartIndex SI 0 开始索引
Toggle TG false 开关

(2) 输出端

名称 缩写 描述
Node N 节点,树形数据
Pressure P 面压,树形数据
Cp C 风压系数,树形数据

用于将CFD分析结果匹配到结构网格上。采用面内点法,将CFD节点上的压力值映射到结构网格节点上。

支持多步数据提取,通过StartIndex控制起始索引号。点击组件上的按钮可启用/禁用组件。

6.2.4. NFX CFD 匹配数据(最近点法) Comp_NFXMatchValue

使用最近点法将CFD结果匹配到网格

(1) 输入端

名称 缩写 默认值 可选 描述
CFD Result Wrapper CFD - NFX CFD结果对象
Mesh M - 网格列表
Wind Profile WP - 风速剖面
Tolerance Tol 0.1 容差

(2) 输出端

名称 缩写 描述
MeshForce MF 面压力
Cp C 风压系数

用于将CFD分析结果匹配到结构网格上。采用最近点法,将CFD节点上的压力值映射到结构网格节点上。

此组件已过时,建议使用 Comp_NFXMatchValue2。

6.2.5. NFX CFD 节点荷载 Comp_NFXCFDNodalLoad

计算节点荷载

(1) 输入端

名称 缩写 默认值 可选 描述
MIDAS API Key Key - MIDAS API许可
CFD Result Wrapper CFD - NFX CFD结果对象
PlateTags Tag - 面单元号
Mesh M - 网格
Pressure P - 面压,树形数据
Toggle T false 开关

(2) 输出端

名称 缩写 描述
Node Tag N 节点编号列表
Force F 节点力,树形数据

用于计算面单元上的节点荷载。将面压转换为节点力,输出节点编号和对应的节点力向量。

6.3. 视图控制

6.3.1. MIDAS-API 同步至MIDAS Comp_MIDASAPI_ToMIDAS

将对象同步到MIDAS

(1) 输入端

名称 缩写 默认值 可选 描述
MIDAS API Key Key - MIDAS API许可
Object O - 实现了IMidasAPi的对象列表
Toggle T false 开关

(2) 输出端

名称 缩写 描述
MIDAS API Key K MIDAS API许可

用于将实现了IMidasAPi接口的对象同步到MIDAS软件中。支持批量同步多个对象。

此组件已过时,处于隐藏状态。

6.3.2. 视角设置 TMComp_MIDASAPI_SetViewAngle

设置MIDAS视图角度

(1) 输入端

名称 缩写 默认值 可选 描述
key K - MIDAS API许可
runIt R false 运行开关
HORIZONTAL H 15 水平角度
VERTICAL V 30 垂直角度

(2) 输出端

名称 缩写 描述
key K MIDAS API许可
success S 是否成功

用于设置MIDAS模型的视图角度。水平角度和垂直角度以度为单位。

6.4. 数据处理 Data Processing

6.4.1. 解构JSON对象 Comp_JObjViewer

解构JSON对象并提取属性名称

(1) 输入端

名称 缩写 默认值 可选 描述
JsonObject J - JSON对象

(2) 输出端

名称 缩写 描述
Level1 L1 一级属性名称列表
Level2 L2 二级属性名称列表

用于解构JSON对象,提取一级和二级属性名称,便于了解数据结构。