The Display Assemblage Component visualizes the AssemblyObjects in the Assemblage in several ways.

inputs

• AOa - Assemblage
• D - Display Mode - see notesfor the selectable options
• C - Colors only (boolean - default False) - if True, only Colors and Values will output (to enhance display speed)

options

notes

Display Mode Options:

1. Objects (default mode) - all AO are visualized in white

2. AO types - color AO by their type

3. Occupancy - objects color is related to their occupancy status:

   • white - available: it is possible to grow the assemblage further from these objects
   • light green - unreachable: these objects cannot grow anymore. This might be due to the current Heuristics rules (no rule applies to that object), the environmental objects arrangement (i.e. they are outside a container or inside an obstacle/void)
   • dark green - saturated: all of its handles are connected

   <aside> 💡 The Occupancy mode is particularly useful during debugging: if your assemblage stops unexpectedly, check the Occupancy view and see if there are any white objects. If all (or most) objects are light green with no white objects chance is there is no more suitable rule to apply, or you just saturated the environment. In this case, check that you haven’t overconstrained the system, starting from your ruleset, but take a look at your environment settings and geometries as well.

   </aside>

4. Sequence - blue gradient (black-blue-white) - displays the assemblage history; old components in black, newest in white and blue shades in between

5. Z value - pink gradient - shows the Z level of each AO, relative to the whole assemblage - outputs normalized values from V

6. AO Weights - grayscale gradient - AO Weights are not yet used in standard strategies, but they can be exploited via scripting for bespoke uses

7. Connectedness - heat map (green to red) - amount of connected Handles in each object - outputs normalized values from V

8. Orientation - faux normal map (X, Y, and Z translated in RGB) showing the direction vector orientation relative to the world coordinate system

9. Z Orientation - faux normal map (X, Y, and Z translated in RGB) showing the Reference Plane Z axis vector orientation relative to the world coordinate system

10. Receiver values - white: minimum, dark red: maximum - Receiver Value (RV) of each AssemblyObject. When using the scalar field criteria, for example, the RV represents the absolute difference between the scalar Field value (sampled at the receiver) and the threshold value - outputs normalized values from V

11. Local density - shades of greenish gray - Volume of each AssemblyObject and its connected or occluded neighbours' Bounding Boxes / Volume of a Reference Bounding Box. The Reference Box is that of the largest AO in the AOSet scaled 2x - outputs normalized values from V

    The picture below show an AO (white), its connected neighbours (cyan), its occluded neighbours (magenta), their individual Bounding Boxes (yellow outline) and the Reference Box (black outline). Local Density is defined as the sum of individual Bounding Boxes volumes divided by the volume of the Union Box:

    $$ LocalDensity = \frac{\sum Vol_{individual BB}}{Vol_{RefBox}} $$