Grasshopper API link - bulk calculation of steel joints (06)
If you work with IDEA StatiCa version up to 24.1.3, see this tutorial.
Grasshopper - Plugin Installation
You can get a trial version of Rhino3d and Grasshopper from the Rhino3d website. Run Rhinoceros and select the template with Meters:
In the Command line, please enter "Package Manager":
A new window appears; select IDEAStatiCa and click Install. The plugin will be downloaded and installed. To become active, a restart of Rhinoceros is necessary.
To start Grasshopper with the IDEA StatiCa plugin, select Tools / Grasshopper in the Rhihoceros tab.
As you can see, the plugin is already incorporated.
Learn about the components and commands in the IDEA StatiCa plugin for Grasshopper in the article Description of Grasshopper plugin components.
HUMAN plugin
In this example, we need to select part of the structure, and for this purpose, you have to install another plugin - HUMAN, which you will use in this tutorial.
IDEA StatiCa Checkbot – import of a structure, design of a joint
Open the attached folder with a structure imported from 3rd party software. Internal forces are included.
Please select one of the middle joints in the upper belt (e.g., C11) and open it in the IDEA StatiCa Connection.
You can design it correctly according to your needs or use our fully prepared joint here.
Go to the Developer tab, set the parameters, and link them to the appropriate operation according to the following pictures:
Finaly, store the whole joint as a template *.contemp, used later in Grasshopper.
Grasshopper - import XML file, apply the template
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 import.xml, found in the Checkbot folder. This file contains all the data from the imported structure.
Since version 24.1.4, IDEA StatiCa came 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.
When running this component, you should see the following window appear.
Now, you add the following components to the canvas and connect them as shown in the picture.
Import File and Display structure, including a description of joints in 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
Now you can see the structure in Rhino:
Import the template and apply it to the selected joints:
IDEA StatiCa / App Common / Create Connection from IOM
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 (import the template)
Params / Input / Boolean Toggle (3x)
Now you can see the structure with selected joints where the template was applied:
Grasshopper - modify parameters and run the calculation
Modify parameters:
IDEA StatiCa / Connection / Get Parameters
IDEA StatiCa / Connection / Update Parameters
IDEA StatiCa / Connection / Get Settings
IDEA StatiCa / Connection / Update Settings
IDEA StatiCa / App Common / Modify Object (2x)
IDEA StatiCa / Connection / Modify Code Setup (to simplify output table)
IDEA StatiCa / Connection / Modify Parameters
Params / Input / Panel (2x)
Params / Input / Boolean Toggle (5x)
Params / Input / Number Slider )2x)
Params / Sets / List Item (2x)
Params / Sets / Tree / Merge
Calculate joints:
IDEA StatiCa / Connection / Calculate Project
IDEA StatiCa / Connection / Deconstruct Result Item (passing data to components for the visualization)
IDEA StatiCa / Connection / Export IOM
IDEA StatiCa / Open Model / Connection Open Model (passing data to components for the visualization)
Params / Input / Boolean Toggle (2x)
Visualization of results:
Grasshopper allows you to enhance your results with graphic visualization. The components shown in the next picture allow you to see computed joints in green; the ones that do not pass the checks are then in red.
Here is the whole picture of the Grasshopper file to see the links between the components:
More complex examples can be found in the folder
“%appdata%\McNeel\Rhinoceros\packages\8.0\IDEAStatiCa\0.2.0\Examples0.2.0.zip”
Csatolt letöltések
- Connection-template.ideaCon (IDEACON, 76 kB)
- Project2-update.zip (ZIP, 138 kB)