SteelConnection designTutorialsConnectionIDEA Open Model (API)

Grasshopper API link - how to create an IDEA StatiCa IOM file for imports (01)

This article is also available in

In this tutorial, you will learn how to create an IOM file from a template and work with it in Grasshopper 3D.

This tutorial is using Rhino 8. If you work with IDEA StatiCa version up to 24.1.3, see this tutorial.

Widget #NaN: support_center_article

Name: Grasshopper - Plugin Installation

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

Show Raw Data

{
  "title": {
    "name": "Main headline (H1)",
    "type": "text",
    "value": "Grasshopper - Plugin Installation"
  },
  "preview_image": {
    "name": "Preview image",
    "type": "asset",
    "value": [
      {
        "name": "E1-1.png",
        "description": null,
        "type": "image/png",
        "size": 68369,
        "url": "https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/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://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/79496c31-039f-4837-b79c-cb4138788fee/g-1.png",
        "height": 602,
        "width": 822
      },
      {
        "description": null,
        "imageId": "17b9256a-6aa1-42b7-8631-d3e7d4e045fa",
        "url": "https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/af466a09-7c9d-43da-aa86-ae8cf2e05680/g-2.png",
        "height": 265,
        "width": 492
      },
      {
        "description": null,
        "imageId": "2a7f156a-11b3-4615-bfa5-c5e91e966443",
        "url": "https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/992a6362-f26a-4ba4-9082-0da7868c65c5/E1-1.png",
        "height": 692,
        "width": 782
      },
      {
        "description": null,
        "imageId": "b957b01f-e69c-482c-841e-87a2cab6aca6",
        "url": "https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/71249ebe-9e05-4c66-bf72-1b3714c9decf/g-4.png",
        "height": 599,
        "width": 1077
      },
      {
        "description": null,
        "imageId": "8e7e6c80-c3e3-4d20-8aab-7481515ddf8d",
        "url": "https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/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": "description-of-grasshopper-plugin-components",
        "type": "support_center_article"
      }
    ],
    "name": "Content",
    "type": "rich_text",
    "value": "<p>You can get a trial version of Rhino3d and Grasshopper from the <a href=\"https://www.rhino3d.com/download/\" data-new-window=\"true\" target=\"_blank\" rel=\"noopener noreferrer\">Rhino3d</a> website. Run Rhinoceros and select the template with <strong>Meters</strong>:</p>\n<figure data-asset-id=\"210c0a21-6b2e-4cf8-96ca-37e82d4862fa\" data-image-id=\"210c0a21-6b2e-4cf8-96ca-37e82d4862fa\"><img src=\"https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/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>In the Command line, please enter \"<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://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/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>A new window appears; select IDEAStatiCa and click <strong>Install</strong>. The plugin will be downloaded and installed. To become active, a restart of Rhinoceros is necessary.</p>\n<figure data-asset-id=\"2a7f156a-11b3-4615-bfa5-c5e91e966443\" data-image-id=\"2a7f156a-11b3-4615-bfa5-c5e91e966443\"><img src=\"https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/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;To start Grasshopper with the IDEA StatiCa plugin, select <strong>Tools / Grasshopper </strong>in the Rhihoceros tab.</p>\n<figure data-asset-id=\"b957b01f-e69c-482c-841e-87a2cab6aca6\" data-image-id=\"b957b01f-e69c-482c-841e-87a2cab6aca6\"><img src=\"https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/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>As you can see, the plugin is already incorporated.</p>\n<figure data-asset-id=\"8e7e6c80-c3e3-4d20-8aab-7481515ddf8d\" data-image-id=\"8e7e6c80-c3e3-4d20-8aab-7481515ddf8d\"><img src=\"https://assets-us-01.kc-usercontent.com:443/28eac049-c8ed-00e2-220c-12142a968dff/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>Learn about the components and commands in the IDEA StatiCa plugin for Grasshopper in the article <a data-item-id=\"f2f373ad-9a22-499b-aced-f9520c80a37a\" href=\"\">Description of Grasshopper plugin components</a>.</p>"
  },
  "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"
  },
  "linked_items": {
    "name": "Linked items",
    "type": "modular_content",
    "value": [],
    "linkedItems": []
  },
  "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__last_translation": {
    "images": [],
    "linkedItemCodenames": [],
    "linkedItems": [],
    "links": [],
    "name": "Last translation",
    "type": "rich_text",
    "value": "<p><br></p>"
  },
  "translation__ai_translated": {
    "name": "AI translated",
    "type": "multiple_choice",
    "value": []
  },
  "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": []
  }
}

IDEA StatiCa Connection - Export a joint as an IOM file

For this example, open the attached ideaCon file.

To be able to work with IOM, it is necessary to enable the Developer tab in Preferences / Advance Settings:

Export this connection to the IOM file Example1.xml.

Grasshopper - Import the IOM file, display the joint in Rhino, and see the calculation results

Create a new document, select the tab Params in the upper ribbon, and place the component File Path on the Canvas.

Right-click on the component and select the file we saved before:

Note: If you open the attached file, you must change this path accordingly.

Since version 24.1.4, IDEA StatiCa has come with a new API, described here.

To run Grasshopper scripts, you must add a component called Connection Service Runner to every file. This component can be found in IDEA StatiCa / App Common.

To connect the Grasshopper plugin to the correct IDEA Connection version, add the component File Path and link it to the actual IDEA folder (C:\Program Files\IDEA StatiCa\StatiCa 25.1)

When running this component, you should see the following window appear.

Now add the following components to the canvas and connect them as seen in the picture.

IDEA StatiCa / Open Model / Import IOM File
IDEA StatiCa / Open Model / Deconstruct Open Model
IDEA StatiCa / Open Model Create / Deconstruct Connection Point
IDEA StatiCa / App Common / Create IDEACon
IDEA StatiCa / Connection / Calculate IDEA Connection
IDEA StatiCa / Connection / Deconstruct Result Item
Params / Input / Boolean Toggle
Params / Input / Panel

To run the calculation and get visible results, double-click on False/True. If you added the components Deconstruct Open Model and Deconstruct Connection Point, you can also see the contours and plates of the joint in Rhinoceros.

More complex examples can be found on your PC in the directory

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