Idea Statica
钢结构
混凝土
支持与学习
价格
公司
14-Day Trial
Grasshopper API 链接 - 钢结构节点批量计算（06）
Grasshopper API 链接 - 钢结构节点批量计算（06）
SteelConnection designTutorialsConnectionIDEA Open Model (API)

Grasshopper API 链接 - 钢结构节点批量计算（06）

This article is also available in
ENDEESFRITPTNLHUROKRPLTHTRVIZH

在本教程中，您将学习如何使用参数化模板对具有相同几何形状的钢结构节点进行批量计算。

本教程使用 Rhino 8。如果您使用的是 IDEA StatiCa 24.1.3 及以下版本，请参阅此 教程。

Widget #NaN: support_center_article

Name: Tutorial: Grasshopper - Plugin Installation

ID: 6d5f0dc8-ee5a-4c50-aced-df94e3586763

Show Raw Data
{
  "title": {
    "name": "Main headline (H1)",
    "type": "text",
    "value": "Grasshopper - 插件安装"
  },
  "preview_image": {
    "name": "Preview image",
    "type": "asset",
    "value": [
      {
        "name": "E1-1.png",
        "description": null,
        "type": "image/png",
        "size": 68369,
        "url": "https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/fe255e56-8a4e-4dd5-8264-4c71f1dcb040/E1-1.png",
        "width": 782,
        "height": 692,
        "renditions": {}
      }
    ]
  },
  "post_date": {
    "name": "Post date",
    "type": "date_time",
    "value": null,
    "displayTimeZone": "Europe/Prague"
  },
  "perex_content": {
    "name": "Lead paragraph",
    "type": "text",
    "value": ""
  },
  "content": {
    "images": [
      {
        "description": null,
        "imageId": "210c0a21-6b2e-4cf8-96ca-37e82d4862fa",
        "url": "https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/79496c31-039f-4837-b79c-cb4138788fee/g-1.png",
        "height": 602,
        "width": 822
      },
      {
        "description": null,
        "imageId": "17b9256a-6aa1-42b7-8631-d3e7d4e045fa",
        "url": "https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/af466a09-7c9d-43da-aa86-ae8cf2e05680/g-2.png",
        "height": 265,
        "width": 492
      },
      {
        "description": null,
        "imageId": "2a7f156a-11b3-4615-bfa5-c5e91e966443",
        "url": "https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/992a6362-f26a-4ba4-9082-0da7868c65c5/E1-1.png",
        "height": 692,
        "width": 782
      },
      {
        "description": null,
        "imageId": "b957b01f-e69c-482c-841e-87a2cab6aca6",
        "url": "https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/71249ebe-9e05-4c66-bf72-1b3714c9decf/g-4.png",
        "height": 599,
        "width": 1077
      },
      {
        "description": null,
        "imageId": "8e7e6c80-c3e3-4d20-8aab-7481515ddf8d",
        "url": "https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/f0c189a8-203f-40ea-9248-7aaf4be667ec/grasshopper-idea.png",
        "height": 161,
        "width": 814
      }
    ],
    "linkedItemCodenames": [],
    "linkedItems": [],
    "links": [
      {
        "codename": "grasshopper___introduction_to_the_plugin_component",
        "linkId": "f2f373ad-9a22-499b-aced-f9520c80a37a",
        "urlSlug": "",
        "type": "support_center_article"
      }
    ],
    "name": "Content",
    "type": "rich_text",
    "value": "<p>您可以从 <a href=\"https://www.rhino3d.com/download/\" data-new-window=\"true\" target=\"_blank\" rel=\"noopener noreferrer\">Rhino3d</a> 网站获取 Rhino3d 和 Grasshopper 的试用版本。运行 Rhinoceros 并选择以<strong>米</strong>为单位的模板：</p>\n<figure data-asset-id=\"210c0a21-6b2e-4cf8-96ca-37e82d4862fa\" data-image-id=\"210c0a21-6b2e-4cf8-96ca-37e82d4862fa\"><img src=\"https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/79496c31-039f-4837-b79c-cb4138788fee/g-1.png\" data-asset-id=\"210c0a21-6b2e-4cf8-96ca-37e82d4862fa\" data-image-id=\"210c0a21-6b2e-4cf8-96ca-37e82d4862fa\" alt=\"\"></figure>\n<p>在命令行中，请输入\"<strong>Package Manager</strong>\"：</p>\n<figure data-asset-id=\"17b9256a-6aa1-42b7-8631-d3e7d4e045fa\" data-image-id=\"17b9256a-6aa1-42b7-8631-d3e7d4e045fa\"><img src=\"https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/af466a09-7c9d-43da-aa86-ae8cf2e05680/g-2.png\" data-asset-id=\"17b9256a-6aa1-42b7-8631-d3e7d4e045fa\" data-image-id=\"17b9256a-6aa1-42b7-8631-d3e7d4e045fa\" alt=\"\"></figure>\n<p>将弹出一个新窗口；选择 IDEAStatiCa 并点击<strong>安装</strong>。插件将被下载并安装。要使其生效，需要重启 Rhinoceros。</p>\n<figure data-asset-id=\"2a7f156a-11b3-4615-bfa5-c5e91e966443\" data-image-id=\"2a7f156a-11b3-4615-bfa5-c5e91e966443\"><img src=\"https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/992a6362-f26a-4ba4-9082-0da7868c65c5/E1-1.png\" data-asset-id=\"2a7f156a-11b3-4615-bfa5-c5e91e966443\" data-image-id=\"2a7f156a-11b3-4615-bfa5-c5e91e966443\" alt=\"\"></figure>\n<p>&nbsp;要启动带有 IDEA StatiCa 插件的 Grasshopper，请在 Rhinoceros 选项卡中选择<strong>工具 / Grasshopper</strong>。</p>\n<figure data-asset-id=\"b957b01f-e69c-482c-841e-87a2cab6aca6\" data-image-id=\"b957b01f-e69c-482c-841e-87a2cab6aca6\"><img src=\"https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/71249ebe-9e05-4c66-bf72-1b3714c9decf/g-4.png\" data-asset-id=\"b957b01f-e69c-482c-841e-87a2cab6aca6\" data-image-id=\"b957b01f-e69c-482c-841e-87a2cab6aca6\" alt=\"\"></figure>\n<p>如您所见，该插件已集成其中。</p>\n<figure data-asset-id=\"8e7e6c80-c3e3-4d20-8aab-7481515ddf8d\" data-image-id=\"8e7e6c80-c3e3-4d20-8aab-7481515ddf8d\"><img src=\"https://preview-assets-us-01.kc-usercontent.com:443/66e7a155-be94-0096-73e6-c55dfc7e5788/f0c189a8-203f-40ea-9248-7aaf4be667ec/grasshopper-idea.png\" data-asset-id=\"8e7e6c80-c3e3-4d20-8aab-7481515ddf8d\" data-image-id=\"8e7e6c80-c3e3-4d20-8aab-7481515ddf8d\" alt=\"\"></figure>\n<p>请参阅文章 <a data-item-id=\"f2f373ad-9a22-499b-aced-f9520c80a37a\" href=\"\">Grasshopper 插件组件说明</a>，了解 IDEA StatiCa Grasshopper 插件中的组件和命令。</p>"
  },
  "linked_items": {
    "name": "Linked items",
    "type": "modular_content",
    "value": [],
    "linkedItems": []
  },
  "regions": {
    "name": "Region",
    "type": "taxonomy",
    "value": [
      {
        "name": "AMER",
        "codename": "amer"
      },
      {
        "name": "EMEA",
        "codename": "emea"
      },
      {
        "name": "APAC",
        "codename": "apac"
      }
    ],
    "taxonomyGroup": "region"
  },
  "product_groups": {
    "name": "Product group",
    "type": "taxonomy",
    "value": [
      {
        "name": "Steel",
        "codename": "steel"
      },
      {
        "name": "Connection design",
        "codename": "connection_design"
      }
    ],
    "taxonomyGroup": "product_group"
  },
  "support_center_article_types": {
    "name": "Support center article",
    "type": "taxonomy",
    "value": [
      {
        "name": "Tutorials",
        "codename": "tutorial"
      }
    ],
    "taxonomyGroup": "support_center_article"
  },
  "expertise_levels": {
    "name": "Expertise level",
    "type": "taxonomy",
    "value": [
      {
        "name": "Intermediate",
        "codename": "intermediate"
      },
      {
        "name": "Expert",
        "codename": "expert"
      }
    ],
    "taxonomyGroup": "expertise_level"
  },
  "labels": {
    "name": "Labels",
    "type": "taxonomy",
    "value": [
      {
        "name": "IDEA Open Model (API)",
        "codename": "idea_open_model__api_"
      },
      {
        "name": "Connection",
        "codename": "connection"
      }
    ],
    "taxonomyGroup": "labels"
  },
  "attachments__files": {
    "name": "Attachments",
    "type": "asset",
    "value": []
  },
  "content_priority__value": {
    "name": "Content priority value",
    "type": "number",
    "value": null
  },
  "options": {
    "name": "Options",
    "type": "multiple_choice",
    "value": []
  },
  "url_slug": {
    "name": "Url slug",
    "type": "url_slug",
    "value": "grasshopper-plugin-installation"
  },
  "unique_url_slug": {
    "name": "Unique URL slug",
    "type": "custom",
    "value": "[\"grasshopper-plugin-installation\",\"[autogenerated]\"]"
  },
  "content_settings__sitemap": {
    "name": "Show in sitemap",
    "type": "multiple_choice",
    "value": []
  },
  "content_settings__robots": {
    "name": "Search engine indexing",
    "type": "multiple_choice",
    "value": []
  },
  "content_settings__is_hidden": {
    "name": "Hidden nested content",
    "type": "multiple_choice",
    "value": []
  },
  "content_settings__is_topped": {
    "name": "Topped",
    "type": "multiple_choice",
    "value": []
  },
  "metadata__page_title": {
    "name": "Page title",
    "type": "text",
    "value": ""
  },
  "metadata__page_description": {
    "name": "Page description",
    "type": "text",
    "value": ""
  },
  "metadata__page_keywords": {
    "name": "Page keywords",
    "type": "text",
    "value": ""
  },
  "metadata__canonical_url": {
    "name": "Canonical URL",
    "type": "text",
    "value": ""
  },
  "metadata__og_title": {
    "name": "OG:title",
    "type": "text",
    "value": ""
  },
  "metadata__og_description": {
    "name": "OG:description",
    "type": "text",
    "value": ""
  },
  "metadata__og_image": {
    "name": "OG:image",
    "type": "asset",
    "value": []
  },
  "translation__translation_connector": {
    "name": "Translation Connector",
    "type": "taxonomy",
    "value": [],
    "taxonomyGroup": "languages"
  },
  "translation__force_translation": {
    "name": "Force translation",
    "type": "multiple_choice",
    "value": []
  },
  "translation__translate_standalone_nested_content_items": {
    "name": "Translate standalone nested content items",
    "type": "multiple_choice",
    "value": []
  },
  "translation__last_translation": {
    "images": [],
    "linkedItemCodenames": [],
    "linkedItems": [],
    "links": [],
    "name": "Last translation",
    "type": "rich_text",
    "value": "<p>Translation info:</p>\n<ul>\n  <li>cs-CZ: Never translated</li>\n  <li>de-DE: Never translated</li>\n  <li>en-US: Never translated</li>\n  <li>es-ES: Never translated</li>\n  <li>fr-FR: Never translated</li>\n  <li>hu-HU: Never translated</li>\n  <li>it-IT: Never translated</li>\n  <li>nl-NL: Never translated</li>\n  <li>pl-PL: Never translated</li>\n  <li>pt-PT: Never translated</li>\n  <li>ro-RO: Never translated</li>\n  <li>ru-RU: Never translated</li>\n  <li>th-TH: Never translated</li>\n  <li>zh-CN: Translated on 5.5.2026 13:30</li>\n</ul>\n<p>Publish info:</p>\n<ul>\n  <li>Publish info is available only in the main language</li>\n</ul>"
  },
  "translation__ai_translated": {
    "name": "AI translated",
    "type": "multiple_choice",
    "value": [
      {
        "name": "Translated",
        "codename": "translated"
      }
    ]
  },
  "page_tree_settings__page_label": {
    "name": "Page label",
    "type": "text",
    "value": ""
  },
  "page_tree_settings__path_segment": {
    "name": "Path segment",
    "type": "text",
    "value": ""
  },
  "page_tree_settings__breadcrumb_style": {
    "name": "Breadcrumb style",
    "type": "multiple_choice",
    "value": []
  },
  "page_tree_settings__hide_in_breadcrumbs": {
    "name": "Hide in breadcrumbs",
    "type": "multiple_choice",
    "value": []
  }
}

