geo3d.visualization.visualizer

Classes

PointCloudVisualizer

Generic point cloud visualizer for desktop and web backends.

Module Contents

class geo3d.visualization.visualizer.PointCloudVisualizer(backend: str = 'desktop', background: tuple[float, float, float] = (1, 1, 1), point_size: int = 3, port: int = 8888)

Generic point cloud visualizer for desktop and web backends.

Supports automatic coloring modes, uniform RGB coloring, and per-point colors for structured point cloud arrays.

session
_prepare_point_cloud(pcd_array: numpy.ndarray, colors: numpy.ndarray | tuple[float, float, float] | list[float] | None = None, color_mode: str = 'z', colormap: str = 'jet') → open3d.geometry.PointCloud

Prepare an Open3D point cloud from structured data.

Parameters:

  • pcd_array (np.ndarray) – Structured point cloud array.

  • colors (np.ndarray | tuple[float, float, float] | list[float] | None) – Optional colors array or RGB tuple. Defaults to None.

  • color_mode (str) – Mode used when generating default colors. Defaults to ‘z’.

  • colormap (str) – Colormap name for generated colors. Defaults to ‘jet’

Returns:

An Open3D PointCloud instance ready for visualization.

Return type:

o3d.geometry.PointCloud

show(pcd_array: numpy.ndarray, colors: None | numpy.ndarray | tuple[float, float, float] | list[float] = None, title: str = 'Point Cloud', color_mode: str = 'z', colormap: str = 'jet') → None

Show a point cloud in the selected visualization backend.

Parameters:

  • pcd_array – Structured point cloud data to display.

  • colors – Optional per-point colors or single RGB tuple.

  • title – Visualization title.

  • color_mode – Color generation mode when colors are not provided.

  • colormap – Colormap name for auto-generated colors.

update(pcd_array: numpy.ndarray, colors: None | numpy.ndarray | tuple[float, float, float] | list[float] = None, title: str = 'Point Cloud', color_mode: str = 'z', colormap: str = 'jet') → None

Update the displayed point cloud with new data.

Parameters:

  • pcd_array – Structured point cloud data to display.

  • colors – Optional per-point colors or single RGB tuple.

  • title – Visualization title.

  • color_mode – Color generation mode when colors are not provided.

  • colormap – Colormap name for auto-generated colors.

close() → None

Close the visualizer session and release any backend resources.