RCAIDE.Library.Mission.Common.Residuals.flight_dynamics

flight_dynamics#

flight_dynamics(segment)[source]#

Evaluates flight dynamics residuals for mission segment analysis.

Parameters:

segment (Segment) –

The mission segment being analyzed
  • stateData

    Contains conditions, numerics, and residuals

  • analysesData

    Contains vehicle analysis objects

  • flight_dynamicsData

    Contains flags for which equations to evaluate

Returns:

Updates segment residuals directly in segment.state.residuals

Return type:

None

Notes

This function calculates the residuals for force and moment equations in all three axes. It handles special cases for transition and ground segments, including acceleration calculations and final velocity constraints.

The function processes:

  1. Force equation residuals (F = ma)

  2. Moment equation residuals (M = Iα)

  3. Special handling for transition and ground segments

Required Segment State Variables

state.conditions.frames.inertial:
  • velocity_vectorarray

    Vehicle velocity [m/s]

  • acceleration_vectorarray

    Vehicle acceleration [m/s²]

  • total_force_vectorarray

    Net forces [N]

  • total_moment_vectorarray

    Net moments [N⋅m]

  • angular_velocity_vectorarray

    Angular rates [rad/s]

  • angular_acceleration_vectorarray

    Angular accelerations [rad/s²]

state.conditions.weights:
  • mass.totalarray

    Vehicle mass [kg]

analyses.vehicle.mass_properties:
  • moments_of_inertia.tensorarray

    Inertia tensor [kg⋅m²]

Segment Types

Special handling for: - Ground segments

  • Takeoff

  • Landing

  • Ground operations

Major Assumptions

  • Rigid body dynamics

  • Principal axes aligned with body axes

  • Constant inertia properties during segment

  • Valid mass properties

  • Non-zero final velocity for ground segments (minimum 0.01 m/s)

Theory

Force equations (Newton’s Second Law):

\[\frac{F_i}{m} - a_i = 0\]

Moment equations:

\[\frac{M_i}{I_{ii}} - \alpha_i = 0\]

where \(i\) represents each axis (x, y, z), \(F\) is force, \(a\) is acceleration, \(M\) is moment, \(I\) is moment of inertia, and \(\alpha\) is angular acceleration.

See also

RCAIDE.Framework.Mission.Segments, RCAIDE.Framework.Mission.Segments.Ground