HUMAN 插件

在本示例中，我们需要选取结构的一部分，为此您需要安装另一个插件—— HUMAN，本教程将使用该插件。

IDEA StatiCa Checkbot – 导入结构、设计节点

打开附带的文件夹，其中包含从第三方软件导入的结构，内力数据已包含在内。

请选择上弦中间节点之一（例如 C11），并在 IDEA StatiCa Connection 中将其打开。

您可以根据需要正确设计，或使用我们已准备好的节点，请点击此处。

转到"开发者"选项卡，设置参数，并按照以下图示将其链接到相应的操作：

最后，将整个节点保存为模板 *.contemp，供后续在 Grasshopper 中使用。

Grasshopper - 导入 XML 文件，应用模板

新建文档，在上方功能区选择 Params 选项卡，并在画布上放置 File Path 组件。 

右键单击该组件，选择 Checkbot 文件夹中的 import.xml 文件。该文件包含导入结构的所有数据。

自 24.1.4 版本起，IDEA StatiCa 提供了新的 API，详情请参阅 此处。

要运行 Grasshopper 脚本，必须在每个文件中添加名为 Connection Service Runner 的组件。该组件可在  IDEA StatiCa / App Common 中找到。

运行该组件时，您将看到以下窗口弹出。

现在，将以下组件添加到画布并按图示进行连接。

