The Distance to analyser produces a colour map showing how far all accessible points are from a chosen target point. If multiple target points are chosen the colour map will display the shortest distance to any one of the target points.
In the example below we use a small section of a Rhino model model of the London area to demonstrate how to use the analyser.
A single target point is defined (x). Green indicates a short distance from the target, red indicates a long distance from the target and grey indicates areas which are inaccessible. Note that the distance is not simply shortest straight line distance but accounts for avoiding obstacles (buildings in this case).
How do I use it?
Before starting, make sure you have Distance to selected in the Analyser drop down menu.
Define your Analysis area
1. Draw a bounding box (curve) around the area to be analysed in the Rhino window. This can be any closed planar curve. In the image above this is the rectangle bounding the entire image. Alternatively you can use an existing closed curve in your model and move to Step 2.
2. On your Grasshopper canvas add a Geometry component by double clicking the canvas and typing ‘geometry’. Connect the geometry output to the Analysis area input of the SmartSpaceAnalyser component.
3. Right click the geometry component and click ‘set one geometry’.
4. Select your bounding curve in the Rhino window, drawn in Step 1. This curve is now set as your Analysis area. To change it simply repeat Steps 3 and 4 selecting an alternative geometry.
Define your Obstacles
5. Draw your set of obstacles in the Rhino window. This can be any number of closed or open planar curves. In the image above this is the set of buildings coloured in grey. Alternatively you can use an existing set of geometry in your model and move to Step 6.
6. On your Grasshopper canvas add another Geometry component as in Step 2. Connect the geometry output to the Obstacles input of the SmartSpaceAnalyser component.
7. Right click the geometry component and click ‘set multiple geometries’, or ‘set single geometry’ if you only have one obstacle.
8. Select your obstacle curves in the Rhino window, drawn in Step 5, and press enter. These curves are now set as your obstacles. To change them simply repeat Steps 7 and 8 selecting an alternative set of geometry. It is also possible to add extra obstacles by plugging in a second or third geometry component and attaching additional geometries to them.
Top Tip: one of your Obstacles must completely enclose your Analysis area.
Define your Target point
9. Draw a point in the Rhino window. In the image above this is the red cross and is the point from which your distance analysis will be measured.
10. On your Grasshopper canvas add a Point component by double clicking the canvas and typing ‘point’. Connect the point output to the Target point input of the SmartSpaceAnalyser component.
11. Right click the point component and click ‘set one point’.
12. Select your point in the Rhino window, drawn in Step 9. This point is now set as your Target point. To change the target at any time simply repeat steps 11 and 12 selecting an alternative point. It is also possible to include multiple target points by choosing ‘select multiple points’ in Step 11. In this case the distance analysis will display the shortest distance to any target point.
13. You are now ready to click ‘Run analyser’ and observe your analysis output in Rhino. Remember, the output visualised in Rhino will depend on the output type you have selected in the Output drop down menu.
All other features of the Distance to analyser are optional. Please refer to the section ‘The Component’ for more details.
Top tip: Analysis areas, obstacles and target points can be dragged to new locations in the Rhino window but be aware that moving any of these objects will cause the analysis to rerun if the ‘Run Analyser’ check box is ticked.