Function lupnt::ConvertFrame(Real, const Vec3&, Frame, Frame, bool)

Function Documentation

Vec3 lupnt::ConvertFrame(Real t_tdb, const Vec3 &r_in, Frame frame_in, Frame frame_out, bool rotate_only = false)

Converts a position vector at epoch t_tdb from frame_in to frame_out.

This is the position-only (Vec3) overload of the central frame-conversion dispatcher used throughout the simulator (dynamics, measurements, agents, environment) to express a state in whatever frame the caller needs; it dispatches through ConvertFrameBase, which walks the frame graph (see the adjacency diagram on the Vec6 ConvertFrame overload below) applying the individual *To* conversions from frame_conversions.h until frame_out is reached.

Parameters:

  • t_tdb – Epoch [s, TDB since J2000]

  • r_in – Position vector in frame_in [m]

  • frame_in – Input reference frame

  • frame_out – Output reference frame

  • rotate_only – If true, apply only the rotation (and skip the frame-origin translation) — e.g. to transform a direction/offset vector rather than an absolute position

Returns:

Position vector in frame_out [m]