ssapy_toolkit.Accelerations.accel_circularize

Functions

accel_to_circular(r, v[, t, tol, min_altitude])

Acceleration command that steers (r, v) toward a circular orbit at radius |r|.

reset_orbit_status()

Reset the internal latch so circularization thrust can be used again.

ssapy_toolkit.Accelerations.accel_circularize.accel_to_circular(r, v, t=None, *, thrust, tol=10.0, min_altitude=100000.0)[source]

Acceleration command that steers (r, v) toward a circular orbit at radius |r|.

Designed to be passed into leapfrog(…, accels=[…]) where leapfrog may call accelerations as f(r,v,t) (t is accepted but not required here).

Parameters:
  • r (array_like, shape (3,)) – Position vector (m).

  • v (array_like, shape (3,)) – Velocity vector (m/s).

  • t (optional) – Time (ignored; present for integrator compatibility).

  • thrust (float) – Magnitude of available acceleration (m/s^2).

  • tol (float, optional) – Convergence tolerance on ||v_target - v|| (m/s). Default 10.

  • min_altitude (float, optional) – Minimum altitude above Earth’s surface to allow control (m). Default 100 km.

Returns:

a – Acceleration command (m/s^2), or zeros if converged/disabled.

Return type:

ndarray, shape (3,)

ssapy_toolkit.Accelerations.accel_circularize.reset_orbit_status()[source]

Reset the internal latch so circularization thrust can be used again.