Maneuver#
- class Maneuver(thrust=None, mass_flow=None, start_time=None, end_time=None, ux=None, uy=None, uz=None)#
Bases:
objectDefines 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_timeBurn end epoch in seconds (TDB).
mass_flowPropellant mass-flow rate polynomial (kg/s).
start_timeBurn start epoch in seconds (TDB).
thrustThrust-magnitude polynomial stored in kN.
uxX-component of the unit thrust-direction vector (unitless polynomial).
uyY-component of the unit thrust-direction vector (unitless polynomial).
uzZ-component of the unit thrust-direction vector (unitless polynomial).
See also
scarabaeus.FiniteBurnForce model that evaluates Maneuver polynomials during propagation.
scarabaeus.ManeuverParserUtility 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), orNoneif 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), orNoneif 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