form_update_with_parallelisation

compas_tno.algorithms.form_update_with_parallelisation(form, zmax=5.0, plot=False, printout=False, alpha=100.0, kmax=500, callback=None)[source]

Parallelise a TNO form diagram using as starting point the centroidal dual as ForceDiagram.

Parameters

  • form (FormDiagram) – The form diagram to update.

  • zmax (float, optional) – The maximum height of a node in the thrust network. The default value is 5.0.

  • plot (bool, optional) – If plots with form and force should display on the screen. The default value is False.

  • plot (bool, optional) – If prints should appear in the screen with key information. The default value is False.

  • alpha (float, optional) – Weighting factor for computation of the target vectors (the default is 100.0, which implies that the target vectors are the edges of the form diagram). If 0.0, the target vectors are the edges of the force diagram.

  • kmax (int, optional) – Maximum number of iterations. Default is 500.

  • callback (callable, optional) – A callback function to be called at every iteration of the parallelisation algorithm. The callback should take the current iterand, the coordinates of the form diagram, and the coordinates of the force diagram as input parameters. Default is None.

  • Nores

  • ———

  • See `compas tna <https (//blockresearchgroup.github.io/compas_tna/>`_ package.)

Returns

force (ForceDiagram) – The force diagram after the process.