Janis Born committed Mar 20, 2018 1 ``````# OpenMesh Python Bindings `````` Isaak Lim committed Mar 21, 2018 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 committed Feb 01, 2018 4 `````` `````` Janis Born committed Apr 26, 2018 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 committed Feb 01, 2018 7 `````` `````` Isaak Lim committed Mar 21, 2018 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 committed May 28, 2019 50 ``````mesh_2 = om.read_trimesh('test.off') `````` Isaak Lim committed Mar 21, 2018 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). `````` Janis Born committed Mar 21, 2018 54 ``````## Installation `````` Isaak Lim committed Feb 16, 2018 55 `````` `````` Janis Born committed Mar 21, 2018 56 ``````### Using `pip` `````` Isaak Lim committed Feb 16, 2018 57 `````` `````` Janis Born committed Mar 21, 2018 58 `````` pip install openmesh `````` Isaak Lim committed May 28, 2019 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 `````` Janis Born committed Mar 21, 2018 64 `````` `````` Isaak Lim committed Feb 16, 2018 65 ``````### Building from source `````` Isaak Lim committed Feb 01, 2018 66 ``````1. recursively clone the repo `````` Janis Born committed Mar 21, 2018 67 ``````2. `cd` to repo dir `````` Janis Born committed Apr 03, 2018 68 69 ``````3. ensure the correct virtualenv is activated 4. `pip install -e .```````