Main Content

Rotor

Rotor dynamics

Since R2023a

  • Rotor block icon

Libraries:
Aerospace Blockset / Propulsion

Description

The Rotor block computes the aerodynamic forces and moments generated by a rotating propeller or rotor in all three dimensions. The block lets you include the effect of the tilt in rotor disc due to flap motion, while in forward flight, on the generated force and moments.

Limitations

  • The block follows a simplified approach with the option to include steady state flap effects. It does not model dynamic flap, lag, or feathering motion of blade.

  • The block does not directly consider the variation in pitch angle input, although you can perform approximate analysis by varying the blade twist.

  • The block uses Twist distribution to model only linear or ideal twist distributions. The block assumes that the blade chord and lift curve slope are constant.

Ports

Input

expand all

Rotor speed, specified as a scalar in rad/sec in body frame.

Data Types: double

Air density, specified as a positive scalar in specified units.

Data Types: double

Velocity of rotor, specified as a 3-by-1 or 1-by-3 vector in m/s, in body frame. To perform a multisystem analysis, consider connecting output from a State-Space or Integrator block to this port.

Data Types: double

Angular velocity of entire vehicle, specified as a 3-by-1 or 1-by-3 vector in rad/s in body frame.

Data Types: double

Output

expand all

Total force, returned as a three-element vector in body frame. Units depend on the Units parameter.

Data Types: double

Net moment in the x-y-z direction, returned as a three-element vector in body frame. Units depend on the Units parameter.

Computed thrust coefficient, returned as a scalar positive.

Dependencies

To enable this output port, select these check boxes:

  • Compute CT and CQ

  • Output computed CT and CQ

Computed torque coefficient, returned as a scalar positive.

Dependencies

To enable this output port, select these check boxes:

  • Compute CT and CQ

  • Output computed CT and CQ

Parameters

expand all

UnitsDensityForceMassVelocityRadiusChordHinge offset
Metric (MKS) kg/m3NewtonsNewton-meterMeters per secondMetersMetersMeters
English (Velocity in ft/s) slug/ft3Pound forcePound force-feetFeet per secondFeetFeetFeet
English (Velocity in kts) slug/ft3Pound forcePound force-feetFeet per secondFeetFeetFeet

Programmatic Use

Block Parameter: units
Type: character vector
Values: 'Metric (MKS)' | 'English (Velocity in ft/s)' | 'English (Velocity in kts)'
Default: 'Metric (MKS)'

Rotor thrust calculation method, specified as:

  • Without flap effects — Model rotor thrust using force and moment calculations. For more information, see Force and Moment.

  • With flap effects — Effect of tilt in rotor disc due to flap motion, while in forward flight, is included. The steady state lateral and longitudinal flap angles are calculated using the equations from [1] and [2].

Programmatic Use

Block Parameter: modelMode
Type: character vector
Values: 'Without flap effects' | 'With flap effects'
Default: 'Without flap effects'

Number of blades, specified as a nonzero positive scalar.

Dependencies

To enable this parameter, select the Compute CT and CQ check box and set Modeling to With flap effects.

Programmatic Use

Block Parameter: Nb
Type: character vector
Values: '2' | nonzero positive scalar
Default: '2'

Select this check box to let the block calculate the thrust coefficient and torque coefficient. For more information on these calculations, see Thrust Coefficient and Torque Coefficient Calculations. The block assumes the aerodynamic and structural parameters to be constant.

Clear this check box to specify thrust coefficient and torque coefficient values.

Programmatic Use

Block Parameter: CTcheck
Type: character vector
Values: 'on' | 'off'
Default: 'off'

Select this check box to output the calculated thrust coefficient and torque coefficient to CT and CQ output ports. For more information on these calculations, see Thrust Coefficient and Torque Coefficient Calculations. The block assumes the aerodynamic and structural parameters to be constant.

Otherwise, clear this check box.

Programmatic Use

