3D Gimbal
VisualizationThe Gimbal3D block provides real-time three-dimensional attitude visualization of aerospace, maritime, and robotic systems. It renders a hardware-accelerated WebGL scene containing three concentric nested gimbal rings that orient dynamically in response to Roll, Pitch, and Yaw angular input signals.
As a dedicated visualization sink, the Gimbal3D block does not modify signal values or impose numerical constraints on the simulation engine. It provides intuitive spatial feedback for attitude control systems, flight simulators, drone autopilots, and robotic end-effector stabilization loops.
Mathematical Model
The transformation maps angular inputs in degrees to orthogonal rotation matrices:
Inputs & Outputs
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | roll |
Roll | number | Required |
| → In | pitch |
Pitch | number | Required |
| → In | yaw |
Yaw | number | Required |
Usage Examples
Example 1: Aircraft Attitude Visualization
Outputs from a 6-DOF flight dynamics model () are routed directly to the Roll, Pitch, and Yaw ports to visualize aircraft bank, pitch trim, and heading in real time.
Example 2: IMU Gyroscope Rate Integration
Angular rate signals from a triaxial gyroscope () are passed through three Integrator blocks with degree conversion gains to animate orientation tracking.
Remarks & Best Practices
- Input units: Angular inputs are interpreted in degrees. When upstream simulation models compute angles in radians, scale the signal by .
- Aerospace convention: Rings follow the standard Z-X-Y intrinsic Euler sequence: yaw rotates the outer ring, pitch tilts the intermediate ring, and roll rotates the inner ring.
- Unconnected inputs: Any unconnected input port defaults to zero degrees, holding that rotational axis stationary while active ports rotate.
- Hardware acceleration: Rendered via Three.js and WebGL directly on the client GPU, ensuring smooth frame rates without affecting solver execution speed.
Related Components
- uPlotDisplay: Time-series strip chart for logging continuous angular trajectories and tracking errors.
- Integrator: Computes orientation angles by integrating angular velocity signals over time.
- NumericDisplay: Shows numerical digital readouts of instantaneous pitch, roll, or heading angles.