PY3D - 3D data analysis toolkit¶

Code | Docs

What is it?¶

py3d is a pure and lightweight Python library dedicated to 3D data structures and functions. It enables batch processing of 3D points, lines, planes, and 3D meshes. Moreover, it provides interactive visualization capabilities for these elements. It is advisable to use it in Jupyter for visualization purposes.

Main features¶

  • Supports the reading, writing, and visualization of multiple 3D data formats such as the popular PLY, NPY, CSV, PCD, and OBJ. Demos
  • Perform rotation, translation, and scaling operations on 3D geometries. Demos
  • Conversion among diverse rotation representations, Demos
    • Rotation matrix
    • Angle - axis
    • Quaternion
    • Euler angle
    • Rotation vector

How to install it?¶

pip install py3d

How to use it?¶

Here are some small examples:

  1. Visualize a pcd file in jupyter
In [1]:
import py3d
pcd = py3d.read_pcd("binary.pcd")
print("min", pcd.min())
print("max", pcd.max())
pcd.xyz.as_point(colormap=pcd.w)

min -109.0828628540039
max 1223933577.0853775
Out[1]:
  1. Visualize an image in jupyter
In [2]:
import py3d
py3d.read_img("./20220917214012.jpg").as_image()
Out[2]:
  1. Convert euler angles to rotation matrix
In [3]:
import py3d
py3d.Transform.from_euler("xyz", [0.4, -0.2, 0])
Out[3]:
Transform([[ 0.98006658,  0.        ,  0.19866933,  0.        ],
           [-0.07736548,  0.92106099,  0.3816559 ,  0.        ],
           [-0.18298657, -0.38941834,  0.9027011 ,  0.        ],
           [ 0.        ,  0.        ,  0.        ,  1.        ]])

API reference¶

Vector Vector3 Vector4 Transform Rotation Color IO

Top