Skip to main content

Import, export, process, analyze and view triangular meshes.

Project description

Build Status

Python (2.7-3.*) library for loading and using triangular meshes. The goal of the library is to provide a fully featured Trimesh object which allows for easy manipulation and analysis, in the style of the excellent Polygon object in the Shapely library.

The API is mostly stable, but this should not be relied on and is not guaranteed; install a specific version if you plan on deploying something using trimesh as a backend.

Features

  • Import binary/ASCII STL, Wavefront, OFF, and PLY

  • Import formats using assimp (if pyassimp installed)

  • Import STEP files as meshes (if STEPtools Inc. Author Tools installed)

  • Import and export 2D or 3D vector paths from/to DXF or SVG files

  • Export meshes as binary STL, COLLADA, or OFF

  • Preview meshes (requires pyglet)

  • Internal caching of computed values which are automatically cleared when vertices or faces are changed

  • Fast loading of binary and ASCII STL files (on 234,230 face mesh, was 24.5x faster than assimp)

  • Calculate face adjacencies quickly (for the same 234,230 face mesh .248 s)

  • Calculate cross sections (.146 s)

  • Split mesh based on face connectivity using networkx (4.96 s) or graph-tool (.584 s)

  • Calculate mass properties, including volume, center of mass, and moment of inertia (.246 s)

  • Find coplanar groups of faces (.454 s)

  • Fix triangle winding to be consistent (slow)

  • Fix normals to be oriented ‘outwards’ using ray tests

  • Calculate whether or not a point lies inside a watertight mesh using ray tests

  • Find convex hulls of meshes (.21 s)

  • Compute a rotation/translation/tessellation invariant identifier for meshes (from an FFT of the radius distribution)

  • Merge duplicate meshes from identifier

  • Determine if a mesh is watertight (manifold)

  • Repair single triangle and single quad holes

  • Uniformly sample the surface of a mesh

  • Find ray-mesh intersections

  • Boolean operations on meshes (intersection, union, difference) if OpenSCAD is installed

  • Voxelize watertight meshes

  • Unit conversions

  • Create meshes by extruding 2D profiles

  • Numerous utility functions, such as transforming points, unitizing vectors, grouping rows, etc.

Installation

The easiest way to install is:

$ sudo pip install trimesh

This command will install trimesh, with its required dependencies, namely numpy, scipy and networkx.

Optional Dependencies

Basic functionality is available immediately. Some functions (ray queries, polygon handling, mesh creation, viewer windows, boolean operations, additional importers) require additional libraries:

$ sudo apt-get install cmake openscad blender libspatialindex-dev libgeos-dev
$ sudo pip install pyglet shapely git+https://github.com/robotics/assimp_latest.git rtree svg.path meshpy

If you are using a lot of graph operations (specifically mesh.split) trimesh will automatically use graph-tool if it is installed, for a roughly 10x speedup over networkx on certain operations.

Quick Start

Here is an example of loading a mesh from file and colorizing its faces. Here is a nicely formatted ipython notebook version of this example.

import numpy as np
import trimesh

# load a file by name or from a buffer
mesh = trimesh.load_mesh('../models/featuretype.STL')

# is the current mesh watertight?
mesh.is_watertight

# what's the euler number for the mesh?
mesh.euler_number

# the convex hull is another Trimesh object that is available as a property
# lets compare the volume of our mesh with the volume of its convex hull
np.divide(mesh.volume, mesh.convex_hull.volume)

# since the mesh is watertight, it means there is a
# volumetric center of mass which we can set as the origin for our mesh
mesh.vertices -= mesh.center_mass

# what's the moment of inertia for the mesh?
mesh.moment_inertia

# if there are multiple bodies in the mesh we can split the mesh by
# connected components of face adjacency
# since this example mesh is a single watertight body we get a list of one mesh
mesh.split()

# find groups of coplanar adjacent faces
facets, facets_area = mesh.facets(return_area=True)

# set each facet to a random color
# colors are 8 bit RGBA by default (n,4) np.uint8
for facet in facets:
    mesh.visual.face_colors[facet] = trimesh.visual.random_color()

# preview mesh in an opengl window if you installed pyglet with pip
mesh.show()

# transform method can be passed a (4,4) matrix and will cleanly apply the transform
mesh.apply_transform(trimesh.transformations.random_rotation_matrix())

# axis aligned bounding box is available
mesh.bounding_box.extents

# a minimum volume oriented bounding box also available
mesh.bounding_box_oriented.box_extents
mesh.bounding_box_oriented.box_transform

# show the mesh overlayed with its oriented bounding box
# the bounding box is a trimesh.primitives.Box object, which subclasses
# Trimesh and lazily evaluates to fill in vertices and faces when requested
# (press w in viewer to see triangles)
(mesh + mesh.bounding_box_oriented + mesh.bounding_box).show()

Optional Viewer

Trimesh includes an optional pyglet- based viewer for debugging/inspecting. In the mesh view window:

  • dragging rotates the view

  • ctl + drag pans

  • mouse wheel zooms

  • ‘z’ returns to the base view

  • ‘w’ toggles wireframe mode

  • ‘c’ toggles backface culling

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trimesh-1.14.19.tar.gz (127.3 kB view details)

Uploaded Source

File details

Details for the file trimesh-1.14.19.tar.gz.

File metadata

  • Download URL: trimesh-1.14.19.tar.gz
  • Upload date:
  • Size: 127.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for trimesh-1.14.19.tar.gz
Algorithm Hash digest
SHA256 dd66d77cd4fa1308fa0918573e1af71934b1e6b4c86a66dfbb7e17143c07c91c
MD5 e7b054121136369c639258fff2dd7661
BLAKE2b-256 229eea9452049cd77d684071a7e35b41b594e788c7f9df2bdf945bad564c61ac

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page