Datatypes
SUMMARY
Telekinesis Skills often require data to conform to specific structures so inputs and outputs can be validated, serialized, and exchanged consistently across the packages in the Telekinesis ecosystem.
Using telekinesis.datatypes gives you a common set of types for primitives, geometry, robotics, vision, point clouds, and model data without worrying about the underlying representation.
Primitives
Scalar values, timestamps, and generic arrays
Bool
Boolean scalar.
View →Int
Integer scalar.
View →Float
Floating-point scalar.
View →String
String scalar.
View →Timestamp
Clock-epoch sec/nanosec pair, no timezone semantics.
View →DateTime
Timezone-aware wall-clock datetime, normalized to UTC.
View →Array
Arbitrary-shape, arbitrary-dtype NumPy array.
View →Geometry
Vectors, matrices, boxes, points, and shapes in 2D and 3D.
Vector2D
2D vector.
View →Vector3D
3D vector.
View →Vector4D
4D vector.
View →Vectors2D
Batch of 2D vectors.
View →Vectors3D
Batch of 3D vectors.
View →Vectors4D
Batch of 4D vectors.
View →Mat2x2
2×2 matrix.
View →Mat3x3
3×3 matrix.
View →Mat4x4
4×4 matrix.
View →Box2D
Single axis-aligned 2D box.
View →Box3D
Single axis-aligned 3D box.
View →OrientedBox2D
Single rotated 2D box.
View →OrientedBox3D
Single rotated 3D box.
View →Boxes2D
Batch of axis-aligned 2D boxes.
View →Boxes3D
Batch of axis-aligned 3D boxes.
View →OrientedBoxes2D
Batch of rotated 2D boxes.
View →OrientedBoxes3D
Batch of rotated 3D boxes.
View →Point2D
Single 2D point.
View →Point3D
Single 3D point.
View →Points2D
Batch of N 2D points.
View →Points3D
Batch of N 3D points.
View →Circle
Single 2D circle.
View →Circles
Batch of 2D circles.
View →Contour
Single 2D contour (polyline).
View →Contours
Batch of 2D contours.
View →Eigenvalues
Eigenvalues of a covariance/matrix.
View →Eigenvectors
Eigenvectors of a covariance/matrix.
View →Robotics
Positions, transforms, poses, and other robotics-oriented types.
Position2D
2D position (x, y).
View →Position3D
3D position (x, y, z).
View →Transform2D
2D homogeneous transform.
View →Transform3D
3D homogeneous transform.
View →Transforms3D
Batch of 3D homogeneous transforms.
View →Quaternion
Unit quaternion rotation.
View →Pose2D
Single 2D pose.
View →Pose3D
Single 3D pose.
View →Poses2D
Batch of 2D poses.
View →Poses3D
Batch of 3D poses.
View →Twist3D
3D linear + angular velocity.
View →Wrench3D
3D force + torque.
View →Covariance6x6
6×6 pose covariance.
View →OccupancyGrid
2D occupancy grid map.
View →Vision
Images, point clouds, meshes, and detection/annotation types.
Image
Image with optional on-wire compression.
View →ImageBatch
Batch of images.
View →StereoImages
Synchronized stereo images with optional color imagery and frame metadata.
View →SegmentationImage
Per-pixel segmentation mask.
View →DepthImage
Per-pixel depth map.
View →CameraCalibration
Camera intrinsics, resolution, and distortion model.
View →StereoCalibration
Stereo camera intrinsics, optical-frame transforms, and baseline.
View →PointCloud
Single 3D point cloud (points + optional colors/normals).
View →PointCloudBatch
Batch of point clouds.
View →Mesh3D
3D triangle mesh.
View →Mesh3DBatch
Batch of independently-sized 3D triangle meshes.
View →Color
RGBA color.
View →COCOObjectDetectionResult
Single COCO-style detection with a confidence score.
View →COCOObjectDetectionResults
Batch of COCO-style detections.
View →COCOObjectDetectionAnnotation
Single COCO-style ground-truth annotation.
View →COCOObjectDetectionAnnotations
Batch of COCO-style ground-truth annotations.
View →Category
Single category definition.
View →Categories
Batch of category definitions.
View →Models
Metadata describing ML model input/output tensor signatures.
ModelTensorDefinition
One model input/output tensor signature.
View →ModelDefinitions
Batch of ML model metadata records.
View →Enums
Enumerated value types referenced by other datatypes above.
RotationType
Enum — rotation representation for pose ↔ transform conversions.
View →ImageCompression
Enum — on-wire compression codec for Image/ImageBatch.
View →PointCloudCompression
Enum — on-wire compression codec for PointCloud/PointCloudBatch.
View →DistortionModel
Enum — camera distortion model for CameraCalibration.
View →COCO Types
Shared segmentation and method-return types referenced by the COCO datatypes above.
COCORLESegmentation
Canonical compressed COCO RLE segmentation dict.
View →COCOUncompressedRLESegmentation
Uncompressed COCO RLE segmentation dict.
View →COCORLESegmentationLike
Accepted input form for an RLE segmentation.
View →COCOPolygonSegmentation
Canonical flattened polygon list.
View →COCOPolygonSegmentationLike
Accepted input form for a polygon segmentation.
View →COCOObjectDetectionResultAsMask
Return type of COCOObjectDetectionResult.as_mask().
View →COCOObjectDetectionResultAsPolygon
Return type of COCOObjectDetectionResult.as_polygon().
View →COCOObjectDetectionResultsAsMasks
Return type of COCOObjectDetectionResults.as_masks().
View →COCOObjectDetectionResultsAsPolygons
Return type of COCOObjectDetectionResults.as_polygons().
View →COCOObjectDetectionAnnotationAsMask
Return type of COCOObjectDetectionAnnotation.as_mask().
View →COCOObjectDetectionAnnotationsAsMasks
Return type of COCOObjectDetectionAnnotations.as_masks().
View →