numpy-stl 1.5.0

Library to make reading, writing and modifying both binary and ascii STL files easy.

stl-numpy

Simple library to make working with STL files (and 3D objects in general) fast and easy.

Due to all operations heavily relying on numpy this is one of the fastest STL editing libraries for Python available.

Links

• The source: https://github.com/WoLpH/numpy-stl

• Project page: https://pypi.python.org/pypi/numpy-stl

• Reporting bugs: https://github.com/WoLpH/numpy-stl/issues

• Documentation: http://numpy-stl.readthedocs.org/en/latest/

• My blog: http://w.wol.ph/

Requirements for installing:

• numpy any recent version

• python-utils version 1.6 or greater

Installation:

pip install numpy-stl

Initial usage:

• stl2bin your_ascii_stl_file.stl new_binary_stl_file.stl

• stl2ascii your_binary_stl_file.stl new_ascii_stl_file.stl

• stl your_ascii_stl_file.stl new_binary_stl_file.stl

Quickstart

import numpy
from stl import mesh

# Using an existing stl file:
your_mesh = mesh.Mesh.from_file('some_file.stl')

# Or creating a new mesh (make sure not to overwrite the `mesh` import by
# naming it `mesh`):
VERTICE_COUNT = 100
data = numpy.zeros(VERTICE_COUNT, dtype=mesh.Mesh.dtype)
your_mesh = mesh.Mesh(data, remove_empty_areas=False)

# The mesh normals (calculated automatically)
your_mesh.normals
# The mesh vectors
your_mesh.v0, your_mesh.v1, your_mesh.v2
# Accessing individual points (concatenation of v0, v1 and v2 in triplets)
assert (your_mesh.points[0][0:3] == your_mesh.v0[0]).all()
assert (your_mesh.points[0][3:6] == your_mesh.v1[0]).all()
assert (your_mesh.points[0][6:9] == your_mesh.v2[0]).all()
assert (your_mesh.points[1][0:3] == your_mesh.v0[1]).all()

your_mesh.save('new_stl_file.stl')

Plotting using matplotlib is equally easy:

from stl import mesh
from mpl_toolkits import mplot3d
from matplotlib import pyplot

# Create a new plot
figure = pyplot.figure()
axes = mplot3d.Axes3D(figure)

# Load the STL files and add the vectors to the plot
your_mesh = mesh.Mesh.from_file('tests/stl_binary/HalfDonut.stl')
axes.add_collection3d(mplot3d.art3d.Poly3DCollection(your_mesh.vectors))

# Auto scale to the mesh size
scale = your_mesh.points.flatten(-1)
axes.auto_scale_xyz(scale, scale, scale)

# Show the plot to the screen
pyplot.show()