Grasshopper

The CalcTree add-on for Grasshopper lets you run engineering calculations directly in your parametric design workflows. Connect to your workspace, select a calculation, and run it using single values.

Example Use Cases

• Automatically run design checks on parametrically produced designs in Revit

• Improve your optioneering process by filtering options through calculations before generating designs

• Automatically run additional checks on preferred parametric option to ensure design compliance

Installation

To install the CalcTree Grasshopper add-on:

1. Download the .gha file provided by the CalcTree. You can download it here.

2. Drag and drop it into your Grasshopper canvas

3. Drag the node from the CalcTree plugin ribbon to your canvas to use it.

If you need help with installation, contact us at [e-mail].

Getting Started

Drag the CalcTree Node onto your canvas. Right-click the node to:

• Enter your API key

• Set your Workspace URL

These can also be fed into the node from the panels.

The API key and Workspace URL are required to access your workspace calculations and can be updated any time via the node’s context menu.

Running Calculations

Single Calculation

• Enter parameter names as a comma-separated list into the INPUT_PARAM_NAMES input. Example: d,v

• Enter a single comma-separated list of values into INPUT_PARAM_VALUES. Example: 200,20

• The component will return the result values and the corresponding parameter names (both inputs and outputs).

Bulk Calculation

• Use the same format for INPUT_PARAM_NAMES.

• Provide multiple lines of comma-separated values in INPUT_PARAM_VALUES, with each line representing a unique input set.

• The component will run the calculation for each input row and return the results as a list of lists, (or data tree) of outputs.

Units

If you assign units to your inputs, these will be utilised in the calculation. If no units are assigned to input values, then the default units - whatever the units are set to for a given parameter on the original page - will be used.

Summary

The CalcTree Grasshopper add-on connects your design workflows to structured, verifiable engineering logic. It supports both single-value and bulk calculations, making it ideal for real-time feedback and parametric studies within Rhino.

If you need support, reach out at [e-mail].