Skip to main content

Visualize meshes, point clouds, and other geometry in a Jupyter Notebook

Project description

threevis # threevis pipeline status

a Python library for visualizing meshes, point clouds, and other geometry in Jupyter notebooks

Installation

pip install threevis

Examples

Quick Mesh Inspection

import threevis
import openmesh as om

m = om.read_trimesh('examples/models/bunny.obj')

threevis.display_openmesh(m)

Custom Rendering

import threevis
import openmesh as om
import numpy as np

# Load Mesh
m = om.read_trimesh('mouse.obj')

# Create Context
ctx = threevis.Context(width=640, height=480)

# Get vertices and faces from the mesh
vertices = m.points()
faces = m.face_vertex_indices()

# We don't have normals, calculate them
normals = threevis.calculateFaceNormals(m.points(), m.face_vertex_indices())

# Choose a random color for each face
colors = threevis.FaceAttribute(np.random.rand(len(faces), 3))

# Draw the mesh with flat shading
ctx.draw_faces(vertices, faces,
               normals = normals,
               colors = colors,
               shading = 'flat')

# Draw edges on top with random colors
ctx.draw_edges(vertices, m.ev_indices(),
               colors = threevis.FaceAttribute(np.random.rand(len(m.ev_indices()), 3)),
               linewidth=3)

# Calculate data to display normals as edges
normal_vis_verts, normal_vis_edges = threevis.calculateNormalEdges(vertices, faces, normals, length=0.05)

# Draw the normals in
ctx.draw_edges(normal_vis_verts, normal_vis_edges, colors = colors)

# Draw a point for each vertex
ctx.draw_vertices(vertices, point_size=4, colors='red')

# Finally display it
ctx.display()
mouse

mouse

Development Setup

  • Install dependencies

  • Clone the repository

  • pip install -e .

Dependencies

Optional

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

threevis-0.1.0.post11-py2.py3-none-any.whl (11.3 kB view details)

Uploaded Python 2Python 3

File details

Details for the file threevis-0.1.0.post11-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for threevis-0.1.0.post11-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8837ed799ecc46ca2e6aa864fde36ddb8fc33257baf2b68b3cf187e92f1af065
MD5 af7f3cf1a82829267e8c69c97e48f435
BLAKE2b-256 03050e87c664bdd69d385111e236ab21a859ab569443b831e921229f7cbdbd6b

See more details on using hashes here.

Supported by

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