导入文件并在 Rhino 中显示结构（包括节点说明）：

IDEA StatiCa / Open Model / Import IOM File
IDEA StatiCa / Open Model / Deconstruct Open Model
IDEA StatiCa / Open Model / Deconstruct Open Model Object
IDEA StatiCa / Open Model Create / Deconstruct Member 1D

Params / Geometry / Curve
Params / Geometry / Point
Display / Dimensions / Text Tag

现在您可以在 Rhino 中看到该结构：

导入模板并将其应用于所选节点： 

IDEA StatiCa / App Common / Create Connection from IOM
IDEA StatiCa / Connection / Get Connection Settings
IDEA StatiCa / App Common / Deconstruct Object
IDEA StatiCa / Connection / Import Template file
IDEA StatiCa / Connection / Full template Assign
IDEA StatiCa / Connection / Apply Template

Human / Misc / Item Selector
Sets / Sets / Member Index
Sets / Lists / List item

Params / Primitive / File path（导入模板 - templ2.contemp）
Params / Input / Boolean Toggle（3 个）

现在您可以看到已应用模板的所选节点结构：

Grasshopper - 修改参数并运行计算

修改参数：

IDEA StatiCa / Connection / Get Parameters
IDEA StatiCa / Connection / Update Parameters

IDEA StatiCa / App Common / Modify Object（2 个）

IDEA StatiCa / Connection / Modify Code Setup（用于简化输出表格）
IDEA StatiCa / Connection / Modify Parameters

Params / Input / Panel（2 个） 
Params / Input / Boolean Toggle（3 个）
Params / Input / Number Slider（2 个）

Params / Sets / List Item（2 个）
Params / Sets / Tree / Merge

计算节点：

IDEA StatiCa / App Common / Deconstruct Object

IDEA StatiCa / Connection / Calculate Connection Project
IDEA StatiCa / Connection / Deconstruct Result Item  （将数据传递给可视化组件）
IDEA StatiCa / Connection / Export IOM

IDEA StatiCa / Open Model / Connection Open Model（将数据传递给可视化组件）

Params / Input / Boolean Toggle（2 个）
Params / Input / Number Slider（1 个）

结果可视化：

Grasshopper 允许您通过图形可视化增强结果展示。下图所示组件可将通过规范校核的节点显示为绿色，未通过规范校核的节点显示为红色。

以下是 Grasshopper 文件的完整视图，可查看各组件之间的链接关系：

更多复杂示例可在以下文件夹中找到

"%appdata%\McNeel\Rhinoceros\packages\8.0\IDEAStatiCa\0.2.5\Examples0.2.5.zip"