FlightGear: JSBSim::FGPropeller Class Reference

FGPropeller models a propeller given the tabular data for Ct (thrust) and Cp (power), indexed by the advance ratio "J". More...

#include <FGPropeller.h>

Inherits JSBSim::FGThruster.

Public Member Functions
	FGPropeller (FGFDMExec exec, Element el, int num=0)
	Constructor for FGPropeller.

	~FGPropeller ()
	Destructor for FGPropeller - deletes the FGTable objects.

void	ResetToIC (void)
	Reset the initial conditions.

void	SetRPM (double rpm)
	Sets the Revolutions Per Minute for the propeller.

void	SetEngineRPM (double rpm)
	Sets the Revolutions Per Minute for the propeller using the engine gear ratio.

bool	IsVPitch (void) const
	Returns true of this propeller is variable pitch.

void	SetPitch (double pitch)
	This commands the pitch of the blade to change to the value supplied.

void	SetAdvance (double advance)
	Set the propeller pitch.

void	SetPFactor (double pf)
	Sets the P-Factor constant.

void	SetConstantSpeed (int mode)
	Sets propeller into constant speed mode, or manual pitch mode.

void	SetCtFactor (double ctf)
	Sets coefficient of thrust multiplier.

void	SetCpFactor (double cpf)
	Sets coefficient of power multiplier.

void	SetSense (double s)
	Sets the rotation sense of the propeller.

double	GetPitch (void) const
	Retrieves the pitch of the propeller in degrees.

double	GetRPM (void) const
	Retrieves the RPMs of the propeller.

double	GetEngineRPM (void) const
	Calculates the RPMs of the engine based on gear ratio.

double	GetIxx (void) const
	Retrieves the propeller moment of inertia.

double	GetCtFactor (void) const
	Retrieves the coefficient of thrust multiplier.

double	GetCpFactor (void) const
	Retrieves the coefficient of power multiplier.

double	GetDiameter (void) const
	Retrieves the propeller diameter.

FGTable *	GetCThrustTable (void) const
	Retrieves propeller thrust table.

FGTable *	GetCPowerTable (void) const
	Retrieves propeller power table.

FGTable *	GetCtMachTable (void) const
	Retrieves propeller thrust Mach effects factor.

FGTable *	GetCpMachTable (void) const
	Retrieves propeller power Mach effects factor.

