Position2D

Represents a 2D position (x, y). Used for centroids, keypoints, and 2D coordinates. Supports to_list(). This datatype is used across the Telekinesis ecosystem for 2D position data (e.g. centroid from calculate_image_centroid).

Field

Required

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

Optional

None.

Methods

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

Example

From the datatypes examples:

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

# ------------------------------------------------
# 1. Create Position2D instance
# ------------------------------------------------
xy = np.array([10.0, 20.0], dtype=np.float32)
pos_2d = datatypes.Position2D(xy)

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