Entourage Placement Exploration


This graph will generate a series of scenes with different entourage elements. Entourage elements are placed in clusters that imitate the organic positioning of random elements within a space.

Begin by selecting a space/room, then the entourage elements (people, trees, etc). After that, set your different cluster constraints, and finally review the metrics related to how these elements relate to each other.

This workflow is intended to be used with the 'Randomize' mode. Because of this, no optimization criteria is needed however some outputs are provided to give a better view of (some of) the attributes of each scene.

With this workflow you can save time by quickly generating multiple scenes without having to manually place each element.

This sample file is available in the most recent version of Generative Design in Revit.

Static inputs




Room in which the entourage will be placed

Families for entourage

Family instance for each element you want to include in your entourage




Minimum /Maximum cluster count (u)

Range for number of clusters

Minimum /Maximum spacing per cluster (m)

Range of spacing per each cluster

Minimum /Maximum elements per cluster (u)

Range of number of elements per cluster

Variable inputs



Seed cluster count

Determines amount of clusters

Seed cluster Us/Vs

Determines UV position of each cluster

Seed spacing in cluster

Determines spacing for each cluster

Seed elements per cluster

Determines amount of elements in each cluster

Seed element location

Determines element location per cluster


The script is made up of a series of functions, which are divided into groups inside the graph. Each group has a name and a short description. The name indicates the type of function being run and the description explains the process in more detail.

The script will begin by extracting the surface of a room. This room will be used for placing the entourage elements. Then, it'll continue to create a series of clusters of elements. After that, it'll filter and place only the elements that are inside the designated room, before continuing by randomly assigning a family instance to each point. Metrics will be calculated relating the new family instances and the point of interest.


The results in Explore Outcomes will display the surface of the room selected, the point of interest and the entourage elements as lines. We suggest you combine this with the 3d view used so that you get results as you export them to Revit.


There is no optimization in this example, however some metrics will provide information on the scenes you've created.



Number of elements (u)

Number of elements created in the scene

Overall spacing (mm)

Distance between elements in the scene


Once generation has completed, the results can be explored through the tables and graphs in the Explore Outcomes dialog.

The image below shows an example output from a randomized study based on 40 solutions.

A More Organic Random Using Gaussian Distribution

One of the key elements to understand when placing elements randomly is Gaussian distribution.

By using Gaussian normal distribution instead of the regular, randomized method you can control the clustering of elements so that your placement will feel more organic.

For further reading on this, please refer to the following website:

Video Tutorial

pageArchitectural Workflows

Last updated