Ellipsoids3D

3D ellipsoids or spheres.

This archetype is for ellipsoids or spheres whose size is a key part of the data (e.g. a bounding sphere). For points whose radii are for the sake of visualization, use archetypes.Points3D instead.

Note that orienting and placing the ellipsoids/spheres is handled via [archetypes.InstancePoses3D]. Some of its component are repeated here for convenience. If there's more instance poses than half sizes, the last half size will be repeated for the remaining poses.

Components components

Required: HalfSize3D

Recommended: PoseTranslation3D, Color

Optional: PoseRotationAxisAngle, PoseRotationQuat, Radius, FillMode, Text, ShowLabels, ClassId

Shown in shown-in

• Spatial3DView
• Spatial2DView (if logged above active projection)
• DataframeView

API reference links api-reference-links

• 🌊 C++ API docs for Ellipsoids3D
• 🐍 Python API docs for Ellipsoids3D
• 🦀 Rust API docs for Ellipsoids3D

Example example

Covariance ellipsoid covariance-ellipsoid

"""Log random points and the corresponding covariance ellipsoid."""

import numpy as np
import rerun as rr

rr.init("rerun_example_ellipsoid_simple", spawn=True)

center = np.array([0, 0, 0])
sigmas = np.array([5, 3, 1])
points = np.random.randn(50_000, 3) * sigmas.reshape(1, -1)

rr.log("points", rr.Points3D(points, radii=0.02, colors=[188, 77, 185]))
rr.log(
    "ellipsoid",
    rr.Ellipsoids3D(
        centers=[center, center],
        half_sizes=[sigmas, 3 * sigmas],
        colors=[[255, 255, 0], [64, 64, 0]],
    ),
)

View