Block Parameter: CTout
Type: character vector
Values: 'on' | 'off'
Default: 'off'

Thrust coefficient, specified as a nonzero positive scalar.

Dependencies

To enable this parameter, clear the Compute CT and CQ check box.

Programmatic Use

Block Parameter: CT
Type: character vector
Values: '0.0107' | nonzero positive scalar
Default: '0.0107'

Torque coefficient, specified as a nonzero positive scalar.

Dependencies

To enable this parameter, clear the Compute CT and CQ check box.

Programmatic Use

Block Parameter: CQ
Type: character vector
Values: '7.8263e-4' | nonzero positive scalar
Default: '7.8263e-4'

Rotor radius, specified as a nonzero positive scalar.

Programmatic Use

Block Parameter: R
Type: character vector
Values: '0.0330' | nonzero positive scalar
Default: '0.0330'

Blade chord, specified as a nonzero positive scalar.

Programmatic Use

Block Parameter: c
Type: character vector
Values: '0.0080' | nonzero positive scalar
Default: '0.0080'

Hinge offset, specified as a positive scalar. This value is typically 0 for propellers.

Dependencies

To enable this parameter, select the Compute CT and CQ check box and set Modeling to With flap effects.

Programmatic Use

Block Parameter: m
Type: character vector
Values: '0' | positive scalar
Default: '0'

Lift curve slope, specified as a nonzero positive scalar. The block assumes the aerodynamic and structural parameters to be constant. The block does not consider variation with respect to angle of attack.

Dependencies

To enable this parameter, select the Compute CT and CQ check box and set Modeling to With flap effects.

Programmatic Use

Block Parameter: clalpha
Type: character vector
Values: '5.5' | nonzero positive scalar
Default: '5.5'

Lock number, which is the ratio of aerodynamics forces to inertial forces, specified as a nonzero positive scalar.

Dependencies

To enable this parameter, set Modeling to With flap effects.

Programmatic Use

Block Parameter: gamma
Type: character vector
Values: '0.6051' | nonzero positive scalar
Default: '0.6051'

Rotor blade twist distribution, specified as:

  • Linear — Close approximation of blade twist distribution.

  • Ideal — Optimal approximation of blade twist distribution.

Dependencies

To enable this parameter, select the Compute CT and CQ check box and set Modeling to With flap effects.

Programmatic Use

Block Parameter: twistType
Type: character vector
Values: 'Linear' | 'Ideal'
Default: 'Linear'

Blade root pitch angle θ0, specified as a nonzero positive scalar.

Dependencies

To enable this parameter:

  • Set Modeling to With flap effects.

  • Set Twist distribution to Linear.

Programmatic Use

Block Parameter: theta0
Type: character vector
Values: '0.2548' | nonzero positive scalar
Default: '0.2548'

Blade twist angle θ1, specified as a positive scalar.

Dependencies

To enable this parameter:

  • Set Modeling to With flap effects.

  • Set Twist distribution to Linear.

Programmatic Use

Block Parameter: theta1
Type: character vector
Values: '-0.1361' | positive scalar
Default: '-0.1361'

Blade tip pitch angle θtip for ideal twist distribution, specified as a nonzero positive scalar.

Dependencies

To enable this parameter:

  • Set Modeling to With flap effects.

  • Set Twist distribution to Ideal.

Programmatic Use

Block Parameter: thetaTip
Type: character vector
Values: '0.06' | nonzero positive scalar
Default: '0.06'

Algorithms

expand all

References

[1] Pounds, P. E. I. (2007). Design, construction and control of a large quadrotor micro air vehicle (Doctoral dissertation, Australian National University).

[2] Riether, F. (2016). Agile quadrotor maneuvering using tensor-decomposition-based globally optimal control and onboard visual-inertial estimation (Doctoral dissertation, Massachusetts Institute of Technology).

Version History

Introduced in R2023a

See Also