Skip to content

Circles

Represents 2D circles defined by center coordinates and radii. This datatype is used for circle-detection outputs and geometry annotations within the Telekinesis ecosystem.

Field

Required

FieldTypeDescription
centersArrayLikeCenter (x, y) per circle; shape (2,) or (N, 2), dtype float32.
radiifloat or ArrayLikeRadius per circle; scalar (same for all) or shape (N,), dtype float32.

Optional

None.

Methods

MethodDescription
to_dict()Returns a dictionary with keys: centers (array shape (N, 2)), radii (scalar or array shape (N,)).

Example

From the datatypes examples:

python
from datatypes import datatypes
from loguru import logger

# ------------------------------------------------
# 1. Create Circles instance
# ------------------------------------------------
circles = datatypes.Circles(
    centers=[[0.1, 0.1], [0.2, 0.2]],
    radii=[0.1, 0.2],
)

# ------------------------------------------------
# 2. Access data via to_dict
# ------------------------------------------------
data = circles.to_dict()
logger.info("Circles to_dict centers={}", data["centers"])
logger.info("Circles to_dict radii={}", data["radii"])