入门指南
程序要求
该插件目前为 Rhino 7 开发。Grasshopper 免费且内置于 Rhino 7 中，因此无需单独安装 Grasshopper。有关版本兼容性，请访问 Rhinoceros 官网。
您可以从 Rhino3d 官网获取 Rhino3d 和 Grasshopper 的试用版本。
插件安装与要求
该插件可通过 Rhino 包管理器安装。安装完成并重启 Rhino 后，IDEA StatiCa 选项卡将在 Grasshopper 中可用。
IDEA StatiCa 是作为最新版本 IDEA Open Model (IOM) 和 IDEA API 模块的扩展而构建的。使用这些工具时，建议安装最新版本的 IDEA StatiCa，以确保正常运行并使用所有最新功能。
限制
- 目前，为使插件正常工作，Rhino 单位应设置为米。
- 所有输入单位也应以基本 SI 单位指定，遵循 IDEA Open Model 的命名规范。详情请参阅 Open Model 单位规范。
帮助与反馈
这些工具通过与高级用户及其所需工作流程的密切协作不断完善。我们非常希望听取任何反馈或改进功能的建议。最佳反馈方式是通过 IDEA StatiCa 公共 GitHub 上的论坛提交。
简介
IDEA StatiCa Grasshopper 插件由以下主要部分组成：
1. 用于生成 IDEA Open Model (IOM) 的组件
这些组件用于实现：
- 创建、导入或修改 IDEA Open Model。
- 自定义有限元分析转换
- 几何转换：IOM <-> Rhino
- 构件、板件、螺栓、切割和焊缝的显式建模。
2. 用于与 IDEA 设计应用程序交互的组件
这些组件用于：
- 创建、导入和修改设计应用文件，例如节点。
- 获取和更新几何形状及组件。
- 应用用户自定义模板。
- 获取和更新用户自定义参数。
- 运行计算并提取结果。
- 获取更多设计信息（包括加工成本等）
用于生成 IOM 的组件与 API 无关，因此不需要 IDEA StatiCa 许可证。
与 IDEA StatiCa 设计应用程序交互的组件需要有效的 IDEA StatiCa 许可证。在涉及几何转换和互操作性的情况下，Open Model 组件可在设计应用程序组件中使用。
Open Model 对象组件
对象组件与 Open Model 数据格式中的特定对象类型相关。基本上，任何需要具有 Id 或 Name 的对象都可以归类为 Open Model 对象。
对象创建
所有 Open Model 对象都需要具有 Id 和 Name。为加快对象创建速度并提高可用性，大多数对象在创建时不需要用户定义的 Id 或 Name，可在添加并编译到模型时自动分配。
[!NOTE] 未自动分配 Id 或 Name 的对象将被赋予 Id = 0 和空 Name 字符串。
使用创建组件时，输出应显示分配给该对象的 Name 和 Id。输出字符串为 Open Model 对象类型。
[!IMPORTANT] 在 Grasshopper 中创建对象时，对象 Name 对于特定对象类型应为唯一字符串。
[!NOTE] 某些特定对象（如材料、截面、荷载工况和组合）在创建时确实需要指定名称。
Open Model 结果组件
Open Model 结果用于存储相关分析构件的分析结果。使用 Grasshopper，可以利用可用组件轻松创建 Open Model 结果格式的结果。
这提供了一种将物理模型与有限元分析模型结果相关联的灵活方式。
[!NOTE] 请参阅 Open Model 结果的相关文档，了解内力命名规则以及如何创建正确的 Open Model 结果文件的说明。
创建 Open Model 结果
创建 Open Model 结果的方式与其他编译对象类型类似。首先，应使用所需设置创建高层级对象；然后，可通过添加或更新现有实体对其进行修改。
IDEA Connection 应用程序组件
本节简要介绍在 Grasshopper 中用于处理 IDEA StatiCa Connection 文件的可用组件。
Connection 对象
大多数与 IDEA Connection 应用程序相关的组件允许传递"Connection"对象。
Connection 对象是对保存在磁盘上的 IDEA Connection 文件的引用。首先，用户需要引用之前已创建的现有节点，或使用 Open Model 组件从头创建一个。
在 Grasshopper 中，每个"Connection"对象被视为单个节点对象。包含多个节点的 IDEA Connection 项目文件在 Grasshopper 中会被分离，并作为具有引用文件路径和名称的多个对象处理。
[!WARNING] 建议使用仅包含单个节点的 IDEA StatiCa Connection 项目文件。
Connection 对象还可以存储和管理从程序中提取的可用信息的副本。在节点被修改之前，该副本应保持持久性——这可减少对 API 的调用次数。
Connection 对象组件
以下是可用于处理 Connection 对象的组件列表。
由于用户可能需要同时处理大量节点，因此已添加了多种完成任务的方式，允许您逐个批量更新单个节点，而非通过多个并行操作进行更新。因此，通常有多种方式来完成某些类型的任务。
为提高性能，建议在引用节点时尽量加载更多信息，并在执行修改时尽量将多个修改合并为一个步骤。
| 组件 | 说明 |
| Reference Connection | 引用磁盘上的现有节点以执行自动化操作。引用节点时，您可以选择预加载部分节点信息。这将打开节点并提取有关节点的基本信息。如果您不对节点对象进行大量修改，这可能会节省后续处理时间。 |
| Create from IOM | 从 IOM 格式创建 IDEA Connection 文件。用户可以输入现有模型 XML 文件的文件路径，或直接连接从 IOM 组件库创建的 OpenModel 对象。 |
| Update from IOM | 允许用户使用修改后的 IDEA Open Model 文件更新现有节点文件。这通常与 Extract IOM Container 组件配合使用。 |
| Deconstruct | Deconstruct 组件可用于获取节点对象的一般信息，例如节点名称、文件路径、设置等。 |
| Calculate Connection | 执行节点计算。结果被读取并保存到 Connection 对象中。如果节点在后续被修改，结果将从对象中清除。要查看结果，请将节点传递给 Connection Results 组件。计算运行后，Connection 将自动保存。 |
| Connection Results | 节点计算完成后，结果存储在 Connection 对象上，可使用 Connection Results 组件检索。结果可按不同元素的特定键进行筛选。 |
| Modify Connection | 允许您对节点项目进行更改。详情请参阅下文。 |
| Apply Template | 使用可用的模板设置将模板应用于节点。请参阅下方关于模板的章节。 |
| Get Connection Geometry | 将节点的几何形状检索到 Grasshopper 中。此操作将导出节点并将其转换为 Open Model 对象。构件和节点数据分别导出。该组件对于直接与 CAD 软件链接非常有用。 |
| Get Connection Costs | 允许用户提取节点的详细加工成本。每个成本项目可使用 Deconstruct Cost item 组件分解为细粒度成本项目。 |
| Evaluate Expression | Evaluate Expression 允许您对表达式进行求值。表达式通常在参数界面中使用，但也可以直接在应用程序内部使用。参数参考指南提供了可用参数的示例。请参阅表达式参数参考指南。 |
Connection 模板组件
Connection 模板是存储复杂操作数据的文件，可在拓扑相似的节点之间传递。模板还存储任何已定义的节点参数以及有关基础节点的其他信息，例如构件几何形状和截面类型。Grasshopper 提供了一些组件，允许应用和解构 IDEA StatiCa 模板文件。
Connection 模板对象
在 Grasshopper 中，您可以引用任意数量的预定义模板。目前，只有保存到磁盘（格式为".ideatemp"）的模板才可在 Grasshopper 中导入。
导入模板后，我们可以提取其中存储的可用参数。这使我们能够了解模板分配后节点文件中将有哪些参数可用。
[!NOTE] 模板可以通过 IDEA StatiCa Connection 中的开发者模式从基础节点导出。
Grasshopper 示例文件
示例文件目前随插件安装文件一同提供。
在安装文件夹目录中
%appdata%\McNeel\Rhinoceros\packages\7.0\IDEAStatiCa\0.1.1\ 有一个 .zip 文件夹：
Examples.zip
该文件夹包含目前可用的多个工作流示例。
