Idea Statica
钢结构
混凝土
支持与学习
价格
公司
14-Day Trial
Grasshopper API 链接 - 如何导入和计算参数化节点模型（02）版本 24
Grasshopper API 链接 - 如何导入和计算参数化节点模型（02）版本 24
SteelConnection designTutorialsConnectionIDEA Open Model (API)

Grasshopper API 链接 - 如何导入和计算参数化节点模型（02）版本 24

This article is also available in
ENDEESFRITPTNLHUROKRPLTHTRVIZH

在本教程中，您将学习如何使用参数化节点并在 Grasshopper 中对其进行修改和评估。 注意：本手册适用于 24.1.2 及以下版本。



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": []
  }
}

Colibri 插件

由于 Grasshopper 无法使用循环，您需要安装另一个插件 - COLIBRI，本教程将使用该插件。

   

IDEA StatiCa Connection – 节点设计与参数设置

在本示例中，您将使用模板创建一个简单的刚性节点：

为了能够使用参数，需要在首选项 / 高级设置中启用开发者选项卡： 

首先，您需要根据下图设置荷载：

现在，您需要为该节点设置两个参数。第一个参数为端板的厚度。点击开发者选项卡中的加号按钮，并按照下图修改文本：

要将此参数与相应的端板厚度关联，请点击链接按钮，并按照下图选择属性字段：

 第二个参数为螺栓直径：

注意：表达式为文本类型，因此必须使用单引号。

将此参数与相应的操作关联：

现在，您可以在模型属性选项卡中查看链接：

由于目标是调整螺栓直径，我们需要将相应的螺栓组件添加到文件中：


最后，您可以将该节点保存为 Example2.ideaCon。

Grasshopper - 导入 *ideaCon 文件并修改参数

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

右键点击该组件，选择之前保存的 Example2.ideaCon 文件。 

注意：如果您打开附带的文件，必须相应地修改此路径。 

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

导入文件：

IDEA StatiCa / Connection / Reference Connection
IDEA StatiCa / Connection / Deconstruct Connection
IDEA StatiCa / Connection / Modify Connection

查看参数：

IDEA StatiCa / Connection / Deconstruct Parameters

您可以在此添加 Params / Input / Panel 组件以查看参数值。

修改参数：

IDEA StatiCa / Connection / Modify Parameters (1)
IDEA StatiCa / Connection / Modify Parameters (2)
IDEA StatiCa / Connection / Modify Connection

对于具有不同结果的修改文件，我们设置后缀 _updated。 

计算与结果：

IDEA StatiCa / Connection / Calculate Connection
IDEA StatiCa / Connection / Connection Results
IDEA StatiCa / Connection / Deconstruct Result Items

同样，您可以在此添加 Params / Input / Panel 组件以查看结果值。

用于迭代参数组合的 Colibri 组件：

TTTollbox / Colibri Inputs
TTTollbox / Colibri Outputs
TTTollbox / Colibri Aggregator

对于输入，第一个值列表包含 3 个值（0.010、0.015、0.020），对应端板厚度。
第二个值列表包含三个值（M12 8.8、M14 8.8、M16 8.8），对应螺栓直径。
结果存储在 data.csv 文件中。默认存储路径为 c:\Colibri；此处建议将路径设置为 C:/IDEA。请确保您具有相应的访问权限。

点击 Colibri Inputs / Fly 按钮以完成整个迭代过程。稍后，CSV 文件将被创建。

打开文件后，可以直观地看到以 True / False 表示的结果。 

结果解读

对于该特定节点，以下方案可获得满足要求的结果： 

  • 螺栓 M16 8.8，端板厚度 10 mm

或

  • 螺栓 M14 8.8，端板厚度 15 mm

更多复杂示例可在您的电脑中以下目录找到：

"%appdata%\McNeel\Rhinoceros\packages\7.0\IDEAStatiCa\0.1.1\Examples.zip"

相关录像

第 1 部分 - 在 IDEA StatiCa Connection 中设置参数

第 2 部分 - 上传节点并在 Rhino 中显示

第 3 部分 - 对参数进行循环迭代

第 4 部分 - 结果解读