static_equilibrium

compas_cem.equilibrium.static_equilibrium(topology, kmax=None, tmax=100, eta=1e-06, verbose=False, callback=None)[source]

Generate a form diagram in static equilibrium.

Parameters:
  • topology (compas_cem.diagrams.TopologyDiagram) – A topology diagram.

  • kmax (int, optional) – The last sequence in the diagram to calculate equilibrium at. If kmax is None or the number of sequences in the diagram is smaller, then kmax will be ignored and equilibrium will be calculated for all sequences. Defaults to None.

  • tmax (int, optional) – Maximum number of iterations the algorithm will run for. Defaults to 100.

  • eta (float, optional) – Distance threshold that marks equilibrium convergence. This threshold is compared against the sum of distances of the nodes’ positions from one iteration to the next one. If eta is hit before consuming tmax iterations, calculations will stop early. Defaults to 1e-6.

  • verbose (bool, optional) – Flag to print out internal operations. Defaults to False.

  • callback (function, optional) – An optional callback function to run at every iteration. Defaults to None.

Returns:

form (compas_cem.diagrams.FormDiagram) – A form diagram.