Using Suimple

Preparing Grasshopper Files

Groups

Suimple starts by looking at your document for all groups that start with the word “Input” or “Output”. You can include characters after that as well, and the whole name will be shown in the Suimple Interface.

Once Suimple finds those groups, it looks at the components within those groups, and creates a form that links the Suimple window to the components on your Grasshopper script.

Layout Order

Currently, Suimple will organize the groups vertically in the window, with the sequence determined by: 1) Ordered left to right, then 2) vertically

Within the group, the components are ordered based on their vertical order within the Group.

You can find more information about the specifics of inputs and outputs at the dedicated pages.

Selecting Grasshopper Files

There are three options for loading scripts into Suimple:

Active Files

Load from the currently active, open Grasshopper scripts. If you make changes to the file, you’ll need to click “Load” again to update the form.

Library

If you click on the “Library” button, it will give you the option of designating a library location. Once you have done that, you can click on the Library button again, and there will be a set of nested folders that mirrors your folder structure.

Once you click on the file, it will automatically load. the file in the background. Grasshopper’s splash screen may appear if it has not been loaded yet.

If you want to actually see the Grasshopper script, you can click Show in GH to reveal it.

Directly From File

Similarly, you can navigate to a file and load it without loading the Grasshopper UI. This behaves similarly to the above.

Warning

Be mindful when you use the Show in GH button. When you do that, the file becomes an “Active” file, because it is active in the Grasshopper UI. If you want to reload the form, and you use the Library or From File modes, you will actually be opening an additional, separate instance in the background. Therefore, if you use Show in GH, and want to reload the form, you should either close the file, or now use the Active File option.

Interacting with Grasshopper Files

Once the form is loaded, you can choose to update content in the script a few different ways:

1) Run Entire Script

This button will send all of the information in the form to Grasshopper and trigger a new solution.

2) Update Only One Group

You can also choose to update only one group of components. This will only expire the corresponding components.

3) Auto Update for Sliders

If this box is checked, then any changes to any sliders will be automatically sent to Grasshopper.