Maneuver#

class Maneuver(thrust=None, mass_flow=None, start_time=None, end_time=None, ux=None, uy=None, uz=None)#

Bases: object

Defines a finite-burn maneuver as a collection of time-polynomial parameters.

Each scalar parameter — thrust magnitude \(F(t)\), mass-flow rate \(\dot{m}(t)\), and thrust-direction components \(u_x(t),\,u_y(t),\,u_z(t)\) — is represented as a 6th-order polynomial in ephemeris time:

\[p(t) = \sum_{k=0}^{6} c_k\, t^k\]

and stored as a 7-element coefficient vector \([c_0, c_1, \ldots, c_6]\). Constant profiles set only \(c_0\); the remaining coefficients default to zero.

The thrust-induced acceleration at time \(t\) is:

\[\mathbf{a}(t) = \frac{F(t)}{m(t)}\,\hat{u}(t)\]

where \(m(t)\) is the spacecraft mass and \(\hat{u}(t) = [u_x,\,u_y,\,u_z]^T\) is the unit thrust-direction vector. Thrust is stored internally in kN so that dividing by mass in kg directly yields acceleration in km/s^2.

Parameters:
thrustArrayWUnits, optional

Thrust magnitude polynomial (any force unit; stored internally in kN).

mass_flowArrayWUnits, optional

Propellant mass-flow rate polynomial (kg/s).

start_timeEpochArray, optional

Burn start epoch. Must be strictly less than end_time.

end_timeEpochArray, optional

Burn end epoch. Must be strictly greater than start_time.

uxArrayWUnits, optional

X-component of the unit thrust-direction vector (unitless polynomial).

uyArrayWUnits, optional

Y-component of the unit thrust-direction vector (unitless polynomial).

uzArrayWUnits, optional

Z-component of the unit thrust-direction vector (unitless polynomial).

Attributes:
end_time

Burn end epoch in seconds (TDB).

mass_flow

Propellant mass-flow rate polynomial (kg/s).

start_time

Burn start epoch in seconds (TDB).

thrust

Thrust-magnitude polynomial stored in kN.

ux

X-component of the unit thrust-direction vector (unitless polynomial).

uy

Y-component of the unit thrust-direction vector (unitless polynomial).

uz

Z-component of the unit thrust-direction vector (unitless polynomial).

See also

scarabaeus.FiniteBurn

Force model that evaluates Maneuver polynomials during propagation.

scarabaeus.ManeuverParser

Utility for loading Maneuver objects from a file.

Notes

All polynomial coefficient arrays are zero-padded to length 7 (6th-order) given in ascending degree order (index 0 = constant term) and stored in descending order (index 0 = the \(t^6\) coefficient). Thrust is always converted to and stored in kN so that dividing by spacecraft mass in kg yields acceleration directly in km/s^2.

property end_time: EpochArray | None#

Burn end epoch in seconds (TDB).

Returns:
EpochArray or None
property mass_flow: ArrayWUnits | None#

Propellant mass-flow rate polynomial (kg/s).

The coefficient array is in descending degree order: index 0 holds the highest-order (\(t^6\)) coefficient and index 6 holds the constant term.

Returns:
ArrayWUnits or None

7-element polynomial with units [kg/s^7, kg/s^6, ..., kg/s] (highest to lowest degree), or None if not set.

property start_time: EpochArray | None#

Burn start epoch in seconds (TDB).

Returns:
EpochArray or None
property thrust: ArrayWUnits | None#

Thrust-magnitude polynomial stored in kN.

The coefficient array is in descending degree order: index 0 holds the highest-order (\(t^6\)) coefficient and index 6 holds the constant term.

Returns:
ArrayWUnits or None

7-element polynomial with units [kN/s^6, kN/s^5, ..., kN] (highest to lowest degree), or None if not set.

property ux: ArrayWUnits | None#

X-component of the unit thrust-direction vector (unitless polynomial).

Returns:
ArrayWUnits or None
property uy: ArrayWUnits | None#

Y-component of the unit thrust-direction vector (unitless polynomial).

Returns:
ArrayWUnits or None
property uz: ArrayWUnits | None#

Z-component of the unit thrust-direction vector (unitless polynomial).

Returns:
ArrayWUnits or None