Position3D

Represents a 3D position (x, y, z). Used for 3D points, centroids, and spatial coordinates. Supports to_list(). This datatype is used across the Telekinesis ecosystem for 3D position data.

Field

Required

Field	Type	Description
xyz	ArrayLike	3D position; shape (3,), dtype float32. Elements are [x, y, z].

Optional

None.

Methods

Method	Description
to_list()	Returns a Python list of 3 floats: [x, y, z].

Example

From the datatypes examples:

import numpy as np
from datatypes import datatypes
from loguru import logger

# ------------------------------------------------
# 1. Create Position3D instance
# ------------------------------------------------
xyz = np.array([1.0, 2.0, 3.0], dtype=np.float32)
pos_3d = datatypes.Position3D(xyz)

# ------------------------------------------------
# 2. Access data via to_list and to_numpy
# ------------------------------------------------
data_list = pos_3d.to_list()
logger.info("Position3D to_list x={}", data_list[0])
logger.info("Position3D to_list y={}", data_list[1])
logger.info("Position3D to_list z={}", data_list[2])
logger.info("Position3D to_numpy shape={}", pos_3d.to_numpy().shape)