README.md 1.93 KB
Newer Older
Janis Born's avatar
Janis Born committed
1
# OpenMesh Python Bindings
Isaak Lim's avatar
Isaak Lim committed
2 3

[![](https://www.graphics.rwth-aachen.de:9000/OpenMesh/openmesh-python/badges/master/pipeline.svg)](https://www.graphics.rwth-aachen.de:9000/OpenMesh/openmesh-python/commits/master)
Isaak Lim's avatar
Isaak Lim committed
4

Janis Born's avatar
Janis Born committed
5 6
OpenMesh is a versatile halfedge-based data structure for representing and manipulating polygon meshes.
The OpenMesh Python bindings are are tightly integrated with [numpy](http://www.numpy.org/) and are implemented using [pybind11](https://github.com/pybind/pybind11). 
Isaak Lim's avatar
Isaak Lim committed
7

Isaak Lim's avatar
Isaak Lim committed
8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
## Example
```python
import openmesh as om
import numpy as np

mesh = om.TriMesh()

# add a a couple of vertices to the mesh
vh0 = mesh.add_vertex([0, 1, 0])
vh1 = mesh.add_vertex([1, 0, 0])
vh2 = mesh.add_vertex([2, 1, 0])
vh3 = mesh.add_vertex([0,-1, 0])
vh4 = mesh.add_vertex([2,-1, 0])

# add a couple of faces to the mesh
fh0 = mesh.add_face(vh0, vh1, vh2)
fh1 = mesh.add_face(vh1, vh3, vh4)
fh2 = mesh.add_face(vh0, vh3, vh1)

# add another face to the mesh, this time using a list
vh_list = [vh2, vh1, vh4]
fh3 = mesh.add_face(vh_list)

#  0 ==== 2
#  |\  0 /|
#  | \  / |
#  |2  1 3|
#  | /  \ |
#  |/  1 \|
#  3 ==== 4

# get the point with vertex handle vh0
point = mesh.point(vh0)

# get all points of the mesh
point_array = mesh.points()

# translate the mesh along the x-axis
point_array += np.array([1, 0, 0])

# write and read meshes
om.write_mesh('test.off', mesh)
Isaak Lim's avatar
Isaak Lim committed
50
mesh_2 = om.read_trimesh('test.off')
Isaak Lim's avatar
Isaak Lim committed
51 52 53
```
For further examples see the documentation or refer to the [unit tests](https://www.graphics.rwth-aachen.de:9000/OpenMesh/openmesh-python/tree/master/tests).

54
## Installation
Isaak Lim's avatar
Isaak Lim committed
55

56
### Using `pip`
Isaak Lim's avatar
Isaak Lim committed
57

58
    pip install openmesh
59 60 61 62 63
    
### Using `conda`
Thanks to Martin Drawitsch you can also install openmesh-python via [conda](https://github.com/conda-forge/openmesh-python-feedstock):

    conda install -c conda-forge openmesh-python
64

Isaak Lim's avatar
Isaak Lim committed
65
### Building from source
Isaak Lim's avatar
Isaak Lim committed
66
1. recursively clone the repo
67
2. `cd` to repo dir
68 69
3. ensure the correct virtualenv is activated
4. `pip install -e .`