Python
- class spectacularAI.VioOutput
Main output structure
- asJson(self: spectacularAI.VioOutput) str
a JSON representation of this object
- getCameraPose(self: spectacularAI.VioOutput, arg0: int) spectacularAI.CameraPose
CameraPose
corresponding to a camera whose index is given as the parameter. Index 0 corresponds to the primary camera and index 1 the secondary camera.
- property globalPose
GnssVioOutput
Global pose, only returned if GNSS information is provided viaSession
.addGnss(…)
- property positionCovariance
position uncertainty, 3x3 covariance matrix
- property status
current
TrackingStatus
- property tag
input tag from
addTrigger
. Set to 0 for other outputs.
- property velocityCovariance
velocity uncertainty, 3x3 covariance matrix
- class spectacularAI.Pose
Represents the pose (position & orientation) of a device at a given time. This typically corresponds the pose of the IMU (configurable). See
CameraPose
for exact poses of the cameras.- asMatrix(self: spectacularAI.Pose) numpy.ndarray
4x4 matrix that converts homogeneous local coordinates to homogeneous world coordinates
- fromMatrix(self: float, arg0: List[List[float[4]][4]]) spectacularAI.Pose
Create a pose from a timestamp and 4x4 local-to-world matrix
- property orientation
Quaternion
orientation of the IMU / camera, local-to-world
- property time
float
timestamp in seconds, synchronized with device monotonic time (not host)
- class spectacularAI.Camera(self: spectacularAI.Camera, arg0: List[List[float[3]][3]], arg1: int, arg2: int)
Represents the intrinsic parameters of a particular camera. If the input image is distorted, the camera and projection matrices correspond to the undistorted / rectified image.
Build a pinhole camera
- getIntrinsicMatrix(self: spectacularAI.Camera) numpy.ndarray
3x3 intrinsic camera matrix (OpenCV convention, undistorted).
- getProjectionMatrixOpenGL(self: spectacularAI.Camera, arg0: float, arg1: float) numpy.ndarray
4x4 projection matrix for OpenGL (undistorted)
- pixelToRay(self: spectacularAI.Camera, arg0: spectacularAI.PixelCoordinates) object
Convert pixel coordinates to camera coordinates
- Parameters:
arg0
PixelCoordinates
: pixel coordinates.- Returns:
Vector3d
ray in camera coordinates on succesful conversion. None otherwise.
- rayToPixel(self: spectacularAI.Camera, arg0: spectacularAI.Vector3d) object
Convert camera coordinates to pixel coordinates
- Parameters:
arg0
Vector3d
: ray in camera coordinates.- Returns:
PixelCoordinates
pixel coordinates on succesful conversion (note that the pixel can be outside image boundaries). None otherwise.
- class spectacularAI.CameraPose
Represents the pose (position & orientation) and other parameters of a particular camera.
- getCameraToWorldMatrix(self: spectacularAI.CameraPose) numpy.ndarray
4x4 homogeneous camera-to-world matrix
- getPosition(self: spectacularAI.CameraPose) spectacularAI.Vector3d
Vector3d
position of the camera
- getWorldToCameraMatrix(self: spectacularAI.CameraPose) numpy.ndarray
4x4 homogeneous world-to-camera matrix
- pixelToWorld(self: spectacularAI.CameraPose, arg0: spectacularAI.PixelCoordinates) object
Convert pixel coordinates to rays in world coordinates
- Parameters:
arg0
PixelCoordinates
: pixel coordinates to convert.- Returns:
A tuple with
Vector3d
origin of the ray in world coordinates,Vector3d
direction of ray from the origin on succesful conversion. None otherwise.
- worldToPixel(self: spectacularAI.CameraPose, arg0: spectacularAI.Vector3d) object
Convert world coordinates to pixel coordinates
- Parameters:
arg0
Vector3d
: point in world coordinates coordinates.- Returns:
PixelCoordinates
pixel coordinates on succesful conversion (note that the pixel can be outside image boundaries). None otherwise.
- class spectacularAI.Vector3d(*args, **kwargs)
Vector in R^3. Can represent, e.g., velocity, position or angular velocity. Each property is a
float
.Overloaded function.
__init__(self: spectacularAI.Vector3d) -> None
__init__(self: spectacularAI.Vector3d, arg0: float, arg1: float, arg2: float) -> None
- property x
- property y
- property z
- class spectacularAI.Vector3f(*args, **kwargs)
Vector in R^3. Single precision.
Overloaded function.
__init__(self: spectacularAI.Vector3f) -> None
__init__(self: spectacularAI.Vector3f, arg0: float, arg1: float, arg2: float) -> None
- property x
- property y
- property z
- class spectacularAI.Quaternion
Quaternion representation of a rotation. Hamilton convention. Each property is a
float
.- property w
- property x
- property y
- property z
- class spectacularAI.TrackingStatus(self: spectacularAI.TrackingStatus, value: int)
Members:
INIT
TRACKING
LOST_TRACKING
- INIT = <TrackingStatus.INIT: 0>
- LOST_TRACKING = <TrackingStatus.LOST_TRACKING: 2>
- TRACKING = <TrackingStatus.TRACKING: 1>
- property name
- property value
- class spectacularAI.ColorFormat(self: spectacularAI.ColorFormat, value: int)
Members:
NONE
GRAY
RGB
RGBA
GRAY16
- GRAY = <ColorFormat.GRAY: 1>
- GRAY16 = <ColorFormat.GRAY16: 7>
- NONE = <ColorFormat.NONE: 0>
- RGB = <ColorFormat.RGB: 2>
- RGBA = <ColorFormat.RGBA: 3>
- property name
- property value
- class spectacularAI.Bitmap
Represents a grayscale or RGB bitmap
- getColorFormat(self: spectacularAI.Bitmap) spectacularAI.ColorFormat
- getHeight(self: spectacularAI.Bitmap) int
int
bitmap height
- getWidth(self: spectacularAI.Bitmap) int
int
bitmap width
- toArray(self: spectacularAI.Bitmap) numpy.ndarray
Returns array representation of the bitmap
- class spectacularAI.Frame
A camera frame with a pose
- property cameraPose
CameraPose
corresponding this camera
- property index
Camera index
- class spectacularAI.Replay(*args, **kwargs)
Replay previously recorded data
Overloaded function.
__init__(self: spectacularAI.Replay, folder: str, *, mapperCallback: Callable[[spectacularAI::mapping::MapperOutput], None] = None, configuration: dict = {}, ignoreFolderConfiguration: bool = False, startTime: object = None, stopTime: object = None) -> None
Build a replay from a given folder containing the dataset
__init__(self: spectacularAI.Replay, folder: str, mapperCallback: Callable[[spectacularAI::mapping::MapperOutput], None], *, configuration: dict = {}, ignoreFolderConfiguration: bool = False, startTime: object = None, stopTime: object = None) -> None
Build a replay from a given folder containing the dataset with a mapping callback
- close(self: spectacularAI.Replay) None
Closes replay.
- runReplay(self: spectacularAI.Replay) None
Starts replaying the data and blocks until close() is called or the entire session has played out
- setExtendedOutputCallback(self: spectacularAI.Replay, arg0: Callable[[spectacularAI.VioOutput, List[spectacularAI.Frame]], None]) None
Set a callback that’s called for new output
- setOutputCallback(self: spectacularAI.Replay, arg0: Callable[[spectacularAI.VioOutput], None]) None
Set a callback that’s called for new output
- setPlaybackSpeed(self: spectacularAI.Replay, arg0: float) None
Sets playbacks speed, 1.0 == real time, 2.0 == fast forward 2x, 0.5 == at half speed, -1.0 == unlimited. Defaults to 1.0.
- startReplay(self: spectacularAI.Replay) None
Starts replaying the data in the background until close() is called or entire session has been played.
- class spectacularAI.WgsCoordinates(self: spectacularAI.WgsCoordinates)
Represents the pose (position & orientation) of a device at a given time.
- property altitude
- property latitude
- property longitude
- class spectacularAI.GnssVioOutput
GNSS-VIO output
- property coordinates
current
WgsCoordinates
- property enuPositionCovariance
enu position uncertainty, 3x3 covariance matrix
- getEnuCameraPose(self: spectacularAI.GnssVioOutput, arg0: int, arg1: spectacularAI.WgsCoordinates) spectacularAI::CameraPose
Get the global pose of a particular camera. The “world” coordinate system of the camera pose is an East-North-Up system, whose origin is at the given WGS84 coordinates.
- property orientation
current
Quaternion
- property velocityCovariance
velocity uncertainty, 3x3 covariance matrix
- class spectacularAI.PixelCoordinates(*args, **kwargs)
Coordinates of an image pixel (x, y), subpixel accuracy (
float
).Overloaded function.
__init__(self: spectacularAI.PixelCoordinates) -> None
__init__(self: spectacularAI.PixelCoordinates, arg0: float, arg1: float) -> None
- property x
- property y
- class spectacularAI.FeaturePoint(self: spectacularAI.FeaturePoint)
Sparse 3D feature point observed from a certain camera frame.
- property id
An
int
ID to identify same points in different frames.
- property pixelCoordinates
PixelCoordinates
of the observation in the camera frame.