Skip to content

Latest commit

 

History

History
32 lines (22 loc) · 1.25 KB

README.md

File metadata and controls

32 lines (22 loc) · 1.25 KB
Raw



Determine mesh rotations to minimise overhangs for 3D printing.

Installation

Install from the GitHub repository:

git clone [email protected]:dpohanlon/mesh-tumbler.git
cd mesh-tumbler
pip install .

Usage

Mesh Tumbler uses projections of the normals in the -z direction to determine the amount of unsupported overhangs above a user defined thereshold (by default 45 degrees). The mesh is rotated according to a Bayesian Gaussian process optimisation procedure in order to find the rotations that minimise the number of these overhangs. The only argument required to the executable is the path to an STL file:

mesh-tumbler --input_file path/to/mesh.stl

and the rotations about the [x, y, z] axes, along with the value of the optimised function, are printed. This also takes optional arguments of the number of function calls to make to the optimisation function, n_calls, and the pitch of the voxelised mesh, pitch, which are useful to optimise the time taken to achieve reasonable results. The maximum angle above which a the projection is considered an overhang can also be specified with max_overhang_angle.