compas_3gs.algorithms.volmesh_ud

compas_3gs.algorithms.volmesh_ud(volmesh, network, scale=0.5)[source]

Computes temporary vertex coordinates for every halfface of a volmesh, for the visualisation of the unified diagram.

Parameters
  • volmesh (VolMesh) – A volmesh object representing a polyhedral force diagram.

  • network (Network) – A network object representing a polyhedral form diagram.

  • scale (float) – Unified diagram scale factor,

Returns

  • halffaces (dictionary) – A dictionary of dictionaries: hfkey-{vkey: (x, y, z)}.

  • prisms (dictionary) – A dictinoary of dictinoaries: uv - [face coordinates]

Raises
  • Exception – If scale is 0, which means the unified diagram is equivalent to the polyhedral force diagram.

  • Exception – If scale is 0, which means the unified diagram is equivalent to the polyhedral form diagram.

Notes

  • The prisms are implemented as convex hull of two halffaces for simplicity and to resolve any small geometric errors.

  • Unified diagram with a scale of 0 is equivalent to the polyhedral force diagram, while a scale of 1 is equivalent to the polyhedral form diagram.