RCAIDE.Library.Mission.Common.Unpack_Unknowns.orientation

orientation#

orientation(segment)[source]#

Updates vehicle orientation states from solver unknowns

Parameters:

segment (Segment) –

The mission segment being analyzed
  • assigned_control_variablesData
    Control configurations
    • body_angleControl

      Body angle control settings

    • bank_angleControl

      Bank angle control settings

    • velocityControl

      Velocity control settings

    • altitudeControl

      Altitude control settings

  • trim_lift_coefficientfloat, optional

    Target lift coefficient for trim

  • angle_of_attackfloat

    Fixed angle of attack [rad]

  • bank_anglefloat

    Fixed bank angle [rad]

  • stateData

    Current segment state - conditions : Data

    Flight conditions
    • frames.body.inertial_rotationsarray

      Body orientation angles [rad]

    • frames.planet.true_headingarray

      Vehicle heading [rad]

    • frames.inertial.velocity_vectorarray

      Vehicle velocity [m/s]

    • frames.inertial.position_vectorarray

      Vehicle position [m]

    • unknownsData
      Solver variables
      • body_anglearray

        Body angle values [rad]

      • bank_anglearray

        Bank angle values [rad]

      • velocityarray

        Velocity values [m/s]

      • altitudearray

        Altitude values [m]

    • ones_rowfunction

      Creates array of ones with specified columns

Returns:

Updates segment conditions directly

Return type:

None

Notes

This function applies orientation-related solver values to the segment state, handling body angles, trim conditions, and trajectory controls. It manages both active control and fixed orientation cases.

The function processes:
  1. Body angle control
    • Trim conditions

    • Active angle control

    • Fixed angle of attack

  2. Bank angle control
    • Active bank control

    • Fixed bank angle

  3. Heading alignment

  4. Velocity control

  5. Altitude control

Major Assumptions
  • Valid angle definitions

  • Proper control assignments

  • Compatible trim conditions

  • Well-defined reference frames