Reference Frame#

service ReferenceFrameService#

A reference frame, in which positions, directions, rotations and velocities are given. Obtained from the reference frame properties of Vehicle and Body, or created with ReferenceFrameService.CreateRelative and ReferenceFrameService.CreateHybrid.

Note

Every reference frame is right-handed. Positions are in meters, velocities in meters per second, and angular velocities in radians per second. A rotation is a quaternion (x, y, z, w).

rpc CreateRelative (ReferenceFrame.CreateRelativeRequest) returns (ReferenceFrame.CreateRelativeResponse)#

Create a reference frame that is offset from a parent frame.

ReferenceFrame.CreateRelativeRequest:
  • reference_frame (ReferenceFrame): The parent reference frame.

  • position (Tuple_double_double_double): The position of the origin in the parent frame, in meters. Defaults to (0, 0, 0).

  • rotation (Tuple_double_double_double_double): The rotation of the frame relative to the parent frame. Defaults to (0, 0, 0, 1), no rotation.

  • velocity (Tuple_double_double_double): The velocity of the origin in the parent frame, in meters per second. Defaults to (0, 0, 0).

  • angular_velocity (Tuple_double_double_double): The angular velocity of the frame relative to the parent frame, in radians per second, in the axes of the parent frame. Defaults to (0, 0, 0).

ReferenceFrame.CreateRelativeResponse:

value (ReferenceFrame)

rpc CreateHybrid (ReferenceFrame.CreateHybridRequest) returns (ReferenceFrame.CreateHybridResponse)#

Create a reference frame that takes its components from other frames.

ReferenceFrame.CreateHybridRequest:
  • position (ReferenceFrame): The reference frame that gives the origin.

  • rotation (ReferenceFrame): The reference frame that gives the axes. Defaults to position.

  • velocity (ReferenceFrame): The reference frame that gives the velocity of the origin. Defaults to position.

  • angular_velocity (ReferenceFrame): The reference frame that gives the angular velocity. Defaults to position.

ReferenceFrame.CreateHybridResponse:

value (ReferenceFrame)