FGAerodynamics Class Reference

#include <FGAerodynamics.h>

Inherits FGModel, and FGXMLFileRead.

List of all members.

---

Detailed Description

This class owns and contains the list of force/coefficients that define the aerodynamic properties of an aircraft. Here also, such unique phenomena as ground effect, aerodynamic reference point shift, and maximum lift curve tailoff are handled.

    <aerodynamics>
       <alphalimits unit="{RAD | DEG}">
         <min> {number} </min>
         <max> {number} </max>
       </alphalimits>
       <hysteresis_limits unit="{RAD | DEG}">
         <min> {number} </min>
         <max> {number} </max>
       </hysteresis_limits>
       <aero_ref_pt_shift_x>  
         <function>
           {function contents}
         </function> 
       </aero_ref_pt_shift_x>  
       <function>
         {function contents}
       </function>
       <axis name="{LIFT | DRAG | SIDE | ROLL | PITCH | YAW}">
         {force coefficient definitions}
       </axis>
       {additional axis definitions}
    </aerodynamics>

Optionally two other coordinate systems may be used.

1) Body coordinate system:

       <axis name="{X | Y | Z}">

2) Axial-Normal coordinate system:

       <axis name="{AXIAL | NORMAL}">

Systems may NOT be combined, or a load error will occur.

Author:

Jon S. Berndt, Tony Peden

Version:

Revision

1.16

Definition at line 118 of file FGAerodynamics.h.

Public Member Functions
	FGAerodynamics (FGFDMExec *Executive)
	Constructor.
double	GetAlphaCLMax (void) const
double	GetAlphaCLMin (void) const
double	GetAlphaW (void) const
double	GetBI2Vel (void) const
double	GetCI2Vel (void) const
double	GetClSquared (void) const
	Retrieves the square of the lift coefficient.
vector< FGFunction * > *	GetCoeff (void) const
string	GetCoefficientStrings (string delimeter)
	Gets the strings for the current set of coefficients.
string	GetCoefficientValues (string delimeter)
	Gets the coefficient values.
double	GetForces (int n) const
	Gets the aerodynamic force for an axis.
FGColumnVector3 &	GetForces (void)
	Gets the total aerodynamic force vector.
double	GetHysteresisParm (void) const
double	GetLoD (void) const
	Retrieves the lift over drag ratio.
double	GetMoments (int n) const
	Gets the aerodynamic moment for an axis.
FGColumnVector3 &	GetMoments (void)
	Gets the total aerodynamic moment vector.
double	GetStallWarn (void) const
FGMatrix33 &	GetTb2w (void)
	Calculates and returns the body-to-wind axis transformation matrix.
FGMatrix33 &	GetTw2b (void)
	Calculates and returns the wind-to-body axis transformation matrix.
double	GetvFw (int axis) const
	Retrieves the aerodynamic forces in the wind axes, given an axis.
FGColumnVector3 &	GetvFw (void)
	Retrieves the aerodynamic forces in the wind axes.
bool	InitModel (void)
bool	Load (Element *element)
	Loads the Aerodynamics model.
bool	Run (void)
	Runs the Aerodynamics model; called by the Executive.
void	SetAlphaCLMax (double tt)
void	SetAlphaCLMin (double tt)
	~FGAerodynamics ()
	Destructor.

---

Constructor & Destructor Documentation

FGAerodynamics

(

FGFDMExec *

Executive

)

Parameters:

Executive

a pointer to the parent executive object

Definition at line 57 of file FGAerodynamics.cpp.

---

Member Function Documentation

double GetClSquared

(

void

)

const [inline]

Definition at line 174 of file FGAerodynamics.h.

string GetCoefficientStrings

(

string

delimeter

)

Parameters:

delimeter

either a tab or comma string depending on output type

Returns:

a string containing the descriptive names for all coefficients

Definition at line 416 of file FGAerodynamics.cpp.

string GetCoefficientValues

(

string

delimeter

)

Parameters:

delimeter

either a tab or comma string depending on output type

Returns:

a string containing the numeric values for the current set of coefficients

Definition at line 446 of file FGAerodynamics.cpp.

double GetForces

(

int

n

)

const [inline]

Parameters:

n

Axis index. This could be 0, 1, or 2, or one of the axis enums: eX, eY, eZ.

Returns:

the force acting on an axis

Definition at line 149 of file FGAerodynamics.h.

FGColumnVector3& GetForces

(

void

)

[inline]

Returns:

a force vector reference.

Definition at line 143 of file FGAerodynamics.h.

double GetMoments

(

int

n

)

const [inline]

Returns:

the moment about a single axis (as described also in the similar call to GetForces(int n).

Definition at line 158 of file FGAerodynamics.h.

FGColumnVector3& GetMoments

(

void

)

[inline]

Returns:

a moment vector reference.

Definition at line 153 of file FGAerodynamics.h.

FGMatrix33 & GetTb2w

(

void

)

Returns:

a reference to the wind-to-body transformation matrix.

Definition at line 276 of file FGAerodynamics.cpp.

FGMatrix33 & GetTw2b

(

void

)

Returns:

a reference to the wind-to-body transformation matrix.

Definition at line 249 of file FGAerodynamics.cpp.

double GetvFw

(

int

axis

)

const [inline]

Parameters:

axis

the axis to return the force for (eX, eY, eZ).

Returns:

a reference to a column vector containing the requested wind axis force.

Definition at line 168 of file FGAerodynamics.h.

FGColumnVector3& GetvFw

(

void

)

[inline]

Returns:

a reference to a column vector containing the wind axis forces.

Definition at line 162 of file FGAerodynamics.h.

bool Load

(

Element *

element

)

[virtual]

The Load function for this class expects the XML parser to have found the aerodynamics keyword in the configuration file.

Parameters:

element

pointer to the current XML element for aerodynamics parameters.

Returns:

true if successful

Reimplemented from FGModel.

Definition at line 304 of file FGAerodynamics.cpp.

bool Run

(

void

)

[virtual]

Returns:

false if no error

Reimplemented from FGModel.

Definition at line 132 of file FGAerodynamics.cpp.

---

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

• FGAerodynamics.h
• FGAerodynamics.cpp