RCAIDE.Library.Methods.Powertrain.Propulsors.Internal_Combustion_Engine.append_internal_combustion_engine_residual_and_unknown

append_internal_combustion_engine_residual_and_unknown#

append_internal_combustion_engine_residual_and_unknown(propulsor, segment)[source]#

Appends the torque matching residual and unknown for an internal combustion engine.

Parameters:
  • propulsor (RCAIDE.Library.Components.Propulsors.Internal_Combustion_Engine) –

    Internal combustion engine propulsor component with the following attributes:
    • tagstr

      Identifier for the engine

    • propellerData
      Propeller component
      • cruiseData
        Cruise conditions
        • design_angular_velocityfloat

          Design angular velocity of the propeller [rad/s]

  • segment (RCAIDE.Framework.Mission.Segments.Segment) –

    Mission segment with the following attributes:
    • stateData
      Segment state
      • ones_rowfunction

        Function to create array of ones with specified length

      • unknownsdict

        Dictionary of unknown variables for the solver

      • residualsData
        Residuals for the solver
        • networkdict

          Network residuals

Returns:

Results are stored in segment.state.unknowns and segment.state.residuals.network

Return type:

None

Notes

This function sets up the necessary variables for solving the torque balance between the internal combustion engine and the propeller. It adds:

  • An unknown variable for the propeller angular velocity, initialized with the design angular velocity

  • A residual for the torque balance between the engine and propeller

The torque balance residual will be driven to zero during the numerical solution process, ensuring that the engine provides exactly the torque required by the propeller at the current flight condition.