trimesh

# trimesh #
[![Build Status](https://travis-ci.org/mikedh/trimesh.svg?branch=master)](https://travis-ci.org/mikedh/trimesh)

Python (2.7-3.*) library for loading and utilizing triangular meshes.

### Features ###
* Import binary/ASCII STL, Wavefront, and OFF
* Import formats using assimp (if pyassimp installed)
* Import STEP files as meshes (if STEPtools Inc. Author Tools installed)
* Import 2D or 3D vector paths from 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
* 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:
```bash
$ sudo pip install git+https://github.com/mikedh/trimesh.git
```

### Optional Dependencies ###

#### Ray-mesh queries ####
If you would like to use ray queries or some path functionality, install dependencies:
```bash
$ sudo pip install shapely git+https://github.com/Toblerity/rtree.git svg.path
```

Rtree may not build without libspatialindex installed, get it with:
```bash
$ sudo apt-get install libspatialindex*
```

#### Loading meshes with Assimp ####
Trimesh supports loading meshes via Assimp, but this requires a fairly recent version.
To get the latest version of assimp/pyassimp from github:
```bash
$ sudo pip install git+https://github.com/robotics/assimp_latest.git
```

#### Creating meshes ####
If you would like to use the trimesh.creation functions, meshpy is required:
```bash
$ sudo pip install meshpy
```

#### Boolean operations ####
If you would like to use the trimesh.boolean (union, intersection, difference) functions which use openSCAD/CGAL:
```bash
$ sudo apt-get install openscad
```

### Quick Start ###

Here is an example of loading a cube from file and colorizing its faces.

```python
import numpy as np
import trimesh

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

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

# set each facet to a random color
for facet in facets:
mesh.visual.face_colors[facet] = trimesh.color.random_color()

# preview mesh in an opengl window if you installed pyglet
m.show()
```

In the mesh view window, dragging rotates the view, ctl + drag pans, mouse wheel scrolls, 'z' returns to the base view, 'w' toggles wireframe mode, and 'c' toggles backface culling.

Release files for trimesh 1.9.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for trimesh 1.9.7
File	Size	Uploaded
trimesh-1.9.7.tar.gz	93.1 kB	Dec 2, 2015	Details

Built distribution (wheel)

Table of built distributions (wheels) for trimesh 1.9.7
File	Interpreter	ABI	Platform	Reset
trimesh-1.9.7-py2-none-any.whl 113.2 kB Dec 2, 2015	Python 2	none	any	Details

Total release size: 206.2 kB

Release files / trimesh-1.9.7.tar.gz

Download URL	trimesh-1.9.7.tar.gz
Size	93.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`83cc94c75dcc7ec2216c8b0853bc872f1540d3666130cbd2e1b7f25e3c8aef00`
BLAKE2b-256 checksum How to use checksums	`8efd4bd5b68b93f9a0aecc8a445fc6143fffd1148d1ccd5a436ded2468dc7885`
Upload date	Dec 2, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / trimesh-1.9.7-py2-none-any.whl

Download URL	trimesh-1.9.7-py2-none-any.whl
Size	113.2 kB
Tags	Python 2
SHA-256 checksum How to use checksums	`8f19f856fc25c4f414a8ba390b6fdadbd48d9fdc53303e3bbf1c30cba5f449ed`
BLAKE2b-256 checksum How to use checksums	`f025d9ba8c26d5244002bf3b4135046438adb9f3560c89b5aab434528d1d2889`
Upload date	Dec 2, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No