In this tutorial, you will learn how to use a ready-made Grasshopper script to post-process wind simulation results generated with infrared.city. The workflow allows you to log in, load your project, connect custom geometry, define wind speed thresholds, and analyze performance through an interactive Human UI dashboard.

This setup is ideal for quickly interpreting simulation data, calculating wind comfort areas, and exploring different environmental scenarios — all within your Grasshopper environment.

Step 1: Log In and Select Your Project

To begin, open the Grasshopper script and log in with your Infrared.city credentials using the Login component. After logging in, your available projects will appear in the dropdown menu next to Projects. Select the project you want to analyze from the list — for example, a location in Dubai. Once selected, click the Load Project button on the component to activate the project within the script.

Once a project is loaded, two internalized data components will be automatically added to your script:

• A Geometry component, containing any existing editable geometry currently stored in your project,
• An Analysis component, containing the current set of simulation parameters.

Because Grasshopper uses an explicit history logic, these components function separately from the project-loading process. This means you can update or modify the geometry freely without generating duplicates. If you are using your own site model, feel free to rename or remove the default components to keep things clear. Usually, the geometry brought in from the project serves as context, so it is perfectly fine to bake it, make edits, or replace it entirely with your own Rhino geometry if needed.

Step 2: Connect Your Design Geometry

To bring your own geometry into the workflow, you can use the Geometry Pipeline components provided in the script. These are already set up to reference layers named Design_Tower and Dubai_Environment, but you can easily customize them to match your own Rhino layer names.

Make sure to:

• Set the Layer input to the name of your layer in Rhino.
• Right-click on the Geometry Pipeline component and go to Layer Filter.
• In the text field that appears, type the exact name of the layer you want to reference.
• Leave the Name filter as ‘’*’’ to include all objects.
• Adjust the Type icons to match the geometry you are working with (e.g., breps for buildings, meshes for terrain, curves for outlines).

This setup ensures that your model is automatically pulled into the analysis without any need to manually reference geometry.

Step 3: Update the Project and Run the Simulation

Once your geometry settings are in place, it is time to sync your setup with the Infrared.city engine. Click the Update button on the Update Project component to send your geometry and parameters to the platform.

NOTE: Right-click on the Update Project component and ensure that Auto Update is enabled. Right-click on the Simulation component and ensure that Auto Update is enabled. This makes sure that every time you adjust a parameter or geometry, the setup is automatically refreshed without needing to click “Update” manually.

The platform will process your setup.

Step 4: Customize Threshold Values (Optional)

The script comes preloaded with a set of wind speed threshold values based on the Lawson Comfort Criteria, a widely used standard for evaluating pedestrian wind comfort. These thresholds are used to categorize the simulation results into meaningful ranges and calculate the percentage of area that falls within each range.

If you’d like to use your own wind speed intervals, simply update the values in the Threshold Values Panel. The script will automatically recalculate the performance metrics and apply them to the post-processing logic.

To define the intervals, simply enter a list of increasing wind speed values in the Threshold Values Panel. For example, entering: 0, 1.8, 3.6, 5.3, 7.6, 30 will generate the following intervals:

• 0–1.8 m/s
• 1.8–3.6 m/s
• 3.6–5.3 m/s
• 5.3–7.6 m/s
• 7.6–30 m/s

These intervals are then used to classify the simulation results, allowing the script to color the mesh and compute the area percentage for each range.

Step 5: Explore Results with the Human UI Dashboard

Once you have configured your threshold values and run the simulation, your setup is complete. From this point onward, you can interact with the results directly through the Human UI window — no need to modify anything in Grasshopper.

In the WIND SPEED ANALYSIS panel, use the sliders to adjust the Wind Direction and Wind Speed inputs. These parameters are linked to the simulation logic and dynamically influence the analysis results.

To visualize the simulation mesh, make sure to select one of the Wind Speed Thresholds using the radio buttons. This selection is required — if no option is selected, the mesh will not be displayed. Each button corresponds to one of the threshold intervals you defined earlier.

At the bottom of the panel, the % Area bar chart gives you a breakdown of how much area falls into each wind speed range. Combined with the mesh visualization, this offers a clear and intuitive view of the wind performance across your site.