double	GetTorque (void) const
	Retrieves the Torque in foot-pounds (Don't you love the English system?)

double	GetPowerRequired (void)
	Retrieves the power required (or "absorbed") by the propeller - i.e.

double	Calculate (double EnginePower)
	Calculates and returns the thrust produced by this propeller.

FGColumnVector3	GetPFactor (void) const
	Retrieves the P-Factor constant.

std::string	GetThrusterLabels (int id, const std::string &delimeter)
	Generate the labels for the thruster standard CSV output.

std::string	GetThrusterValues (int id, const std::string &delimeter)
	Generate the values for the thruster standard CSV output.

void	SetReverseCoef (double c)
	Set the propeller reverse pitch.

double	GetReverseCoef (void) const
	Retrieves the reverse pitch command.

void	SetReverse (bool r)
	If true, sets the propeller in reversed position.

bool	GetReverse (void) const
	Returns true if the propeller is in reverse position.

void	SetFeather (bool f)
	If true, sets the propeller in feathered position.

bool	GetFeather (void) const
	Returns true if the propeller is in feathered position.

double	GetThrustCoefficient (void) const
	Retrieves the thrust coefficient.

double	GetHelicalTipMach (void) const
	Retrieves the Mach number at the propeller tips.

int	GetConstantSpeed (void) const
	Returns a non-zero value if the propeller is constant speed.

void	SetInducedVelocity (double Vi)
	Set the propeller induced velocity.

double	GetInducedVelocity (void) const
	Get the propeller induced velocity.

Public Member Functions inherited from JSBSim::FGThruster
	FGThruster (FGFDMExec FDMExec, Element el, int num)
	Constructor.

virtual	~FGThruster ()
	Destructor.

void	SetName (std::string name)

double	GetThrust (void) const

eType	GetType (void)

std::string	GetName (void)

void	SetReverserAngle (double angle)

double	GetReverserAngle (void) const

double	GetGearRatio (void)

Public Member Functions inherited from JSBSim::FGForce
	FGForce (FGFDMExec *FDMExec)
	Constructor.

	FGForce (const FGForce &force)

virtual	~FGForce ()
	Destructor.

virtual const FGColumnVector3 &	GetBodyForces (void)

double	GetBodyXForce (void) const

double	GetBodyYForce (void) const

double	GetBodyZForce (void) const

const FGColumnVector3 &	GetMoments (void) const

void	SetLocation (double x, double y, double z)

void	SetActingLocation (double x, double y, double z)
	Acting point of application.

void	SetLocationX (double x)

void	SetLocationY (double y)

void	SetLocationZ (double z)

double	SetActingLocationX (double x)

double	SetActingLocationY (double y)

double	SetActingLocationZ (double z)

void	SetLocation (const FGColumnVector3 &vv)

void	SetActingLocation (const FGColumnVector3 &vv)

double	GetLocationX (void) const

double	GetLocationY (void) const

double	GetLocationZ (void) const

double	GetActingLocationX (void) const

double	GetActingLocationY (void) const

double	GetActingLocationZ (void) const

const FGColumnVector3 &	GetLocation (void) const

const FGColumnVector3 &	GetActingLocation (void) const

void	SetAnglesToBody (double broll, double bpitch, double byaw)

void	SetAnglesToBody (const FGColumnVector3 &vv)

void	UpdateCustomTransformMatrix (void)

void	SetPitch (double pitch)

void	SetYaw (double yaw)

double	GetPitch (void) const

double	GetYaw (void) const

const FGColumnVector3 &	GetAnglesToBody (void) const

double	GetAnglesToBody (int axis) const

void	SetTransformType (TransformType ii)

TransformType	GetTransformType (void) const

const FGMatrix33 &	Transform (void) const

Public Member Functions inherited from JSBSim::FGJSBBase
	FGJSBBase ()
	Constructor for FGJSBBase.

virtual	~FGJSBBase ()
	Destructor for FGJSBBase.

void	PutMessage (const Message &msg)
	Places a Message structure on the Message queue.

void	PutMessage (const std::string &text)
	Creates a message with the given text and places it on the queue.

void	PutMessage (const std::string &text, bool bVal)
	Creates a message with the given text and boolean value and places it on the queue.

void	PutMessage (const std::string &text, int iVal)
	Creates a message with the given text and integer value and places it on the queue.

void	PutMessage (const std::string &text, double dVal)
	Creates a message with the given text and double value and places it on the queue.

int	SomeMessages (void) const
	Reads the message on the queue (but does not delete it).

void	ProcessMessage (void)
	Reads the message on the queue and removes it from the queue.

Message *	ProcessNextMessage (void)
	Reads the next message on the queue and removes it from the queue.

void	disableHighLighting (void)
	Disables highlighting in the console output.

Additional Inherited Members
Public Types inherited from JSBSim::FGThruster
enum	eType { ttNozzle , ttRotor , ttPropeller , ttDirect }

Public Types inherited from JSBSim::FGForce
enum	TransformType { tNone , tWindBody , tLocalBody , tCustom }

Public Types inherited from JSBSim::FGJSBBase
enum	{ eL = 1 , eM , eN }
	Moments L, M, N. More...

enum	{ eP = 1 , eQ , eR }
	Rates P, Q, R. More...

enum	{ eU = 1 , eV , eW }
	Velocities U, V, W. More...

enum	{ eX = 1 , eY , eZ }
	Positions X, Y, Z. More...

enum	{ ePhi = 1 , eTht , ePsi }
	Euler angles Phi, Theta, Psi. More...

enum	{ eDrag = 1 , eSide , eLift }
	Stability axis forces, Drag, Side force, Lift. More...

enum	{ eRoll = 1 , ePitch , eYaw }
	Local frame orientation Roll, Pitch, Yaw. More...

enum	{ eNorth = 1 , eEast , eDown }
	Local frame position North, East, Down. More...

enum	{ eLat = 1 , eLong , eRad }
	Locations Radius, Latitude, Longitude. More...

enum	{ inNone = 0 , inDegrees , inRadians , inMeters , inFeet }
	Conversion specifiers. More...

static const std::string &	GetVersion (void)
	Returns the version number of JSBSim.

static constexpr double	KelvinToFahrenheit (double kelvin)
	Converts from degrees Kelvin to degrees Fahrenheit.

static constexpr double	CelsiusToRankine (double celsius)
	Converts from degrees Celsius to degrees Rankine.

static constexpr double	RankineToCelsius (double rankine)
	Converts from degrees Rankine to degrees Celsius.

static constexpr double	KelvinToRankine (double kelvin)
	Converts from degrees Kelvin to degrees Rankine.

static constexpr double	RankineToKelvin (double rankine)
	Converts from degrees Rankine to degrees Kelvin.

static constexpr double	FahrenheitToCelsius (double fahrenheit)
	Converts from degrees Fahrenheit to degrees Celsius.

static constexpr double	CelsiusToFahrenheit (double celsius)
	Converts from degrees Celsius to degrees Fahrenheit.

static constexpr double	CelsiusToKelvin (double celsius)
	Converts from degrees Celsius to degrees Kelvin.

static constexpr double	KelvinToCelsius (double kelvin)
	Converts from degrees Kelvin to degrees Celsius.

static constexpr double	FeetToMeters (double measure)
	Converts from feet to meters.

static double	PitotTotalPressure (double mach, double p)
	Compute the total pressure in front of the Pitot tube.

static double	MachFromImpactPressure (double qc, double p)
	Compute the Mach number from the differential pressure (qc) and the static pressure.

static double	VcalibratedFromMach (double mach, double p)
	Calculate the calibrated airspeed from the Mach number.

static double	MachFromVcalibrated (double vcas, double p)
	Calculate the Mach number from the calibrated airspeed.Based on the formulas in the US Air Force Aircraft Performance Flight Testing Manual (AFFTC-TIH-99-01).

static bool	EqualToRoundoff (double a, double b)
	Finite precision comparison.

static bool	EqualToRoundoff (float a, float b)
	Finite precision comparison.

static bool	EqualToRoundoff (float a, double b)
	Finite precision comparison.

static bool	EqualToRoundoff (double a, float b)
	Finite precision comparison.

static constexpr double	Constrain (double min, double value, double max)
	Constrain a value between a minimum and a maximum value.

static constexpr double	sign (double num)

static double	GaussianRandomNumber (void)

Public Attributes inherited from JSBSim::FGThruster
struct JSBSim::FGThruster::Inputs	in

Static Public Attributes inherited from JSBSim::FGJSBBase
static char	highint [5] = {27, '[', '1', 'm', '\0' }
	highlights text

static char	halfint [5] = {27, '[', '2', 'm', '\0' }
	low intensity text

static char	normint [6] = {27, '[', '2', '2', 'm', '\0' }
	normal intensity text

static char	reset [5] = {27, '[', '0', 'm', '\0' }
	resets text properties

static char	underon [5] = {27, '[', '4', 'm', '\0' }
	underlines text

static char	underoff [6] = {27, '[', '2', '4', 'm', '\0' }
	underline off

static char	fgblue [6] = {27, '[', '3', '4', 'm', '\0' }
	blue text

static char	fgcyan [6] = {27, '[', '3', '6', 'm', '\0' }
	cyan text

static char	fgred [6] = {27, '[', '3', '1', 'm', '\0' }
	red text

static char	fggreen [6] = {27, '[', '3', '2', 'm', '\0' }
	green text

static char	fgdef [6] = {27, '[', '3', '9', 'm', '\0' }
	default text

static short	debug_lvl = 1

static std::string	CreateIndexedPropertyName (const std::string &Property, int index)

Protected Attributes inherited from JSBSim::FGThruster
eType	Type

std::string	Name

double	Thrust

double	PowerRequired

double	GearRatio

double	ThrustCoeff

double	ReverserAngle

int	EngineNum

Protected Attributes inherited from JSBSim::FGForce
FGFDMExec *	fdmex

FGMassBalance *	MassBalance

FGColumnVector3	vFn

FGColumnVector3	vMn

FGColumnVector3	vOrient

TransformType	ttype

FGColumnVector3	vXYZn

FGColumnVector3	vActingXYZn

FGMatrix33	mT

static Message	localMsg

static std::queue< Message >	Messages

static unsigned int	messageId = 0

static constexpr double	radtodeg = 180. / 3.14159265358979323846

static constexpr double	degtorad = 3.14159265358979323846 / 180.

static constexpr double	hptoftlbssec = 550.0

static constexpr double	psftoinhg = 0.014138

static constexpr double	psftopa = 47.88

static constexpr double	ktstofps = 1.68781

static constexpr double	fpstokts = 1.0 / ktstofps

static constexpr double	inchtoft = 1.0/12.0

static constexpr double	fttom = 0.3048

static constexpr double	m3toft3 = 1.0/(fttomfttomfttom)

static constexpr double	in3tom3 = inchtoftinchtoftinchtoft/m3toft3

static constexpr double	inhgtopa = 3386.38

static constexpr double	slugtolb = 32.174049
	Note that definition of lbtoslug by the inverse of slugtolb and not to a different constant you can also get from some tables will make lbtoslug*slugtolb == 1 up to the magnitude of roundoff.

static constexpr double	lbtoslug = 1.0/slugtolb

static constexpr double	kgtolb = 2.20462

static constexpr double	kgtoslug = 0.06852168

static const std::string	needed_cfg_version = "2.0"

static const std::string	JSBSim_version = JSBSIM_VERSION " " __DATE__ " " __TIME__

static int	gaussian_random_number_phase = 0

Detailed Description

FGPropeller models a propeller given the tabular data for Ct (thrust) and Cp (power), indexed by the advance ratio "J".

Configuration File Format

<sense> {1 | -1} </sense> 
<p_factor> {number} </p_factor>
<propeller name="{string}" version="{string}">
  <ixx> {number} </ixx>
  <diameter unit="IN"> {number} </diameter>
  <numblades> {number} </numblades>
  <gearratio> {number} </gearratio>
  <minpitch> {number} </minpitch>
  <maxpitch> {number} </maxpitch>
  <minrpm> {number} </minrpm>
  <maxrpm> {number} </maxrpm>
  <constspeed> {number} </constspeed>
  <reversepitch> {number} </reversepitch>
  <ct_factor> {number} </ct_factor>
  <cp_factor> {number} </cp_factor>
 
  <table name="C_THRUST" type="internal">
    <tableData>
      {numbers}
    </tableData>
  </table>
 
  <table name="C_POWER" type="internal">
    <tableData>
      {numbers}
    </tableData>
  </table>
 
  <table name="CT_MACH" type="internal">
    <tableData>
      {numbers}
    </tableData>
  </table>
 
  <table name="CP_MACH" type="internal">
    <tableData>
      {numbers}
    </tableData>
  </table>
 
</propeller>

Configuration Parameters

    <ixx>           - Propeller rotational inertia.
    <diameter>      - Propeller disk diameter.
    <numblades>     - Number of blades.
    <gearratio>     - Ratio of (engine rpm) / (prop rpm).
    <minpitch>      - Minimum blade pitch angle.
    <maxpitch>      - Maximum blade pitch angle.
    <minrpm>        - Minimum rpm target for constant speed propeller.
    <maxrpm>        - Maximum rpm target for constant speed propeller.
    <constspeed>    - 1 = constant speed mode, 0 = manual pitch mode. 
    <reversepitch>  - Blade pitch angle for reverse.
    <sense>         - Direction of rotation (1=clockwise as viewed from cockpit,
                        -1=anti-clockwise as viewed from cockpit). Sense is
                       specified in the parent tag of the propeller.
    <p_factor>      - P factor. It is specified in the parent tag of
                       the propeller.
    <ct_factor>     - A multiplier for the coefficients of thrust.
    <cp_factor>     - A multiplier for the coefficients of power.

Two tables are needed. One for coefficient of thrust (Ct) and one for coefficient of power (Cp).

Two tables are optional. They apply a factor to Ct and Cp based on the helical tip Mach.

The parameters <sense> and <p_factor> must be specified at the parent level i.e. in the <thruster> element. This allows to specify different sense and P factor values for each propeller of the model while using the same definition file for all the propellers.

In addition to thrust, the propeller applies two moments to the aircraft:

The torque that tends to roll the aircraft in the direction opposite to the propeller rotation,
and the gyroscopic moment.

It should be noted that historically the gyroscopic moment had an incorrect sign. The correct sign can be obtained by specifying a version attribute higher than 1.0 to the propeller definition

<propeller name="a_prop" version="1.1">
  <!-- propeller definition -->
</propeller>

For backward compatibility, the absence of the version attribute will result in the gyroscopic moment to be computed with the legacy incorrect sign.

Several references were helpful, here:

Barnes W. McCormick, "Aerodynamics, Aeronautics, and Flight Mechanics", Wiley & Sons, 1979 ISBN 0-471-03032-5
Edwin Hartman, David Biermann, "The Aerodynamic Characteristics of Full Scale Propellers Having 2, 3, and 4 Blades of Clark Y and R.A.F. 6 Airfoil Sections", NACA Report TN-640, 1938 (?)
Various NACA Technical Notes and Reports

Author: Jon S. Berndt

See also: FGEngine; FGThruster

Definition at line 169 of file FGPropeller.h.

Constructor & Destructor Documentation

◆ FGPropeller()

JSBSim::FGPropeller::FGPropeller	(	FGFDMExec *	exec,
		Element *	el,
		int	num = 0 )

Constructor for FGPropeller.

Parameters

exec	a pointer to the main executive object
el	a pointer to the thruster config file XML element
num	the number of this propeller

Definition at line 54 of file FGPropeller.cpp.

◆ ~FGPropeller()

JSBSim::FGPropeller::~FGPropeller ( )

Destructor for FGPropeller - deletes the FGTable objects.

Definition at line 179 of file FGPropeller.cpp.

Member Function Documentation

◆ Calculate()

double JSBSim::FGPropeller::Calculate ( double EnginePower )

virtual

Calculates and returns the thrust produced by this propeller.

Given the excess power available from the engine (in foot-pounds), the thrust is calculated, as well as the current RPM. The RPM is calculated by integrating the torque provided by the engine over what the propeller "absorbs" (essentially the "drag" of the propeller).

Parameters

PowerAvailable this is the excess power provided by the engine to accelerate the prop. It could be negative, dictating that the propeller would be slowed.

Returns: the thrust in pounds

Reimplemented from JSBSim::FGThruster.

Definition at line 208 of file FGPropeller.cpp.

◆ GetConstantSpeed()

int JSBSim::FGPropeller::GetConstantSpeed ( void ) const

inline

Returns a non-zero value if the propeller is constant speed.

Definition at line 305 of file FGPropeller.h.

◆ GetCpFactor()

double JSBSim::FGPropeller::GetCpFactor ( void ) const

inline

Retrieves the coefficient of power multiplier.

Definition at line 247 of file FGPropeller.h.

◆ GetCpMachTable()

FGTable * JSBSim::FGPropeller::GetCpMachTable ( void ) const

inline

Retrieves propeller power Mach effects factor.

Definition at line 260 of file FGPropeller.h.

◆ GetCPowerTable()

FGTable * JSBSim::FGPropeller::GetCPowerTable ( void ) const

inline

Retrieves propeller power table.

Definition at line 255 of file FGPropeller.h.

◆ GetCtFactor()

double JSBSim::FGPropeller::GetCtFactor ( void ) const

inline

Retrieves the coefficient of thrust multiplier.

Definition at line 244 of file FGPropeller.h.

◆ GetCThrustTable()

FGTable * JSBSim::FGPropeller::GetCThrustTable ( void ) const

inline

Retrieves propeller thrust table.

Definition at line 253 of file FGPropeller.h.

◆ GetCtMachTable()

FGTable * JSBSim::FGPropeller::GetCtMachTable ( void ) const

inline

Retrieves propeller thrust Mach effects factor.

Definition at line 258 of file FGPropeller.h.

◆ GetDiameter()

double JSBSim::FGPropeller::GetDiameter ( void ) const

inline

Retrieves the propeller diameter.

Definition at line 250 of file FGPropeller.h.

◆ GetEngineRPM()

double JSBSim::FGPropeller::GetEngineRPM ( void ) const

inlinevirtual

Calculates the RPMs of the engine based on gear ratio.

Reimplemented from JSBSim::FGThruster.

Definition at line 238 of file FGPropeller.h.

◆ GetFeather()

bool JSBSim::FGPropeller::GetFeather ( void ) const

inline

Returns true if the propeller is in feathered position.

Definition at line 299 of file FGPropeller.h.

◆ GetHelicalTipMach()

double JSBSim::FGPropeller::GetHelicalTipMach ( void ) const

inline

Retrieves the Mach number at the propeller tips.

Definition at line 303 of file FGPropeller.h.

◆ GetInducedVelocity()

double JSBSim::FGPropeller::GetInducedVelocity ( void ) const

inline

Get the propeller induced velocity.

Definition at line 309 of file FGPropeller.h.

◆ GetIxx()

double JSBSim::FGPropeller::GetIxx ( void ) const

inline

Retrieves the propeller moment of inertia.

Definition at line 241 of file FGPropeller.h.

◆ GetPFactor()

FGColumnVector3 JSBSim::FGPropeller::GetPFactor ( void ) const

Retrieves the P-Factor constant.

Definition at line 372 of file FGPropeller.cpp.

◆ GetPitch()

double JSBSim::FGPropeller::GetPitch ( void ) const

inline

Retrieves the pitch of the propeller in degrees.

Definition at line 232 of file FGPropeller.h.

◆ GetPowerRequired()

double JSBSim::FGPropeller::GetPowerRequired ( void )

virtual

Retrieves the power required (or "absorbed") by the propeller - i.e.

the power required to keep spinning the propeller at the current velocity, air density, and rotational rate.

Reimplemented from JSBSim::FGThruster.

Definition at line 303 of file FGPropeller.cpp.

◆ GetReverse()

bool JSBSim::FGPropeller::GetReverse ( void ) const

inline

Returns true if the propeller is in reverse position.

Definition at line 295 of file FGPropeller.h.

◆ GetReverseCoef()

double JSBSim::FGPropeller::GetReverseCoef ( void ) const

inline

Retrieves the reverse pitch command.

Definition at line 291 of file FGPropeller.h.

◆ GetRPM()

double JSBSim::FGPropeller::GetRPM ( void ) const

inlinevirtual

Retrieves the RPMs of the propeller.

Reimplemented from JSBSim::FGThruster.

Definition at line 235 of file FGPropeller.h.

◆ GetThrustCoefficient()

double JSBSim::FGPropeller::GetThrustCoefficient ( void ) const

inline

Retrieves the thrust coefficient.

Definition at line 301 of file FGPropeller.h.

◆ GetThrusterLabels()

string JSBSim::FGPropeller::GetThrusterLabels	(	int	id,
		const std::string &	delimeter )

virtual

Generate the labels for the thruster standard CSV output.

Reimplemented from JSBSim::FGThruster.

Definition at line 385 of file FGPropeller.cpp.

◆ GetThrusterValues()

string JSBSim::FGPropeller::GetThrusterValues	(	int	id,
		const std::string &	delimeter )

virtual

Generate the values for the thruster standard CSV output.

Reimplemented from JSBSim::FGThruster.

Definition at line 402 of file FGPropeller.cpp.

◆ GetTorque()

double JSBSim::FGPropeller::GetTorque ( void ) const

inline

Retrieves the Torque in foot-pounds (Don't you love the English system?)

Definition at line 263 of file FGPropeller.h.

◆ IsVPitch()

bool JSBSim::FGPropeller::IsVPitch ( void ) const

inline

Returns true of this propeller is variable pitch.

Definition at line 197 of file FGPropeller.h.

◆ ResetToIC()

void JSBSim::FGPropeller::ResetToIC ( void )

virtual

Reset the initial conditions.

Reimplemented from JSBSim::FGThruster.

Definition at line 191 of file FGPropeller.cpp.

◆ SetAdvance()

void JSBSim::FGPropeller::SetAdvance ( double advance )

inline

Set the propeller pitch.

Parameters

advance the pitch command in percent (0.0 - 1.0)

Definition at line 211 of file FGPropeller.h.

◆ SetConstantSpeed()

void JSBSim::FGPropeller::SetConstantSpeed ( int mode )

inline

Sets propeller into constant speed mode, or manual pitch mode.

Definition at line 217 of file FGPropeller.h.

◆ SetCpFactor()

void JSBSim::FGPropeller::SetCpFactor ( double cpf )

inline

Sets coefficient of power multiplier.

Definition at line 223 of file FGPropeller.h.

◆ SetCtFactor()

void JSBSim::FGPropeller::SetCtFactor ( double ctf )

inline

Sets coefficient of thrust multiplier.

Definition at line 220 of file FGPropeller.h.

◆ SetEngineRPM()

void JSBSim::FGPropeller::SetEngineRPM ( double rpm )

inlinevirtual

Sets the Revolutions Per Minute for the propeller using the engine gear ratio.

Reimplemented from JSBSim::FGThruster.

Definition at line 194 of file FGPropeller.h.

◆ SetFeather()

void JSBSim::FGPropeller::SetFeather ( bool f )

inline

If true, sets the propeller in feathered position.

Definition at line 297 of file FGPropeller.h.

◆ SetInducedVelocity()

void JSBSim::FGPropeller::SetInducedVelocity ( double Vi )

inline

Set the propeller induced velocity.

Definition at line 307 of file FGPropeller.h.

◆ SetPFactor()

void JSBSim::FGPropeller::SetPFactor ( double pf )

inline

Sets the P-Factor constant.

Definition at line 214 of file FGPropeller.h.

◆ SetPitch()

void JSBSim::FGPropeller::SetPitch ( double pitch )

inline

This commands the pitch of the blade to change to the value supplied.

This call is meant to be issued either from the cockpit or by the flight control system (perhaps to maintain constant RPM for a constant-speed propeller). This value will be limited to be within whatever is specified in the config file for Max and Min pitch. It is also one of the lookup indices to the power and thrust tables for variable-pitch propellers.

Parameters

pitch the pitch of the blade in degrees.

Definition at line 206 of file FGPropeller.h.

◆ SetReverse()

void JSBSim::FGPropeller::SetReverse ( bool r )

inline

If true, sets the propeller in reversed position.

Definition at line 293 of file FGPropeller.h.

◆ SetReverseCoef()

void JSBSim::FGPropeller::SetReverseCoef ( double c )

inline

Set the propeller reverse pitch.

Parameters

c	the reverse pitch command in percent (0.0 - 1.0)

Definition at line 289 of file FGPropeller.h.

◆ SetRPM()

void JSBSim::FGPropeller::SetRPM ( double rpm )

inlinevirtual

Sets the Revolutions Per Minute for the propeller.

Normally the propeller instance will calculate its own rotational velocity, given the Torque produced by the engine and integrating over time using the standard equation for rotational acceleration $a$ : $a = Q/I$ , where $Q$ is Torque and $I$ is moment of inertia for the propeller.

Parameters

rpm	the rotational velocity of the propeller

Reimplemented from JSBSim::FGThruster.

Definition at line 190 of file FGPropeller.h.

◆ SetSense()

void JSBSim::FGPropeller::SetSense ( double s )

inline

Sets the rotation sense of the propeller.

Parameters

s	this value should be +/- 1 ONLY. +1 indicates clockwise rotation as viewed by someone standing behind the engine looking forward into the direction of flight.

Definition at line 229 of file FGPropeller.h.

The documentation for this class was generated from the following files:

Public Member Functions

Additional Inherited Members

Detailed Description

Configuration File Format

Configuration Parameters

Constructor & Destructor Documentation

◆ FGPropeller()

◆ ~FGPropeller()

Member Function Documentation

◆ Calculate()

◆ GetConstantSpeed()

◆ GetCpFactor()

◆ GetCpMachTable()

◆ GetCPowerTable()

◆ GetCtFactor()

◆ GetCThrustTable()

◆ GetCtMachTable()

◆ GetDiameter()

◆ GetEngineRPM()

◆ GetFeather()

◆ GetHelicalTipMach()

◆ GetInducedVelocity()

◆ GetIxx()

◆ GetPFactor()

◆ GetPitch()

◆ GetPowerRequired()

◆ GetReverse()

◆ GetReverseCoef()

◆ GetRPM()

◆ GetThrustCoefficient()

◆ GetThrusterLabels()

◆ GetThrusterValues()

◆ GetTorque()

◆ IsVPitch()

◆ ResetToIC()

◆ SetAdvance()

◆ SetConstantSpeed()

◆ SetCpFactor()

◆ SetCtFactor()

◆ SetEngineRPM()

◆ SetFeather()

◆ SetInducedVelocity()

◆ SetPFactor()

◆ SetPitch()

◆ SetReverse()

◆ SetReverseCoef()

◆ SetRPM()

◆ SetSense()