mesh_planarize_faces

compas.datastructures.mesh_planarize_faces(mesh, fixed=None, kmax=100, callback=None, callback_args=None)[source]

Planarise a set of connected faces.

Planarisation is implemented as a two-step iterative procedure. At every iteration, faces are first individually projected to their best-fit plane, and then the vertices are projected to the centroid of the disconnected corners of the faces.

Parameters:
meshcompas.datastructures.Mesh

A mesh object.

fixedlist[int], optional

A list of fixed vertices.

kmaxint, optional

The number of iterations.

dfloat, optional

A damping factor.

callbackcallable, optional

A user-defined callback that is called after every iteration.

callback_argslist[Any], optional

A list of arguments to be passed to the callback function.

Returns:
None