Notation & glossary
Use this page to look up a symbol, a frame or a sign convention. Every equation on this site uses the symbols below.
The frame and transform conventions follow OpenVINS.
Result files use their own XtoY names (below).
Frames
Section titled “Frames”A frame is a coordinate system attached to the world, a sensor or the board. We write it in braces, e.g. .
| Symbol | Frame | Notes |
|---|---|---|
| global | gravity-aligned; yaw and position are unobservable | |
| base IMU | the reference clock and the trajectory’s body frame | |
| , | gyroscope triad, accelerometer triad | inside one IMU; which one coincides with depends on the IMU convention |
| auxiliary IMU | rigidly attached to | |
| camera | optical frame: right, down, forward | |
| calibration board | fixed in |
Transforms
Section titled “Transforms”A rotation is written . It takes a vector expressed in into . A translation is the origin of expressed in . Together they form the transform :
Rotations as vectors
Section titled “Rotations as vectors”We report a rotation as its rotation vector , in rad. Its direction is the rotation axis and its norm is the angle. We never report roll, pitch and yaw angles.
| Symbol | Meaning |
|---|---|
| the skew-symmetric matrix of , so | |
| rotation vector to rotation matrix: , with | |
the inverse of ; the rotvec fields of a result |
Calibration state
Section titled “Calibration state”The calibration state is the set of quantities we estimate. Intrinsics describe a sensor itself; extrinsics give its pose in the base-IMU frame . The Per column says whether a quantity exists once per camera, per rolling-shutter (RS) camera, per IMU or per auxiliary IMU.
| Symbol | Quantity | Dimension | Per |
|---|---|---|---|
camera intrinsics (focal lengths, principal point; fx fy cx cy in files) | 4 | camera | |
| distortion coefficients | 1 to 5, by camera model | camera | |
| camera extrinsics | 6 | camera | |
| camera–IMU time offset | 1 | camera | |
| rolling-shutter readout | 1 | RS camera | |
| gyroscope correction: scale and misalignment | 6, or 9 in calyx | IMU | |
| accelerometer correction: scale and misalignment | 6 | IMU | |
| or | rotation between the gyro and accel triads | 3 (kalibr, rpng) | IMU |
| g-sensitivity: how specific force leaks into the gyro | 9 | IMU | |
| gyro–accel time offset inside one IMU | 1 | IMU | |
| auxiliary IMU extrinsics | 6 | aux IMU | |
| IMU–IMU time offset | 1 | aux IMU | |
| gyro / accel biases | 3 each | IMU | |
| height of board corner along the board normal | 1 | board corner, with board_points on |
, and are correction matrices: they map a raw reading to the true value. IMU model gives the equations.
The full state stacks the trajectory with all of the above. The cost that acts on it is in Calibration graph.
Measurements
Section titled “Measurements”What the sensors report, and the terms we build from those readings:
| Symbol | Measurement |
|---|---|
| measured angular velocity (raw gyro reading) | |
| measured specific force (raw accel reading) | |
| true angular velocity of , expressed in | |
| true specific force in : | |
| gravity in , m/s² | |
gyro / accel white noise (densities sigma_g, sigma_a) | |
bias random-walk noise (densities sigma_bg, sigma_ba) | |
| pixel observation of board corner in camera | |
| camera projection: point in to pixel (Camera model) | |
| residual (subscripted by factor type) | |
| measurement covariance | |
| covariance of the IMU preintegration over interval (Base IMU factor) |
Every stamp is mapped onto one reference clock, the base-IMU clock.
| Symbol | Meaning |
|---|---|
| timestamp on the base-IMU clock, the reference | |
| timestamp as reported by a camera driver | |
| offset such that | |
| whole-frame readout time of a rolling-shutter camera | |
| row factor of image row : the share of after the frame stamp (Rolling shutter) | |
| gyro–accel offset: the accel reading stamped was sampled at |
A board corner seen in row of camera was captured at
The sign convention matters.
td is added to the sensor’s own stamp to reach base-IMU time.
A positive td means the camera stamps run early: the image was captured later than its stamp says.
mvis apply-calib re-stamps each message as stamp + td.
Conventions worth stating once
Section titled “Conventions worth stating once”- Quaternions: result files store rotations as matrices and log(R)
rotation vectors, not quaternions. Simulator trajectory files
(
mvis.simulation) use JPL quaternions , as in OpenVINS. The Basalt export uses Hamilton quaternions, as Basalt does. - Error states (the small corrections around the current estimate) are defined:
- multiplicatively for rotations, ;
- additively for everything else.
- Units in result files: metres, radians and seconds; summaries add
_mmand_mscopies where the name says so. - Board points are flat and known by default (
estimate.board_points: false). Board errors then go into the calibration: a wrongtag_sizegives a scale bias on translations, and a bent board biases the focal length, gyro scale and lever (Why calibrate the board shape). Withestimate.board_points: true, MVIS solves one height per corner.
Glossary
Section titled “Glossary”- Factor: one term of the cost the solver minimises.
- Residual: the error a factor measures, predicted minus observed.
- Jacobian: the derivative of a residual with respect to a state variable.
- Lever arm: the translation between two sensors, e.g. .
- Incidence angle: the angle of a ray off the camera’s optical axis.
- Specific force: what an accelerometer measures, acceleration minus gravity.
- Pre-integration: IMU readings between two states combined into one relative motion.
- Base / auxiliary IMU: the base IMU sets the clock and the body frame; every other IMU is auxiliary.