Skip to main content

Gyroscope

Live gyroscope readings for device rotation, with combined and per-axis graphs.

Overview tab with live rotation rate values

Overview​

The gyroscope measures rotational velocity around the device axes. Lirum shows live values and a rolling history for each axis.

Table of Contents​

Tabs​

  • Overview
  • Graphs (combined)
  • Graphs (per axis)

Toolbar Controls​

All motion-sensor tools share the same toolbar controls:

  • Play / Pause: start or pause sensor updates.
  • Clear: clear history buffers used by the graphs.
  • Refresh rate: cycle between Faster, Fast, and Slow sampling rates.

Overview Tab​

The Overview tab features a real-time 3D Metal-rendered wireframe gyroscope consisting of three concentric rings in different planes and colors:

  • Outer ring (red) in the XY plane
  • Inner ring (green) in the YZ plane
  • Rotor disk (blue) in the XZ plane

The rings rotate based on cumulative integrated rotation rates from the sensor. Three static axis lines (X = red, Y = green, Z = blue) provide a fixed reference frame that does not rotate with the model.

Below the visualization, the tab shows current axis values:

  • rotX (X axis)
  • rotY (Y axis)
  • rotZ (Z axis)

Values are shown in radians per second (rad/s).

Graphs Combined Tab​

Graphs (combined): X/Y/Z plotted together

This tab overlays X/Y/Z history on a single graph (X = red, Y = green, Z = blue) with a legend. The Y-axis range is fixed at -10 to +10 rad/s. Current values are displayed with split-precision formatting (the first 4 decimal places are bold, remaining decimals are semi-transparent). The graph retains the last 100 readings.

Graphs Per Axis Tab​

Graphs (per axis): one panel per axis

This tab shows three separate panels (X, Y, Z), each with a dedicated graph and the current value displayed alongside the axis label.

What You Can See​

  • Rotation rate along the X/Y/Z axes (commonly in degrees/second or radians/second)
  • Optional graph/history view (if available)
  • Refresh rate / sampling interval (if configurable)

Notes​

  • Axes orientation depends on device orientation (portrait/landscape).
  • Readings will drift over time; this is normal for gyroscopes.

Notes And Limitations​

  • On Mac Catalyst, motion sensors may be unavailable.
  • Gyroscope readings can drift and are affected by device movement and vibration.
Last updated on by Rogerio Hirooka