Grasshopper 与 Connection 之间的新 REST API

随着新版 Rest Connection API 的发布，与旧版 API（ConHiddenCalculator）相关的现有 Grasshopper 组件将不再可用，因为该 API 从 IDEA StatiCa 24.1.3 版本起已不再受支持。

插件安装

与旧版本相同，该插件可通过 Rhino Package Manager 进行安装。在 Rhino 命令提示符中输入 PackageManager 以打开包管理器。直接更新或安装最新版本的 IDEA StatiCa 插件即可。

新版 Grasshopper 插件的优势

使用新版插件，用户可以访问新 API 的增强功能，并实现 Grasshopper 与 IDEA StatiCa Connection 之间更便捷的交互。

旧版插件 0.1.X

• 使用组件时难以理解 API 内部的运行机制
• 大量 IO 操作
• 耗时操作（如计算）会导致脚本卡顿
• 针对所有对象的组件数量繁多
• 无法在一个项目中处理多个节点
• 难以选择特定版本的 IDEA StatiCa

新版插件 0.2.0

• 与实际 API 规范紧密耦合（更易于过渡到 Python 或 C#） 
• 项目保存在服务器上，直至用户手动保存
• API 组件为异步模式，组件计算期间用户可继续编写脚本
• 自动分解 API 对象
• 原生支持项目中的所有节点
• API 附加器/运行器支持便捷的版本指定
• 直接在 Grasshopper 中导出 IFC 文件 
• 模板应用工作流与软件统一
• 销钉和锚栓可在 IOM 组件中定义

组件概览

新插件在 Grasshopper 功能区中分为两个面板。 

1. App Common：适用于所有 IDEA StatiCa 设计 API 的通用 API 组件。 
2. Connection：专用于 Connection API 的组件。 

通过 Grasshopper 连接至 API

与其他 API 客户端类似，您可以将 Grasshopper 脚本连接至运行器 API 实例（Connection Service Attacher），或在 Grasshopper 内启动服务（Connection Service Runner）。用户必须先选择上述组件之一并运行，才能运行任何 API 组件。 

错误情况：

如果组件在没有有效 API 连接的情况下尝试运行，组件上将显示错误信息。

正确情况： 

一旦建立有效的 API 连接，Service 组件无需重新运行，直至脚本关闭或切换至其他脚本。连接信息存储在本地，所有组件均可访问。

API 组件

下方的"Active"按钮可方便地识别与 API 交互的组件。点击 Run 按钮可单次运行组件，也可通过将真/假切换开关连接至 Active 组件来持续执行。

API 组件与 Connection API 中的控制器密切相关。控制器分为基于动作型（计算、导出、报告）和基于对象型（荷载效应、构件、参数等）。

基于动作型：基于动作型控制器对特定节点或项目执行特定任务或操作，包括计算或导出功能。

 基于对象型：基于对象型控制器通常包含 Get 组件和 Update 组件：

• Get：检索 Connection 中所有控制器类型的对象，并获取可被分解或修改的特定对象。 
• Update：更新在 Grasshopper 脚本中已修改的对象。对象通过自动 Modify Object 组件进行更新。

大多数 API 组件接受输入并提供对象输出，这些对象可被分解或修改。以此格式提供组件可减少用户需要添加的组件总数。

最基本的示例是分解一个项目以获取其中的可用信息，例如可用的节点。 

简单示例——更新节点参数

请参阅 Modify 组件工作方式的简单示例。下图展示了在简单的模板应用及节点参数更新场景中使用 API 和自动对象组件的示例。 

可直接使用的示例

下载插件后，用户可在压缩文件中获取完整示例列表：%appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip

版本兼容性

新版插件 0.2.0 已在 Rhino Package Manager 中发布，适用于 IDEA StatiCa 24.1.3 及更新版本。

旧版插件 0.1.x 同样可用，适用于 IDEA StatiCa 24.1.2 及更早版本。

已在 IDEA StatiCa 24.1.4 版本中发布