ssapy_toolkit.Plots.divergence_gif

ssapy_toolkit.Plots.divergence_gif(r_histories, times_gps, output_path, r_nominal_hist=None, v_nominal_hist=None, fps=2, duration=None, vmin=-50, vmax=50)[source]

Create an animated GIF showing position error evolution over time.

Parameters:

  • r_histories (np.ndarray) – Position time series, shape (n_samples, n_snapshots, 3) in meters

  • times_gps (np.ndarray) – GPS times for each snapshot, shape (n_snapshots,)

  • output_path (str) – Path where GIF will be saved (required)

  • r_nominal_hist (np.ndarray, optional) – Nominal position time series, shape (n_snapshots, 3) in meters. If None, uses median of r_histories at each time step.

  • v_nominal_hist (np.ndarray, optional) – Nominal velocity time series, shape (n_snapshots, 3) in m/s. If None, computes velocity from r_nominal_hist using finite differences.

  • fps (int) – Frames per second (ignored if duration is provided)

  • duration (float or None) – Seconds per frame. If provided, overrides fps [3]

  • vmin (float) – Color scale limits for timing difference [seconds]

  • vmax (float) – Color scale limits for timing difference [seconds]

Returns:

Path to the created GIF file

Return type:

str