Visualization Module

The spine.vis module provides interactive visualization tools for detector inputs, reconstructed objects, truth labels, geometry, and training or evaluation products. It is primarily Plotly-based and is designed for inspecting sparse 3D reconstruction outputs rather than serving as the center of the package.

Visualization helpers, trace builders, and domain-aware drawers.

The top-level spine.vis namespace re-exports the public visualization API while the implementation is organized internally into:

  • spine.vis.trace for low-level Plotly trace builders

  • spine.vis.drawer for higher-level object and detector drawers

  • spine.vis.layout for shared Plotly and Matplotlib styling

  • spine.vis.metric for metric-specific plotting helpers

Module Index

Use this package to inspect detector point clouds, overlay reconstructed or truth objects, and visualize model or evaluation outputs in notebooks and analysis workflows.

layout

Shared Plotly layout, color, and styling helpers for visualization code.

out

Visualization entrypoint for reconstructed and truth output objects.

point

Tools to draw 2D or 3D point clouds.

arrow

Module to draw 3D arrows.

box

Defines functions used to draw finite-sized boxes.

cone

Module to convert a point cloud into a cone envelope.

cylinder

Module to draw cylinders.

ellipsoid

Module to convert a point cloud into an ellipsoidal envelope.

hull

Module to convert a point cloud into an convex hull envelope.

cluster

Tools to draw voxelized data organized in clusts.

particle

Draw truth-particle labels on top of labeled point clouds.

network

Draw graph connectivity on top of clustered point clouds.

lite

Draw lite data structures with compact geometric surrogates.

train

Training-history visualization helpers.

geo

Detector-geometry drawers and helpers.

metric

Metric-specific visualization helpers.