Class PropellerPropulsor
Propeller-driven propulsor using blade element theory. Calculates thrust based on blade pitch angle, RPM, freestream velocity, and airfoil characteristics. Supports fixed-pitch and variable-pitch (constant-speed) configurations.
Inherited Members
Namespace: NWH.Aerodynamics.AircraftController.Propulsion.Propulsors
Assembly: NWH.Aerodynamics.dll
Syntax
public class PropellerPropulsor : PropulsorBase
Fields
| Edit this page View SourceVp
Effective velocity through the propeller disc in m/s. Combination of tangential blade velocity and freestream velocity.
Declaration
public float Vp
Field Value
| Type | Description |
|---|---|
| float |
airfoilProfile
Airfoil profile defining lift and drag characteristics of the propeller blades.
Declaration
public AirfoilProfile airfoilProfile
Field Value
| Type | Description |
|---|---|
| AirfoilProfile |
aoa
Current angle of attack of the propeller blades in degrees.
Declaration
public float aoa
Field Value
| Type | Description |
|---|---|
| float |
autoPropPitch
Enables automatic pitch control to maintain target RPM (constant-speed propeller).
Declaration
public bool autoPropPitch
Field Value
| Type | Description |
|---|---|
| bool |
bladeCount
Number of propeller blades. More blades increase thrust but also drag.
Declaration
public int bladeCount
Field Value
| Type | Description |
|---|---|
| int |
bladeWidth
Width (chord) of each blade in meters. Affects thrust area calculation.
Declaration
public float bladeWidth
Field Value
| Type | Description |
|---|---|
| float |
dragCoefficient
Multiplier for drag force calculation. Higher values increase propeller drag.
Declaration
public float dragCoefficient
Field Value
| Type | Description |
|---|---|
| float |
dragMagnitude
Current drag force magnitude in Newtons.
Declaration
public float dragMagnitude
Field Value
| Type | Description |
|---|---|
| float |
feather
When true, blades are feathered (90 degrees) to minimize drag. Used for engine-out scenarios in multi-engine aircraft.
Declaration
public bool feather
Field Value
| Type | Description |
|---|---|
| bool |
gizmoAngleOffset
Visual offset angle for blade rendering in degrees.
Declaration
public float gizmoAngleOffset
Field Value
| Type | Description |
|---|---|
| float |
maxPitch
Maximum blade pitch angle in degrees. Higher values allow more thrust at higher speeds.
Declaration
public float maxPitch
Field Value
| Type | Description |
|---|---|
| float |
minPitch
Minimum blade pitch angle in degrees. Lower values provide less thrust for ground/taxi operations.
Declaration
public float minPitch
Field Value
| Type | Description |
|---|---|
| float |
peakEfficiency
Peak propulsive efficiency achievable (0 to 1). Typical values: 0.75-0.85 for well-designed propellers.
Declaration
public float peakEfficiency
Field Value
| Type | Description |
|---|---|
| float |
pitchAngle
Current blade pitch angle in degrees. Higher values generate more thrust but require more power.
Declaration
[Range(-45, 90)]
public float pitchAngle
Field Value
| Type | Description |
|---|---|
| float |
pitchInputBinding
Input axis to use for manual pitch control.
Declaration
public PropellerPropulsor.PitchInputBinding pitchInputBinding
Field Value
| Type | Description |
|---|---|
| PropellerPropulsor.PitchInputBinding |
targetPropRPM
Target RPM for automatic pitch control (constant-speed mode).
Declaration
public float targetPropRPM
Field Value
| Type | Description |
|---|---|
| float |
thrustCoefficient
Multiplier for thrust force calculation. Use to tune propeller performance.
Declaration
public float thrustCoefficient
Field Value
| Type | Description |
|---|---|
| float |
thrustMagnitude
Current thrust force magnitude in Newtons.
Declaration
public float thrustMagnitude
Field Value
| Type | Description |
|---|---|
| float |
variablePropPitch
Enables variable pitch control (constant-speed propeller). When false, propeller operates at fixed pitch.
Declaration
public bool variablePropPitch
Field Value
| Type | Description |
|---|---|
| bool |
windmilling
Indicates if propeller is windmilling (engine not providing power).
Declaration
public bool windmilling
Field Value
| Type | Description |
|---|---|
| bool |
Methods
| Edit this page View SourceAwake()
Declaration
public override void Awake()
Overrides
| Edit this page View SourceOnDrawGizmosSelected()
Declaration
public override void OnDrawGizmosSelected()
Overrides
| Edit this page View SourceStep(float, float, float, float, Atmosphere, out float, out float)
Simulates the propulsor for one physics step. Calculates thrust and torque based on angular velocity, freestream velocity, and atmospheric conditions.
Declaration
public override void Step(float inAngVel, float maxAngVel, float inV0, float inTorque, Atmosphere atmosphere, out float outThrust, out float outTorque)
Parameters
| Type | Name | Description |
|---|---|---|
| float | inAngVel | Input angular velocity in rad/s. |
| float | maxAngVel | Maximum angular velocity in rad/s. |
| float | inV0 | Freestream velocity in m/s. |
| float | inTorque | Input torque from engine in N*m. |
| Atmosphere | atmosphere | Atmospheric conditions for air density. |
| float | outThrust | |
| float | outTorque |