Detailed Description

Initializes the simulation run.

Takes a set of initial conditions (IC) and provide a kinematically consistent set of body axis velocity components, euler angles, and altitude. This class does not attempt to trim the model i.e. the sim will most likely start in a very dynamic state (unless, of course, you have chosen your IC's wisely, or started on the ground) even after setting it up with this class.

Usage Notes

With a valid object of FGFDMExec and an aircraft model loaded:

FGInitialCondition* fgic = FDMExec->GetIC();
 
// Reset the initial conditions and set VCAS and altitude
fgic->InitializeIC();
fgic->SetVcalibratedKtsIC(vcas);
fgic->SetAltitudeAGLFtIC(altitude);
 
// directly into Run
FDMExec->GetPropagate()->SetInitialState(fgic);
delete fgic;
FDMExec->Run();
 
//or to loop the sim w/o integrating
FDMExec->RunIC();

Alternatively, you can load initial conditions from an XML file:

FGInitialCondition* fgic = FDMExec->GetIC();

fgic->Load(IC_file);

JSBSim::FGInitialCondition::Load

bool Load(const SGPath &rstname, bool useAircraftPath=true)

Loads the initial conditions.

Definition FGInitialCondition.cpp:1009

Speed

Since vc, ve, vt, and mach all represent speed, the remaining three are recalculated each time one of them is set (using the current altitude). The most recent speed set is remembered so that if and when altitude is reset, the last set speed is used to recalculate the remaining three. Setting any of the body components forces a recalculation of vt and vt then becomes the most recent speed set.

Alpha,Gamma, and Theta

This class assumes that it will be used to set up the sim for a steady, zero pitch rate condition. Since any two of those angles specifies the third gamma (flight path angle) is favored when setting alpha and theta and alpha is favored when setting gamma. i.e.

set alpha : recalculate theta using gamma as currently set
set theta : recalculate alpha using gamma as currently set
set gamma : recalculate theta using alpha as currently set

The idea being that gamma is most interesting to pilots (since it is indicative of climb rate).

Setting climb rate is, for the purpose of this discussion, considered equivalent to setting gamma.

These are the items that can be set in an initialization file:

ubody (velocity, ft/sec)
vbody (velocity, ft/sec)
wbody (velocity, ft/sec)
vnorth (velocity, ft/sec)
veast (velocity, ft/sec)
vdown (velocity, ft/sec)
latitude (position, degrees)
longitude (position, degrees)
phi (orientation, degrees)
theta (orientation, degrees)
psi (orientation, degrees)
alpha (angle, degrees)
beta (angle, degrees)
gamma (angle, degrees)
roc (vertical velocity, ft/sec)
elevation (local terrain elevation, ft)
altitude (altitude AGL, ft)
altitudeAGL (altitude AGL, ft)
altitudeMSL (altitude MSL, ft)
winddir (wind from-angle, degrees)
vwind (magnitude wind speed, ft/sec)
hwind (headwind speed, knots)
xwind (crosswind speed, knots)
vc (calibrated airspeed, ft/sec)
mach (mach)
vground (ground speed, ft/sec)
trim (0 for no trim, 1 for ground trim, 'Longitudinal', 'Full', 'Ground', 'Pullup', 'Custom', 'Turn')
running (-1 for all engines, 0 ... n-1 for specific engines)

Properties

ic/vc-kts (read/write) Calibrated airspeed initial condition in knots
ic/ve-kts (read/write) Knots equivalent airspeed initial condition
ic/vg-kts (read/write) Ground speed initial condition in knots
ic/vt-kts (read/write) True airspeed initial condition in knots
ic/mach (read/write) Mach initial condition
ic/roc-fpm (read/write) Rate of climb initial condition in feet/minute
ic/gamma-deg (read/write) Flightpath angle initial condition in degrees
ic/alpha-deg (read/write) Angle of attack initial condition in degrees
ic/beta-deg (read/write) Angle of sideslip initial condition in degrees
ic/theta-deg (read/write) Pitch angle initial condition in degrees
ic/phi-deg (read/write) Roll angle initial condition in degrees
ic/psi-true-deg (read/write) Heading angle initial condition in degrees
ic/lat-gc-deg (read/write) Latitude initial condition in degrees
ic/long-gc-deg (read/write) Longitude initial condition in degrees
ic/h-sl-ft (read/write) Height above sea level initial condition in feet
ic/h-agl-ft (read/write) Height above ground level initial condition in feet
ic/sea-level-radius-ft (read/write) Radius of planet at sea level in feet
ic/terrain-elevation-ft (read/write) Terrain elevation above sea level in feet
ic/vg-fps (read/write) Ground speed initial condition in feet/second
ic/vt-fps (read/write) True airspeed initial condition in feet/second
ic/vw-bx-fps (read/write) Wind velocity initial condition in Body X frame in feet/second
ic/vw-by-fps (read/write) Wind velocity initial condition in Body Y frame in feet/second
ic/vw-bz-fps (read/write) Wind velocity initial condition in Body Z frame in feet/second
ic/vw-north-fps (read/write) Wind northward velocity initial condition in feet/second
ic/vw-east-fps (read/write) Wind eastward velocity initial condition in feet/second
ic/vw-down-fps (read/write) Wind downward velocity initial condition in feet/second
ic/vw-mag-fps (read/write) Wind velocity magnitude initial condition in feet/sec.
ic/vw-dir-deg (read/write) Wind direction initial condition, in degrees from north
ic/roc-fps (read/write) Rate of climb initial condition, in feet/second
ic/u-fps (read/write) Body frame x-axis velocity initial condition in feet/second
ic/v-fps (read/write) Body frame y-axis velocity initial condition in feet/second
ic/w-fps (read/write) Body frame z-axis velocity initial condition in feet/second
ic/vn-fps (read/write) Local frame x-axis (north) velocity initial condition in feet/second
ic/ve-fps (read/write) Local frame y-axis (east) velocity initial condition in feet/second
ic/vd-fps (read/write) Local frame z-axis (down) velocity initial condition in feet/second
ic/gamma-rad (read/write) Flight path angle initial condition in radians
ic/alpha-rad (read/write) Angle of attack initial condition in radians
ic/theta-rad (read/write) Pitch angle initial condition in radians
ic/beta-rad (read/write) Angle of sideslip initial condition in radians
ic/phi-rad (read/write) Roll angle initial condition in radians
ic/psi-true-rad (read/write) Heading angle initial condition in radians
ic/lat-gc-rad (read/write) Geocentric latitude initial condition in radians
ic/long-gc-rad (read/write) Longitude initial condition in radians
ic/p-rad_sec (read/write) Roll rate initial condition in radians/second
ic/q-rad_sec (read/write) Pitch rate initial condition in radians/second
ic/r-rad_sec (read/write) Yaw rate initial condition in radians/second

Author: Tony Peden

Definition at line 226 of file FGInitialCondition.h.

#include <FGInitialCondition.h>

Inheritance diagram for FGInitialCondition:

Collaboration diagram for FGInitialCondition:

Public Member Functions
	FGInitialCondition (FGFDMExec *fdmex)
	Constructor.

	~FGInitialCondition ()
	Destructor.

void	bind (FGPropertyManager *pm)

double	GetAlphaDegIC (void) const
	Gets the initial angle of attack.

double	GetAlphaRadIC (void) const
	Gets the initial angle of attack.

double	GetAltitudeAGLFtIC (void) const
	Gets the initial altitude above ground level.

double	GetAltitudeASLFtIC (void) const
	Gets the initial altitude above sea level.

double	GetBetaDegIC (void) const
	Gets the initial sideslip angle.

double	GetBetaRadIC (void) const
	Gets the initial angle of sideslip.

double	GetClimbRateFpmIC (void) const
	Gets the initial climb rate.

double	GetClimbRateFpsIC (void) const
	Gets the initial climb rate.

double	GetEarthPositionAngleIC (void) const
	Gets the initial Earth position angle.

double	GetFlightPathAngleDegIC (void) const
	Gets the initial flight path angle.

double	GetFlightPathAngleRadIC (void) const
	Gets the initial flight path angle.

double	GetGeodLatitudeDegIC (void) const
	Gets the initial geodetic latitude.

double	GetGeodLatitudeRadIC (void) const
	Gets the initial geodetic latitude.

double	GetLatitudeDegIC (void) const
	Gets the initial latitude.

double	GetLatitudeRadIC (void) const
	Gets the initial latitude.

double	GetLongitudeDegIC (void) const
	Gets the initial longitude.

double	GetLongitudeRadIC (void) const
	Gets the initial longitude.

double	GetMachIC (void) const
	Gets the initial mach.

const FGQuaternion &	GetOrientation (void) const
	Gets the initial orientation.

double	GetPhiDegIC (void) const
	Gets the initial roll angle.

double	GetPhiRadIC (void) const
	Gets the initial roll angle.

const FGLocation &	GetPosition (void) const
	Gets the initial position.

const FGColumnVector3	GetPQRRadpsIC (void) const
	Gets the initial body rotation rate.

double	GetPRadpsIC () const
	Gets the initial body axis roll rate.

double	GetPsiDegIC (void) const
	Gets the initial heading angle.

double	GetPsiRadIC (void) const
	Gets the initial heading angle.

double	GetQRadpsIC () const
	Gets the initial body axis pitch rate.

double	GetRRadpsIC () const
	Gets the initial body axis yaw rate.

speedset	GetSpeedSet (void) const
	Gets the initial speedset.

double	GetTargetNlfIC (void) const
	Gets the target normal load factor set from IC.

double	GetTerrainElevationFtIC (void) const
	Gets the initial terrain elevation.

double	GetThetaDegIC (void) const
	Gets the initial pitch angle.

double	GetThetaRadIC (void) const
	Gets the initial pitch angle.

double	GetUBodyFpsIC (void) const
	Gets the initial body axis X velocity.

const FGColumnVector3	GetUVWFpsIC (void) const
	Gets the initial body velocity.

double	GetVBodyFpsIC (void) const
	Gets the initial body axis Y velocity.

double	GetVcalibratedKtsIC (void) const
	Gets the initial calibrated airspeed.

double	GetVDownFpsIC (void) const
	Gets the initial local frame Z (Down) velocity.

double	GetVEastFpsIC (void) const
	Gets the initial local frame Y (East) velocity.

double	GetVequivalentKtsIC (void) const
	Gets the initial equivalent airspeed.

double	GetVgroundFpsIC (void) const
	Gets the initial ground velocity.

double	GetVgroundKtsIC (void) const
	Gets the initial ground speed.

double	GetVNorthFpsIC (void) const
	Gets the initial local frame X (North) velocity.

double	GetVtrueFpsIC (void) const
	Gets the initial true velocity.

double	GetVtrueKtsIC (void) const
	Gets the initial true velocity.

double	GetWBodyFpsIC (void) const
	Gets the initial body axis Z velocity.

double	GetWindDFpsIC (void) const
	Gets the initial wind velocity in local frame.

double	GetWindDirDegIC (void) const
	Gets the initial wind direction.

double	GetWindEFpsIC (void) const
	Gets the initial wind velocity in local frame.

double	GetWindMagFpsIC (void) const
	Gets the initial total wind velocity in feet/sec.

FGColumnVector3	GetWindNEDFpsIC (void) const
	Gets the initial wind velocity in the NED local frame.

double	GetWindNFpsIC (void) const
	Gets the initial wind velocity in local frame.

double	GetWindUFpsIC (void) const
	Gets the initial body axis X wind velocity.

double	GetWindVFpsIC (void) const
	Gets the initial body axis Y wind velocity.

double	GetWindWFpsIC (void) const
	Gets the initial body axis Z wind velocity.

void	InitializeIC (void)
	Initialize the initial conditions to default values.

bool	IsEngineRunning (unsigned int n) const
	Is an engine running ?

bool	Load (const SGPath &rstname, bool useAircraftPath=true)
	Loads the initial conditions.

void	ResetIC (double u0, double v0, double w0, double p0, double q0, double r0, double alpha0, double beta0, double phi0, double theta0, double psi0, double latitudeRad0, double longitudeRad0, double altitudeAGL0, double gamma0)
	Resets the IC data structure to new values.

void	SetAlphaDegIC (double a)
	Sets angle of attack initial condition in degrees.

void	SetAlphaRadIC (double alpha)
	Sets the initial angle of attack.

void	SetAltitudeAGLFtIC (double agl)
	Sets the initial Altitude above ground level.

void	SetAltitudeASLFtIC (double altitudeASL)
	Sets the altitude above sea level initial condition in feet.

void	SetBetaDegIC (double b)
	Sets angle of sideslip initial condition in degrees.

void	SetBetaRadIC (double beta)
	Sets the initial sideslip angle.

void	SetClimbRateFpmIC (double roc)
	Sets the climb rate initial condition in feet/minute.

void	SetClimbRateFpsIC (double roc)
	Sets the initial climb rate.

void	SetCrossWindKtsIC (double cross)
	Sets the initial crosswind speed.

void	SetFlightPathAngleDegIC (double gamma)
	Sets the flight path angle initial condition in degrees.

void	SetFlightPathAngleRadIC (double gamma)
	Sets the initial flight path angle.

void	SetGeodLatitudeDegIC (double glat)
	Sets the initial geodetic latitude.

void	SetGeodLatitudeRadIC (double glat)
	Sets the initial geodetic latitude.

void	SetHeadWindKtsIC (double head)
	Sets the initial headwind velocity.

void	SetLatitudeDegIC (double lat)
	Sets the initial latitude.

void	SetLatitudeRadIC (double lat)
	Sets the initial latitude.

void	SetLongitudeDegIC (double lon)
	Sets the initial longitude.

void	SetLongitudeRadIC (double lon)
	Sets the initial longitude.

void	SetMachIC (double mach)
	Set mach initial condition.

void	SetPhiDegIC (double phi)
	Sets the roll angle initial condition in degrees.

void	SetPhiRadIC (double phi)
	Sets the initial roll angle.

void	SetPRadpsIC (double P)
	Sets the initial body axis roll rate.

void	SetPsiDegIC (double psi)
	Sets the heading angle initial condition in degrees.

void	SetPsiRadIC (double psi)
	Sets the initial heading angle.

void	SetQRadpsIC (double Q)
	Sets the initial body axis pitch rate.

void	SetRRadpsIC (double R)
	Sets the initial body axis yaw rate.

void	SetTargetNlfIC (double nlf)
	Sets the target normal load factor.

void	SetTerrainElevationFtIC (double elev)
	Sets the initial terrain elevation.

void	SetThetaDegIC (double theta)
	Sets pitch angle initial condition in degrees.

void	SetThetaRadIC (double theta)
	Sets the initial pitch angle.

void	SetUBodyFpsIC (double ubody)
	Sets the initial body axis X velocity.

void	SetVBodyFpsIC (double vbody)
	Sets the initial body axis Y velocity.

void	SetVcalibratedKtsIC (double vc)
	Set calibrated airspeed initial condition in knots.

void	SetVDownFpsIC (double vd)
	Sets the initial local axis down velocity.

void	SetVEastFpsIC (double ve)
	Sets the initial local axis east velocity.

void	SetVequivalentKtsIC (double ve)
	Set equivalent airspeed initial condition in knots.

void	SetVgroundFpsIC (double vg)
	Sets the initial ground speed.

void	SetVgroundKtsIC (double vg)
	Set ground speed initial condition in knots.

void	SetVNorthFpsIC (double vn)
	Sets the initial local axis north velocity.

void	SetVtrueFpsIC (double vt)
	Sets the initial true airspeed.

void	SetVtrueKtsIC (double vtrue)
	Set true airspeed initial condition in knots.

void	SetWBodyFpsIC (double wbody)
	Sets the initial body axis Z velocity.

void	SetWindDirDegIC (double dir)
	Sets the initial wind direction.

void	SetWindDownKtsIC (double wD)
	Sets the initial wind downward speed.

void	SetWindMagFpsIC (double mag)
	Sets the initial total wind speed.

void	SetWindMagKtsIC (double mag)
	Sets the initial total wind speed.

void	SetWindNEDFpsIC (double wN, double wE, double wD)
	Sets the initial wind velocity.

int	TrimRequested (void) const
	Does initialization file call for trim ?

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

virtual	~FGJSBBase ()
	Destructor for FGJSBBase.

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

Additional Inherited Members
Public Types inherited from 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 Public Member Functions inherited from FGJSBBase
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 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 Public Attributes inherited from 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 Protected Member Functions inherited from FGJSBBase
static std::string	CreateIndexedPropertyName (const std::string &Property, int index)

Static Protected Attributes inherited from FGJSBBase
static constexpr double	radtodeg = 180. / M_PI

static constexpr double	degtorad = M_PI / 180.

static constexpr double	hptoftlbssec = 550.0

static constexpr double	psftoinhg = 0.014138

static constexpr double	psftopa = 47.88

static constexpr double	fttom = 0.3048

static constexpr double	ktstofps = 1852./(3600*fttom)

static constexpr double	fpstokts = 1.0 / ktstofps

static constexpr double	inchtoft = 1.0/12.0

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__

Constructor & Destructor Documentation

◆ FGInitialCondition()

FGInitialCondition ( FGFDMExec * fdmex )

explicit

Constructor.

Definition at line 64 of file FGInitialCondition.cpp.

                                                         : fdmex(FDMExec)
{
  InitializeIC();
 
  if(FDMExec) {
    Aircraft=fdmex->GetAircraft();
    Auxiliary=fdmex->GetAuxiliary();
  } else {
    throw BaseException("FGInitialCondition: This class requires a pointer to a valid FGFDMExec object");
  }
 
  Debug(0);
}

Here is the call graph for this function:

◆ ~FGInitialCondition()

~FGInitialCondition ( )

Destructor.

Definition at line 80 of file FGInitialCondition.cpp.

{
  Debug(1);
}

Member Function Documentation

◆ bind()

void bind ( FGPropertyManager * pm )

Definition at line 1453 of file FGInitialCondition.cpp.

{
  PropertyManager->Tie("ic/vc-kts", this,
                       &FGInitialCondition::GetVcalibratedKtsIC,
                       &FGInitialCondition::SetVcalibratedKtsIC);
  PropertyManager->Tie("ic/ve-kts", this,
                       &FGInitialCondition::GetVequivalentKtsIC,
                       &FGInitialCondition::SetVequivalentKtsIC);
  PropertyManager->Tie("ic/vg-kts", this,
                       &FGInitialCondition::GetVgroundKtsIC,
                       &FGInitialCondition::SetVgroundKtsIC);
  PropertyManager->Tie("ic/vt-kts", this,
                       &FGInitialCondition::GetVtrueKtsIC,
                       &FGInitialCondition::SetVtrueKtsIC);
  PropertyManager->Tie("ic/mach", this,
                       &FGInitialCondition::GetMachIC,
                       &FGInitialCondition::SetMachIC);
  PropertyManager->Tie("ic/roc-fpm", this,
                       &FGInitialCondition::GetClimbRateFpmIC,
                       &FGInitialCondition::SetClimbRateFpmIC);
  PropertyManager->Tie("ic/gamma-deg", this,
                       &FGInitialCondition::GetFlightPathAngleDegIC,
                       &FGInitialCondition::SetFlightPathAngleDegIC);
  PropertyManager->Tie("ic/alpha-deg", this,
                       &FGInitialCondition::GetAlphaDegIC,
                       &FGInitialCondition::SetAlphaDegIC);
  PropertyManager->Tie("ic/beta-deg", this,
                       &FGInitialCondition::GetBetaDegIC,
                       &FGInitialCondition::SetBetaDegIC);
  PropertyManager->Tie("ic/theta-deg", this,
                       &FGInitialCondition::GetThetaDegIC,
                       &FGInitialCondition::SetThetaDegIC);
  PropertyManager->Tie("ic/phi-deg", this,
                       &FGInitialCondition::GetPhiDegIC,
                       &FGInitialCondition::SetPhiDegIC);
  PropertyManager->Tie("ic/psi-true-deg", this,
                       &FGInitialCondition::GetPsiDegIC,
                       &FGInitialCondition::SetPsiDegIC);
  PropertyManager->Tie("ic/lat-gc-deg", this,
                       &FGInitialCondition::GetLatitudeDegIC,
                       &FGInitialCondition::SetLatitudeDegIC);
  PropertyManager->Tie("ic/long-gc-deg", this,
                       &FGInitialCondition::GetLongitudeDegIC,
                       &FGInitialCondition::SetLongitudeDegIC);
  PropertyManager->Tie("ic/h-sl-ft", this,
                       &FGInitialCondition::GetAltitudeASLFtIC,
                       &FGInitialCondition::SetAltitudeASLFtIC);
  PropertyManager->Tie("ic/h-agl-ft", this,
                       &FGInitialCondition::GetAltitudeAGLFtIC,
                       &FGInitialCondition::SetAltitudeAGLFtIC);
  PropertyManager->Tie("ic/terrain-elevation-ft", this,
                       &FGInitialCondition::GetTerrainElevationFtIC,
                       &FGInitialCondition::SetTerrainElevationFtIC);
  PropertyManager->Tie("ic/vg-fps", this,
                       &FGInitialCondition::GetVgroundFpsIC,
                       &FGInitialCondition::SetVgroundFpsIC);
  PropertyManager->Tie("ic/vt-fps", this,
                       &FGInitialCondition::GetVtrueFpsIC,
                       &FGInitialCondition::SetVtrueFpsIC);
  PropertyManager->Tie("ic/vw-bx-fps", this,
                       &FGInitialCondition::GetWindUFpsIC);
  PropertyManager->Tie("ic/vw-by-fps", this,
                       &FGInitialCondition::GetWindVFpsIC);
  PropertyManager->Tie("ic/vw-bz-fps", this,
                       &FGInitialCondition::GetWindWFpsIC);
  PropertyManager->Tie("ic/vw-north-fps", this,
                       &FGInitialCondition::GetWindNFpsIC);
  PropertyManager->Tie("ic/vw-east-fps", this,
                       &FGInitialCondition::GetWindEFpsIC);
  PropertyManager->Tie("ic/vw-down-fps", this,
                       &FGInitialCondition::GetWindDFpsIC);
  PropertyManager->Tie("ic/vw-mag-fps", this,
                       &FGInitialCondition::GetWindMagFpsIC,
                       &FGInitialCondition::SetWindMagFpsIC);
  PropertyManager->Tie("ic/vw-dir-deg", this,
                       &FGInitialCondition::GetWindDirDegIC,
                       &FGInitialCondition::SetWindDirDegIC);
 
  PropertyManager->Tie("ic/roc-fps", this,
                       &FGInitialCondition::GetClimbRateFpsIC,
                       &FGInitialCondition::SetClimbRateFpsIC);
  PropertyManager->Tie("ic/u-fps", this,
                       &FGInitialCondition::GetUBodyFpsIC,
                       &FGInitialCondition::SetUBodyFpsIC);
  PropertyManager->Tie("ic/v-fps", this,
                       &FGInitialCondition::GetVBodyFpsIC,
                       &FGInitialCondition::SetVBodyFpsIC);
  PropertyManager->Tie("ic/w-fps", this,
                       &FGInitialCondition::GetWBodyFpsIC,
                       &FGInitialCondition::SetWBodyFpsIC);
  PropertyManager->Tie("ic/vn-fps", this,
                       &FGInitialCondition::GetVNorthFpsIC,
                       &FGInitialCondition::SetVNorthFpsIC);
  PropertyManager->Tie("ic/ve-fps", this,
                       &FGInitialCondition::GetVEastFpsIC,
                       &FGInitialCondition::SetVEastFpsIC);
  PropertyManager->Tie("ic/vd-fps", this,
                       &FGInitialCondition::GetVDownFpsIC,
                       &FGInitialCondition::SetVDownFpsIC);
  PropertyManager->Tie("ic/gamma-rad", this,
                       &FGInitialCondition::GetFlightPathAngleRadIC,
                       &FGInitialCondition::SetFlightPathAngleRadIC);
  PropertyManager->Tie("ic/alpha-rad", this,
                       &FGInitialCondition::GetAlphaRadIC,
                       &FGInitialCondition::SetAlphaRadIC);
  PropertyManager->Tie("ic/theta-rad", this,
                       &FGInitialCondition::GetThetaRadIC,
                       &FGInitialCondition::SetThetaRadIC);
  PropertyManager->Tie("ic/beta-rad", this,
                       &FGInitialCondition::GetBetaRadIC,
                       &FGInitialCondition::SetBetaRadIC);
  PropertyManager->Tie("ic/phi-rad", this,
                       &FGInitialCondition::GetPhiRadIC,
                       &FGInitialCondition::SetPhiRadIC);
  PropertyManager->Tie("ic/psi-true-rad", this,
                       &FGInitialCondition::GetPsiRadIC,
                       &FGInitialCondition::SetPsiRadIC);
  PropertyManager->Tie("ic/lat-gc-rad", this,
                       &FGInitialCondition::GetLatitudeRadIC,
                       &FGInitialCondition::SetLatitudeRadIC);
  PropertyManager->Tie("ic/long-gc-rad", this,
                       &FGInitialCondition::GetLongitudeRadIC,
                       &FGInitialCondition::SetLongitudeRadIC);
  PropertyManager->Tie("ic/p-rad_sec", this,
                       &FGInitialCondition::GetPRadpsIC,
                       &FGInitialCondition::SetPRadpsIC);
  PropertyManager->Tie("ic/q-rad_sec", this,
                       &FGInitialCondition::GetQRadpsIC,
                       &FGInitialCondition::SetQRadpsIC);
  PropertyManager->Tie("ic/r-rad_sec", this,
                       &FGInitialCondition::GetRRadpsIC,
                       &FGInitialCondition::SetRRadpsIC);
  PropertyManager->Tie("ic/lat-geod-rad", this,
                       &FGInitialCondition::GetGeodLatitudeRadIC,
                       &FGInitialCondition::SetGeodLatitudeRadIC);
  PropertyManager->Tie("ic/lat-geod-deg", this,
                       &FGInitialCondition::GetGeodLatitudeDegIC,
                       &FGInitialCondition::SetGeodLatitudeDegIC);
  PropertyManager->Tie("ic/geod-alt-ft", &position,
                       &FGLocation::GetGeodAltitude);
 
  PropertyManager->Tie("ic/targetNlf", this,
                       &FGInitialCondition::GetTargetNlfIC,
                       &FGInitialCondition::SetTargetNlfIC);
}

◆ GetAlphaDegIC()

double GetAlphaDegIC ( void ) const

inline

Gets the initial angle of attack.

Returns: Initial alpha in degrees

Definition at line 349 of file FGInitialCondition.h.

349{ return alpha*radtodeg; }

◆ GetAlphaRadIC()

double GetAlphaRadIC ( void ) const

inline

Gets the initial angle of attack.

Returns: Initial alpha in radians

Definition at line 625 of file FGInitialCondition.h.

625{ return alpha; }

◆ GetAltitudeAGLFtIC()

double GetAltitudeAGLFtIC ( void ) const

Gets the initial altitude above ground level.

Returns: Initial altitude AGL in feet

Definition at line 664 of file FGInitialCondition.cpp.

{
  return fdmex->GetInertial()->GetAltitudeAGL(position);
}

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetAltitudeASLFtIC()

double GetAltitudeASLFtIC ( void ) const

Gets the initial altitude above sea level.

Returns: Initial altitude in feet.

Definition at line 657 of file FGInitialCondition.cpp.

{
  return position.GetRadius() - position.GetSeaLevelRadius();
}

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetBetaDegIC()

double GetBetaDegIC ( void ) const

inline

Gets the initial sideslip angle.

Returns: Initial beta in degrees

Definition at line 353 of file FGInitialCondition.h.

353{ return beta*radtodeg; }

◆ GetBetaRadIC()

double GetBetaRadIC ( void ) const

inline

Gets the initial angle of sideslip.

Returns: Initial sideslip angle in radians

Definition at line 629 of file FGInitialCondition.h.

629{ return beta; }

◆ GetClimbRateFpmIC()

double GetClimbRateFpmIC ( void ) const

inline

Gets the initial climb rate.

Returns: Initial climb rate in feet/minute

Definition at line 339 of file FGInitialCondition.h.

340 { return GetClimbRateFpsIC()*60; }

◆ GetClimbRateFpsIC()

double GetClimbRateFpsIC ( void ) const

inline

Gets the initial climb rate.

Returns: Initial rate of climb in feet/second

Definition at line 520 of file FGInitialCondition.h.

  {
    const FGMatrix33& Tb2l = orientation.GetTInv();
    FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
    return -_vt_NED(eW);
  }

◆ GetEarthPositionAngleIC()

double GetEarthPositionAngleIC ( void ) const

inline

Gets the initial Earth position angle.

Returns: Initial Earth position angle in radians.

Definition at line 394 of file FGInitialCondition.h.

394{ return epa; }

◆ GetFlightPathAngleDegIC()

double GetFlightPathAngleDegIC ( void ) const

inline

Gets the initial flight path angle.

Returns: Initial flight path angle in degrees

Definition at line 344 of file FGInitialCondition.h.

345 { return GetFlightPathAngleRadIC()*radtodeg; }

◆ GetFlightPathAngleRadIC()

double GetFlightPathAngleRadIC ( void ) const

inline

Gets the initial flight path angle.

If total velocity is zero, this function returns zero.

Returns: Initial flight path angle in radians

Definition at line 620 of file FGInitialCondition.h.

621 { return (vt == 0.0)?0.0:asin(GetClimbRateFpsIC() / vt); }

◆ GetGeodLatitudeDegIC()

double GetGeodLatitudeDegIC ( void ) const

inline

Gets the initial geodetic latitude.

Returns: Initial geodetic latitude in degrees

Definition at line 373 of file FGInitialCondition.h.

374 { return position.GetGeodLatitudeDeg(); }

JSBSim::FGLocation::GetGeodLatitudeDeg

double GetGeodLatitudeDeg(void) const

Get the GEODETIC latitude in degrees.

Definition FGLocation.h:273

◆ GetGeodLatitudeRadIC()

double GetGeodLatitudeRadIC ( void ) const

inline

Gets the initial geodetic latitude.

Returns: Initial geodetic latitude in radians

Definition at line 641 of file FGInitialCondition.h.

642 { return position.GetGeodLatitudeRad(); }

JSBSim::FGLocation::GetGeodLatitudeRad

double GetGeodLatitudeRad(void) const

Get the GEODETIC latitude in radians.

Definition FGLocation.h:258

◆ GetLatitudeDegIC()

double GetLatitudeDegIC ( void ) const

inline

Gets the initial latitude.

Returns: Initial geocentric latitude in degrees

Definition at line 369 of file FGInitialCondition.h.

369{ return position.GetLatitudeDeg(); }

JSBSim::FGLocation::GetLatitudeDeg

double GetLatitudeDeg() const

Get the GEOCENTRIC latitude in degrees.

Definition FGLocation.h:267

◆ GetLatitudeRadIC()

double GetLatitudeRadIC ( void ) const

inline

Gets the initial latitude.

Returns: Initial latitude in radians

Definition at line 637 of file FGInitialCondition.h.

637{ return position.GetLatitude(); }

JSBSim::FGLocation::GetLatitude

double GetLatitude() const

Get the GEOCENTRIC latitude in radians.

Definition FGLocation.h:252

◆ GetLongitudeDegIC()

double GetLongitudeDegIC ( void ) const

inline

Gets the initial longitude.

Returns: Initial longitude in degrees

Definition at line 378 of file FGInitialCondition.h.

378{ return position.GetLongitudeDeg(); }

JSBSim::FGLocation::GetLongitudeDeg

double GetLongitudeDeg() const

Get the longitude.

Definition FGLocation.h:240

◆ GetLongitudeRadIC()

double GetLongitudeRadIC ( void ) const

inline

Gets the initial longitude.

Returns: Initial longitude in radians

Definition at line 646 of file FGInitialCondition.h.

646{ return position.GetLongitude(); }

JSBSim::FGLocation::GetLongitude

double GetLongitude() const

Get the longitude.

Definition FGLocation.h:234

◆ GetMachIC()

double GetMachIC ( void ) const

Gets the initial mach.

Returns: Initial mach number

Definition at line 989 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
  return vt / soundSpeed;
}

Here is the call graph for this function:

◆ GetOrientation()

const FGQuaternion & GetOrientation ( void ) const

inline

Gets the initial orientation.

Returns: Initial orientation

Definition at line 650 of file FGInitialCondition.h.

650{ return orientation; }

◆ GetPhiDegIC()

double GetPhiDegIC ( void ) const

inline

Gets the initial roll angle.

Returns: Initial phi in degrees

Definition at line 361 of file FGInitialCondition.h.

361{ return orientation.GetEulerDeg(ePhi); }

JSBSim::FGQuaternion::GetEulerDeg

double GetEulerDeg(int i) const

Retrieves the Euler angles.

Definition FGQuaternion.h:220

◆ GetPhiRadIC()

double GetPhiRadIC ( void ) const

inline

Gets the initial roll angle.

Returns: Initial roll angle in radians

Definition at line 654 of file FGInitialCondition.h.

654{ return orientation.GetEuler(ePhi); }

JSBSim::FGQuaternion::GetEuler

const FGColumnVector3 & GetEuler(void) const

Retrieves the Euler angles.

Definition FGQuaternion.h:199

Here is the caller graph for this function:

◆ GetPosition()

const FGLocation & GetPosition ( void ) const

inline

Gets the initial position.

Returns: Initial location

Definition at line 633 of file FGInitialCondition.h.

633{ return position; }

◆ GetPQRRadpsIC()

const FGColumnVector3 GetPQRRadpsIC ( void ) const

inline

Gets the initial body rotation rate.

Returns: Initial body rotation rate in radians/second

Definition at line 560 of file FGInitialCondition.h.

560{ return vPQR_body; }

◆ GetPRadpsIC()

double GetPRadpsIC ( ) const

inline

Gets the initial body axis roll rate.

Returns: Initial body axis roll rate in radians/second

Definition at line 564 of file FGInitialCondition.h.

564{ return vPQR_body(eP); }

◆ GetPsiDegIC()

double GetPsiDegIC ( void ) const

inline

Gets the initial heading angle.

Returns: Initial psi in degrees

Definition at line 365 of file FGInitialCondition.h.

365{ return orientation.GetEulerDeg(ePsi); }

◆ GetPsiRadIC()

double GetPsiRadIC ( void ) const

inline

Gets the initial heading angle.

Returns: Initial heading angle in radians

Definition at line 662 of file FGInitialCondition.h.

662{ return orientation.GetEuler(ePsi); }

Here is the caller graph for this function:

◆ GetQRadpsIC()

double GetQRadpsIC ( ) const

inline

Gets the initial body axis pitch rate.

Returns: Initial body axis pitch rate in radians/second

Definition at line 568 of file FGInitialCondition.h.

568{ return vPQR_body(eQ); }

◆ GetRRadpsIC()

double GetRRadpsIC ( ) const

inline

Gets the initial body axis yaw rate.

Returns: Initial body axis yaw rate in radians/second

Definition at line 572 of file FGInitialCondition.h.

572{ return vPQR_body(eR); }

◆ GetSpeedSet()

speedset GetSpeedSet ( void ) const

inline

Gets the initial speedset.

Returns: Initial speedset

Definition at line 666 of file FGInitialCondition.h.

666{ return lastSpeedSet; }

◆ GetTargetNlfIC()

double GetTargetNlfIC ( void ) const

inline

Gets the target normal load factor set from IC.

Returns: target normal load factor set from IC

Definition at line 670 of file FGInitialCondition.h.

670{ return targetNlfIC; }

Here is the caller graph for this function:

◆ GetTerrainElevationFtIC()

double GetTerrainElevationFtIC ( void ) const

Gets the initial terrain elevation.

Returns: Initial terrain elevation in feet

Definition at line 671 of file FGInitialCondition.cpp.

{
  FGColumnVector3 normal, v, w;
  FGLocation contact;
  double a = fdmex->GetInertial()->GetSemimajor();
  double b = fdmex->GetInertial()->GetSemiminor();
  contact.SetEllipse(a, b);
  fdmex->GetInertial()->GetContactPoint(position, contact, normal, v, w);
  return contact.GetGeodAltitude();
}

Here is the call graph for this function:

◆ GetThetaDegIC()

double GetThetaDegIC ( void ) const

inline

Gets the initial pitch angle.

Returns: Initial pitch angle in degrees

Definition at line 357 of file FGInitialCondition.h.

357{ return orientation.GetEulerDeg(eTht); }

◆ GetThetaRadIC()

double GetThetaRadIC ( void ) const

inline

Gets the initial pitch angle.

Returns: Initial pitch angle in radians

Definition at line 658 of file FGInitialCondition.h.

658{ return orientation.GetEuler(eTht); }

Here is the caller graph for this function:

◆ GetUBodyFpsIC()

double GetUBodyFpsIC ( void ) const

inline

Gets the initial body axis X velocity.

Returns: Initial body axis X velocity in feet/second.

Definition at line 536 of file FGInitialCondition.h.

536{ return GetBodyVelFpsIC(eU); }

◆ GetUVWFpsIC()

const FGColumnVector3 GetUVWFpsIC ( void ) const

inline

Gets the initial body velocity.

Returns: Initial body velocity in feet/second.

Definition at line 529 of file FGInitialCondition.h.

                                                {
    const FGMatrix33& Tl2b = orientation.GetT();
    return Tl2b * vUVW_NED;
  }

◆ GetVBodyFpsIC()

double GetVBodyFpsIC ( void ) const

inline

Gets the initial body axis Y velocity.

Returns: Initial body axis Y velocity in feet/second.

Definition at line 540 of file FGInitialCondition.h.

540{ return GetBodyVelFpsIC(eV); }

◆ GetVcalibratedKtsIC()

double GetVcalibratedKtsIC ( void ) const

Gets the initial calibrated airspeed.

Returns: Initial calibrated airspeed in knots

Definition at line 966 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double pressure = Atmosphere->GetPressure(altitudeASL);
  double soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
  double mach = vt / soundSpeed;
 
  return fpstokts * Auxiliary->VcalibratedFromMach(mach, pressure);
}

Here is the call graph for this function:

◆ GetVDownFpsIC()

double GetVDownFpsIC ( void ) const

inline

Gets the initial local frame Z (Down) velocity.

Returns: Initial local frame Z (Down) axis velocity in feet/second.

Definition at line 556 of file FGInitialCondition.h.

556{ return vUVW_NED(eW); }

◆ GetVEastFpsIC()

double GetVEastFpsIC ( void ) const

inline

Gets the initial local frame Y (East) velocity.

Returns: Initial local frame Y (East) axis velocity in feet/second.

Definition at line 552 of file FGInitialCondition.h.

552{ return vUVW_NED(eV); }

◆ GetVequivalentKtsIC()

double GetVequivalentKtsIC ( void ) const

Gets the initial equivalent airspeed.

Returns: Initial equivalent airspeed in knots

Definition at line 979 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double rho = Atmosphere->GetDensity(altitudeASL);
  return fpstokts * vt * sqrt(rho/FGAtmosphere::StdDaySLdensity);
}

Here is the call graph for this function:

◆ GetVgroundFpsIC()

double GetVgroundFpsIC ( void ) const

inline

Gets the initial ground velocity.

Returns: Initial ground velocity in feet/second

Definition at line 476 of file FGInitialCondition.h.

476{ return vUVW_NED.Magnitude(eU, eV); }

JSBSim::FGColumnVector3::Magnitude

double Magnitude(void) const

Length of the vector.

Definition FGColumnVector3.cpp:114

◆ GetVgroundKtsIC()

double GetVgroundKtsIC ( void ) const

inline

Gets the initial ground speed.

Returns: Initial ground speed in knots

Definition at line 327 of file FGInitialCondition.h.

327{ return GetVgroundFpsIC() * fpstokts; }

◆ GetVNorthFpsIC()

double GetVNorthFpsIC ( void ) const

inline

Gets the initial local frame X (North) velocity.

Returns: Initial local frame X (North) axis velocity in feet/second.

Definition at line 548 of file FGInitialCondition.h.

548{ return vUVW_NED(eU); }

◆ GetVtrueFpsIC()

double GetVtrueFpsIC ( void ) const

inline

Gets the initial true velocity.

Returns: Initial true velocity in feet/second

Definition at line 480 of file FGInitialCondition.h.

480{ return vt; }

◆ GetVtrueKtsIC()

double GetVtrueKtsIC ( void ) const

inline

Gets the initial true velocity.

Returns: Initial true airspeed in knots.

Definition at line 331 of file FGInitialCondition.h.

331{ return vt*fpstokts; }

◆ GetWBodyFpsIC()

double GetWBodyFpsIC ( void ) const

inline

Gets the initial body axis Z velocity.

Returns: Initial body axis Z velocity in feet/second.

Definition at line 544 of file FGInitialCondition.h.

544{ return GetBodyVelFpsIC(eW); }

◆ GetWindDFpsIC()

double GetWindDFpsIC ( void ) const

inline

Gets the initial wind velocity in local frame.

Returns: Initial wind velocity downwards in feet/second

Definition at line 508 of file FGInitialCondition.h.

508{ return GetWindNEDFpsIC()(eZ); }

JSBSim::FGInitialCondition::GetWindNEDFpsIC

FGColumnVector3 GetWindNEDFpsIC(void) const

Gets the initial wind velocity in the NED local frame.

Definition FGInitialCondition.cpp:935

◆ GetWindDirDegIC()

double GetWindDirDegIC ( void ) const

Gets the initial wind direction.

Returns: Initial wind direction in feet/second

Definition at line 923 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
 
  return _vWIND_NED.Magnitude(eU, eV) == 0.0 ? 0.0
                              : atan2(_vWIND_NED(eV), _vWIND_NED(eU))*radtodeg;
}

Here is the call graph for this function:

◆ GetWindEFpsIC()

double GetWindEFpsIC ( void ) const

inline

Gets the initial wind velocity in local frame.

Returns: Initial wind velocity eastwards in feet/second

Definition at line 504 of file FGInitialCondition.h.

504{ return GetWindNEDFpsIC()(eY); }

◆ GetWindMagFpsIC()

double GetWindMagFpsIC ( void ) const

Gets the initial total wind velocity in feet/sec.

Returns: Initial wind velocity in feet/second

Definition at line 943 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
 
  return _vWIND_NED.Magnitude(eU, eV);
}

Here is the call graph for this function:

◆ GetWindNEDFpsIC()

FGColumnVector3 GetWindNEDFpsIC ( void ) const

Gets the initial wind velocity in the NED local frame.

Returns: Initial wind velocity in NED frame in feet/second

Definition at line 935 of file FGInitialCondition.cpp.

                                                              {
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  return _vt_NED - vUVW_NED;
}

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetWindNFpsIC()

double GetWindNFpsIC ( void ) const

inline

Gets the initial wind velocity in local frame.

Returns: Initial wind velocity toward north in feet/second

Definition at line 500 of file FGInitialCondition.h.

500{ return GetWindNEDFpsIC()(eX); }

◆ GetWindUFpsIC()

double GetWindUFpsIC ( void ) const

inline

Gets the initial body axis X wind velocity.

Returns: Initial body axis X wind velocity in feet/second

Definition at line 484 of file FGInitialCondition.h.

484{ return GetBodyWindFpsIC(eU); }

◆ GetWindVFpsIC()

double GetWindVFpsIC ( void ) const

inline

Gets the initial body axis Y wind velocity.

Returns: Initial body axis Y wind velocity in feet/second

Definition at line 488 of file FGInitialCondition.h.

488{ return GetBodyWindFpsIC(eV); }

◆ GetWindWFpsIC()

double GetWindWFpsIC ( void ) const

inline

Gets the initial body axis Z wind velocity.

Returns: Initial body axis Z wind velocity in feet/second

Definition at line 492 of file FGInitialCondition.h.

492{ return GetBodyWindFpsIC(eW); }

◆ InitializeIC()

void InitializeIC ( void )

Initialize the initial conditions to default values.

Definition at line 125 of file FGInitialCondition.cpp.

{
  alpha = beta = 0.0;
  epa = 0.0;
 
  double a = fdmex->GetInertial()->GetSemimajor();
  double b = fdmex->GetInertial()->GetSemiminor();
 
  position.SetEllipse(a, b);
 
  position.SetPositionGeodetic(0.0, 0.0, 0.0);
 
  orientation = FGQuaternion(0.0, 0.0, 0.0);
  vUVW_NED.InitMatrix();
  vPQR_body.InitMatrix();
  vt=0;
 
  targetNlfIC = 1.0;
 
  Tw2b = { 1., 0., 0., 0., 1., 0., 0., 0., 1. };
  Tb2w = { 1., 0., 0., 0., 1., 0., 0., 0., 1. };
 
  lastSpeedSet = setvt;
  lastAltitudeSet = setasl;
  lastLatitudeSet = setgeoc;
  enginesRunning = 0;
  trimRequested = TrimMode::tNone;
}

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsEngineRunning()

bool IsEngineRunning ( unsigned int n ) const

inline

Is an engine running ?

Parameters

index of the engine to be checked

Returns: true if the engine is running.

Definition at line 681 of file FGInitialCondition.h.

681{ return (enginesRunning & (1 << n)) != 0; }

◆ Load()

bool Load	(	const SGPath &	rstname,
		bool	useAircraftPath = `true`
	)

Loads the initial conditions.

Parameters

rstname	The name of an initial conditions file
useAircraftPath	true if path is given relative to the aircraft path.

Returns: true if successful

Definition at line 1009 of file FGInitialCondition.cpp.

{
  SGPath init_file_name;
  if(useAircraftPath && rstfile.isRelative()) {
    init_file_name = fdmex->GetFullAircraftPath()/rstfile.utf8Str();
  } else {
    init_file_name = rstfile;
  }
 
  FGXMLFileRead XMLFileRead;
  Element* document = XMLFileRead.LoadXMLDocument(init_file_name);
 
  // Make sure that the document is valid
  if (!document) {
    LogException err;
    err << "File: " << init_file_name << " could not be read.\n";
    throw err;
  }
 
  if (document->GetName() != "initialize") {
    LogException err;
    err << "File: " << init_file_name << " is not a reset file.\n";
    throw err;
  }
 
  bool result = false;
 
  // If doc has an version, check it. Otherwise fall back to legacy.
  if (document->HasAttribute("version")) {
    double version = document->GetAttributeValueAsNumber("version");
 
    if (version >= 3.0) {
      XMLLogException err(document);
      err << "Only initialization file formats 1 and 2 are currently supported\n";
      throw err;
    } else if (version >= 2.0) {
      result = Load_v2(document);
    } else if (version >= 1.0) {
      result = Load_v1(document);
    }
 
  } else {
    result = Load_v1(document);
  }
 
  // Check to see if any engines are specified to be initialized in a running state
    Element* running_elements = document->FindElement("running");
  while (running_elements) {
    int engineNumber = int(running_elements->GetDataAsNumber());
    enginesRunning |= engineNumber == -1 ? engineNumber : 1 << engineNumber;
    running_elements = document->FindNextElement("running");
  }
 
  return result;
}

Here is the call graph for this function:

◆ ResetIC()

void ResetIC	(	double	u0,
		double	v0,
		double	w0,
		double	p0,
		double	q0,
		double	r0,
		double	alpha0,
		double	beta0,
		double	phi0,
		double	theta0,
		double	psi0,
		double	latitudeRad0,
		double	longitudeRad0,
		double	altitudeAGL0,
		double	gamma0
	)

Resets the IC data structure to new values.

Parameters

u,v,w,...

Definition at line 87 of file FGInitialCondition.cpp.

{
  double calpha = cos(alpha0), cbeta = cos(beta0);
  double salpha = sin(alpha0), sbeta = sin(beta0);
 
  InitializeIC();
 
  vPQR_body = {p0, q0, r0};
  alpha = alpha0;  beta = beta0;
 
  position.SetLongitude(lonRad0);
  position.SetLatitude(latRad0);
  fdmex->GetInertial()->SetAltitudeAGL(position, altAGLFt0);
  lastLatitudeSet = setgeoc;
  lastAltitudeSet = setagl;
 
  orientation = FGQuaternion(phi0, theta0, psi0);
  const FGMatrix33& Tb2l = orientation.GetTInv();
 
  vUVW_NED = Tb2l * FGColumnVector3(u0, v0, w0);
  vt = vUVW_NED.Magnitude();
  lastSpeedSet = setuvw;
 
  Tw2b = { calpha*cbeta, -calpha*sbeta,  -salpha,
                  sbeta,         cbeta,      0.0,
           salpha*cbeta, -salpha*sbeta,   calpha };
  Tb2w = Tw2b.Transposed();
 
  SetFlightPathAngleRadIC(gamma0);
}

Here is the call graph for this function:

◆ SetAlphaDegIC()

void SetAlphaDegIC ( double a )

inline

Sets angle of attack initial condition in degrees.

Parameters

a	Alpha in degrees

Definition at line 256 of file FGInitialCondition.h.

256{ SetAlphaRadIC(a*degtorad); }

◆ SetAlphaRadIC()

void SetAlphaRadIC ( double alpha )

Sets the initial angle of attack.

Parameters

alpha Initial angle of attack in radians

Definition at line 319 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  calcThetaBeta(alfa, _vt_NED);
}

Here is the call graph for this function:

◆ SetAltitudeAGLFtIC()

void SetAltitudeAGLFtIC ( double agl )

Sets the initial Altitude above ground level.

Parameters

agl	Altitude above ground level in feet

Definition at line 684 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double pressure = Atmosphere->GetPressure(altitudeASL);
  double soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
  double rho = Atmosphere->GetDensity(altitudeASL);
 
  double mach0 = vt / soundSpeed;
  double vc0 = Auxiliary->VcalibratedFromMach(mach0, pressure);
  double ve0 = vt * sqrt(rho/FGAtmosphere::StdDaySLdensity);
 
  switch(lastLatitudeSet) {
  case setgeod:
    fdmex->GetInertial()->SetAltitudeAGL(position, agl);
    break;
  case setgeoc:
    {
      double a = fdmex->GetInertial()->GetSemimajor();
      double b = fdmex->GetInertial()->GetSemiminor();
      double e2 = 1.0-b*b/(a*a);
      double tanlat = tan(position.GetLatitude());
      double n = e2;
      double prev_n = 1.0;
      int iter = 0;
      double longitude = position.GetLongitude();
      double alt = position.GetGeodAltitude();
      double h = -2.0*max(a,b);
      double geodLat;
      while ((fabs(n-prev_n) > 1E-15 || fabs(h-agl) > 1E-10) && iter < 10) {
        geodLat = atan(tanlat/(1-n));
        position.SetPositionGeodetic(longitude, geodLat, alt);
        h = GetAltitudeAGLFtIC();
        alt += agl-h;
        double sinGeodLat = sin(geodLat);
        double N = a/sqrt(1-e2*sinGeodLat*sinGeodLat);
        prev_n = n;
        n = e2*N/(N+alt);
        iter++;
      }
    }
    break;
  }
 
  altitudeASL = GetAltitudeASLFtIC();
  soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
  rho = Atmosphere->GetDensity(altitudeASL);
  pressure = Atmosphere->GetPressure(altitudeASL);
 
  switch(lastSpeedSet) {
    case setvc:
      mach0 = Auxiliary->MachFromVcalibrated(vc0, pressure);
      SetVtrueFpsIC(mach0 * soundSpeed);
      break;
    case setmach:
      SetVtrueFpsIC(mach0 * soundSpeed);
      break;
    case setve:
      SetVtrueFpsIC(ve0 * sqrt(FGAtmosphere::StdDaySLdensity/rho));
      break;
    default: // Make the compiler stop complaining about missing enums
      break;
  }
 
  lastAltitudeSet = setagl;
}

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetAltitudeASLFtIC()

void SetAltitudeASLFtIC ( double altitudeASL )

Sets the altitude above sea level initial condition in feet.

Parameters

altitudeASL Altitude above sea level in feet

Definition at line 756 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double pressure = Atmosphere->GetPressure(altitudeASL);
  double soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
  double rho = Atmosphere->GetDensity(altitudeASL);
 
  double mach0 = vt / soundSpeed;
  double vc0 = Auxiliary->VcalibratedFromMach(mach0, pressure);
  double ve0 = vt * sqrt(rho/FGAtmosphere::StdDaySLdensity);
 
  switch(lastLatitudeSet) {
  case setgeod:
    {
      // Given an altitude above the mean sea level (or a position radius which
      // is the same) and a geodetic latitude, compute the geodetic altitude.
      double a = fdmex->GetInertial()->GetSemimajor();
      double b = fdmex->GetInertial()->GetSemiminor();
      double e2 = 1.0-b*b/(a*a);
      double geodLatitude = position.GetGeodLatitudeRad();
      double cosGeodLat = cos(geodLatitude);
      double sinGeodLat = sin(geodLatitude);
      double N = a/sqrt(1-e2*sinGeodLat*sinGeodLat);
      double geodAlt = 0.0;
      double n = e2;
      double prev_n = 1.0;
      int iter = 0;
      // Use tan or cotan to solve the geodetic altitude to avoid floating point
      // exceptions.
      if (cosGeodLat > fabs(sinGeodLat)) { // tan() can safely be used.
        double tanGeodLat = sinGeodLat/cosGeodLat;
        double x0 = N*e2*cosGeodLat;
        double x = 0.0;
        while (fabs(n-prev_n) > 1E-15 && iter < 10) {
          double tanLat = (1-n)*tanGeodLat; // See Stevens & Lewis 1.6-14
          double cos2Lat = 1./(1.+tanLat*tanLat);
          double slr = b/sqrt(1.-e2*cos2Lat);
          double R = slr + alt;
          x = R*sqrt(cos2Lat); // OK, cos(latitude) is always positive.
          prev_n = n;
          n = x0/x;
          iter++;
        }
        geodAlt = x/cosGeodLat-N;
      }
      else { // better use cotan (i.e. 1./tan())
        double cotanGeodLat = cosGeodLat/sinGeodLat;
        double z0 = N*e2*sinGeodLat;
        double z = 0.0;
        while (fabs(n-prev_n) > 1E-15 && iter < 10) {
          double cotanLat = cotanGeodLat/(1-n);
          double sin2Lat = 1./(1.+cotanLat*cotanLat);
          double cos2Lat = 1.-sin2Lat;
          double slr = b/sqrt(1.-e2*cos2Lat);
          double R = slr + alt;
          z = R*sign(cotanLat)*sqrt(sin2Lat);
          prev_n = n;
          n = z0/(z0+z);
          iter++;
        }
        geodAlt = z/sinGeodLat-N*(1-e2);
      }
 
      double longitude = position.GetLongitude();
      position.SetPositionGeodetic(longitude, geodLatitude, geodAlt);
    }
    break;
  case setgeoc:
    {
      double slr = position.GetSeaLevelRadius();
      position.SetRadius(slr+alt);
    }
    break;
  }
 
  altitudeASL = position.GetGeodAltitude();
  soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
  rho = Atmosphere->GetDensity(altitudeASL);
  pressure = Atmosphere->GetPressure(altitudeASL);
 
  switch(lastSpeedSet) {
    case setvc:
      mach0 = Auxiliary->MachFromVcalibrated(vc0, pressure);
      SetVtrueFpsIC(mach0 * soundSpeed);
      break;
    case setmach:
      SetVtrueFpsIC(mach0 * soundSpeed);
      break;
    case setve:
      SetVtrueFpsIC(ve0 * sqrt(FGAtmosphere::StdDaySLdensity/rho));
      break;
    default: // Make the compiler stop complaining about missing enums
      break;
  }
 
  lastAltitudeSet = setasl;
}

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetBetaDegIC()

void SetBetaDegIC ( double b )

inline

Sets angle of sideslip initial condition in degrees.

Parameters

B	Beta in degrees

Definition at line 260 of file FGInitialCondition.h.

260{ SetBetaRadIC(b*degtorad);}

◆ SetBetaRadIC()

void SetBetaRadIC ( double beta )

Sets the initial sideslip angle.

Parameters

beta	Initial angle of sideslip in radians.

Definition at line 405 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 vOrient = orientation.GetEuler();
 
  beta = bta;
  double calpha = cos(alpha), salpha = sin(alpha);
  double cbeta = cos(beta), sbeta = sin(beta);
  double cphi = orientation.GetCosEuler(ePhi), sphi = orientation.GetSinEuler(ePhi);
  FGMatrix33 TphiInv(1.,   0.,   0.,
                     0., cphi,-sphi,
                     0., sphi, cphi);
 
  Tw2b = { calpha*cbeta, -calpha*sbeta,  -salpha,
                  sbeta,         cbeta,      0.0,
           salpha*cbeta, -salpha*sbeta,   calpha };
  Tb2w = Tw2b.Transposed();
 
  FGColumnVector3 vf = TphiInv * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 v0xy(_vt_NED(eX), _vt_NED(eY), 0.);
  FGColumnVector3 v1xy(sqrt(v0xy(eX)*v0xy(eX)+v0xy(eY)*v0xy(eY)-vf(eY)*vf(eY)),vf(eY),0.);
  v0xy.Normalize();
  v1xy.Normalize();
 
  if (vf(eX) < 0.) v0xy(eX) *= -1.0;
 
  double sinPsi = (v1xy * v0xy)(eZ);
  double cosPsi = DotProduct(v0xy, v1xy);
  vOrient(ePsi) = atan2(sinPsi, cosPsi);
  FGMatrix33 Tpsi( cosPsi, sinPsi, 0.,
                  -sinPsi, cosPsi, 0.,
                      0.,     0., 1.);
 
  FGColumnVector3 v2xz = Tpsi * _vt_NED;
  FGColumnVector3 vfxz = vf;
  v2xz(eV) = vfxz(eV) = 0.0;
  v2xz.Normalize();
  vfxz.Normalize();
  double sinTheta = (v2xz * vfxz)(eY);
  vOrient(eTht) = -asin(sinTheta);
 
  orientation = FGQuaternion(vOrient);
}

Here is the call graph for this function:

◆ SetClimbRateFpmIC()

void SetClimbRateFpmIC ( double roc )

inline

Sets the climb rate initial condition in feet/minute.

Parameters

roc	Rate of Climb in feet/minute

Definition at line 283 of file FGInitialCondition.h.

283{ SetClimbRateFpsIC(roc/60.0); }

◆ SetClimbRateFpsIC()

void SetClimbRateFpsIC ( double roc )

Sets the initial climb rate.

Parameters

roc	Initial Rate of climb in feet/second

Definition at line 289 of file FGInitialCondition.cpp.

{
  if (fabs(hdot) > vt) {
    FGLogging log(LogLevel::ERROR);
    log << "The climb rate cannot be higher than the true speed.\n";
    return;
  }
 
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _WIND_NED = _vt_NED - vUVW_NED;
  double hdot0 = -_vt_NED(eW);
 
  if (fabs(hdot0) < vt) { // Is this check really needed ?
    double scale = sqrt((vt*vt-hdot*hdot)/(vt*vt-hdot0*hdot0));
    _vt_NED(eU) *= scale;
    _vt_NED(eV) *= scale;
  }
  _vt_NED(eW) = -hdot;
  vUVW_NED = _vt_NED - _WIND_NED;
 
  // Updating the angles theta and beta to keep the true airspeed amplitude
  calcThetaBeta(alpha, _vt_NED);
}

Here is the call graph for this function:

◆ SetCrossWindKtsIC()

void SetCrossWindKtsIC ( double cross )

Sets the initial crosswind speed.

Parameters

cross Initial crosswind speed, positive from left to right

Definition at line 535 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
  FGColumnVector3 _vCROSS(-orientation.GetSinEuler(ePsi), orientation.GetCosEuler(ePsi), 0.);
 
  // Gram-Schmidt process is used to remove the existing cross wind component
  _vWIND_NED -= DotProduct(_vWIND_NED, _vCROSS) * _vCROSS;
  // Which is now replaced by the new value. The input cross wind is expected
  // in knots, so first convert to fps, which is the internal unit used.
  _vWIND_NED += (cross * ktstofps) * _vCROSS;
  _vt_NED = vUVW_NED + _vWIND_NED;
  vt = _vt_NED.Magnitude();
 
  calcAeroAngles(_vt_NED);
}

Here is the call graph for this function:

◆ SetFlightPathAngleDegIC()

void SetFlightPathAngleDegIC ( double gamma )

inline

Sets the flight path angle initial condition in degrees.

Parameters

gamma Flight path angle in degrees

Definition at line 287 of file FGInitialCondition.h.

288 { SetClimbRateFpsIC(vt*sin(gamma*degtorad)); }

◆ SetFlightPathAngleRadIC()

void SetFlightPathAngleRadIC ( double gamma )

inline

Sets the initial flight path angle.

Parameters

gamma Initial flight path angle in radians

Definition at line 576 of file FGInitialCondition.h.

577 { SetClimbRateFpsIC(vt*sin(gamma)); }

Here is the caller graph for this function:

◆ SetGeodLatitudeDegIC()

void SetGeodLatitudeDegIC ( double glat )

inline

Sets the initial geodetic latitude.

This method modifies the geodetic altitude in order to keep the altitude above sea level unchanged.

Parameters

glat	Initial geodetic latitude in degrees

Definition at line 310 of file FGInitialCondition.h.

311 { SetGeodLatitudeRadIC(glat*degtorad); }

◆ SetGeodLatitudeRadIC()

void SetGeodLatitudeRadIC ( double glat )

Sets the initial geodetic latitude.

This method modifies the geodetic altitude in order to keep the altitude above sea level unchanged.

Parameters

glat	Initial geodetic latitude in radians

Definition at line 857 of file FGInitialCondition.cpp.

{
  double lon = position.GetLongitude();
  lastLatitudeSet = setgeod;
 
  switch (lastAltitudeSet)
  {
  case setagl:
    {
      double agl = GetAltitudeAGLFtIC();
      position.SetPositionGeodetic(lon, geodLatitude, 0.);
      fdmex->GetInertial()->SetAltitudeAGL(position, agl);
    }
    break;
  case setasl:
    {
      double asl = GetAltitudeASLFtIC();
      position.SetPositionGeodetic(lon, geodLatitude, 0.);
      SetAltitudeASLFtIC(asl);
    }
    break;
  }
}

Here is the call graph for this function:

◆ SetHeadWindKtsIC()

void SetHeadWindKtsIC ( double head )

Sets the initial headwind velocity.

Parameters

head	Initial headwind speed in knots

Definition at line 558 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
  // This is a head wind, so the direction vector for the wind
  // needs to be set opposite to the heading the aircraft
  // is taking. So, the cos and sin of the heading (psi)
  // are negated in the line below.
  FGColumnVector3 _vHEAD(-orientation.GetCosEuler(ePsi), -orientation.GetSinEuler(ePsi), 0.);
 
  // Gram-Schmidt process is used to remove the existing head wind component
  _vWIND_NED -= DotProduct(_vWIND_NED, _vHEAD) * _vHEAD;
  // Which is now replaced by the new value. The input head wind is expected
  // in knots, so first convert to fps, which is the internal unit used.
  _vWIND_NED += (head * ktstofps) * _vHEAD;
  _vt_NED = vUVW_NED + _vWIND_NED;
 
  vt = _vt_NED.Magnitude();
 
  calcAeroAngles(_vt_NED);
}

Here is the call graph for this function:

◆ SetLatitudeDegIC()

void SetLatitudeDegIC ( double lat )

inline

Sets the initial latitude.

Parameters

lat	Initial latitude in degrees

Definition at line 304 of file FGInitialCondition.h.

304{ SetLatitudeRadIC(lat*degtorad); }

◆ SetLatitudeRadIC()

void SetLatitudeRadIC ( double lat )

Sets the initial latitude.

Parameters

lat	Initial latitude in radians

Definition at line 883 of file FGInitialCondition.cpp.

{
  double altitude;
 
  lastLatitudeSet = setgeoc;
 
  switch(lastAltitudeSet) {
  case setagl:
    altitude = GetAltitudeAGLFtIC();
    position.SetLatitude(lat);
    SetAltitudeAGLFtIC(altitude);
    break;
  default:
    altitude = GetAltitudeASLFtIC();
    position.SetLatitude(lat);
    SetAltitudeASLFtIC(altitude);
    break;
  }
}

Here is the call graph for this function:

◆ SetLongitudeDegIC()

void SetLongitudeDegIC ( double lon )

inline

Sets the initial longitude.

Parameters

lon	Initial longitude in degrees

Definition at line 315 of file FGInitialCondition.h.

315{ SetLongitudeRadIC(lon*degtorad); }

◆ SetLongitudeRadIC()

void SetLongitudeRadIC ( double lon )

Sets the initial longitude.

Parameters

lon	Initial longitude in radians

Definition at line 905 of file FGInitialCondition.cpp.

{
  double altitude;
 
  switch(lastAltitudeSet) {
  case setagl:
    altitude = GetAltitudeAGLFtIC();
    position.SetLongitude(lon);
    SetAltitudeAGLFtIC(altitude);
    break;
  default:
    position.SetLongitude(lon);
    break;
  }
}

Here is the call graph for this function:

◆ SetMachIC()

void SetMachIC ( double mach )

Set mach initial condition.

Parameters

mach	Mach number

Definition at line 167 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
  SetVtrueFpsIC(mach*soundSpeed);
  lastSpeedSet = setmach;
}

Here is the call graph for this function:

◆ SetPhiDegIC()

void SetPhiDegIC ( double phi )

inline

Sets the roll angle initial condition in degrees.

Parameters

phi	roll angle in degrees

Definition at line 275 of file FGInitialCondition.h.

275{ SetPhiRadIC(phi*degtorad);}

◆ SetPhiRadIC()

void SetPhiRadIC ( double phi )

inline

Sets the initial roll angle.

Parameters

phi	Initial roll angle in radians

Definition at line 589 of file FGInitialCondition.h.

589{ SetEulerAngleRadIC(ePhi, phi); }

◆ SetPRadpsIC()

void SetPRadpsIC ( double P )

inline

Sets the initial body axis roll rate.

Parameters

P	Initial roll rate in radians/second

Definition at line 430 of file FGInitialCondition.h.

430{ vPQR_body(eP) = P; }

Here is the caller graph for this function:

◆ SetPsiDegIC()

void SetPsiDegIC ( double psi )

inline

Sets the heading angle initial condition in degrees.

Parameters

psi	Heading angle in degrees

Definition at line 279 of file FGInitialCondition.h.

279{ SetPsiRadIC(psi*degtorad); }

◆ SetPsiRadIC()

void SetPsiRadIC ( double psi )

inline

Sets the initial heading angle.

Parameters

psi	Initial heading angle in radians

Definition at line 597 of file FGInitialCondition.h.

597{ SetEulerAngleRadIC(ePsi, psi); }

◆ SetQRadpsIC()

void SetQRadpsIC ( double Q )

inline

Sets the initial body axis pitch rate.

Parameters

Q	Initial pitch rate in radians/second

Definition at line 434 of file FGInitialCondition.h.

434{ vPQR_body(eQ) = Q; }

Here is the caller graph for this function:

◆ SetRRadpsIC()

void SetRRadpsIC ( double R )

inline

Sets the initial body axis yaw rate.

Parameters

R	initial yaw rate in radians/second

Definition at line 438 of file FGInitialCondition.h.

438{ vPQR_body(eR) = R; }

Here is the caller graph for this function:

◆ SetTargetNlfIC()

void SetTargetNlfIC ( double nlf )

inline

Sets the target normal load factor.

Parameters

nlf	Normal load factor

Definition at line 615 of file FGInitialCondition.h.

615{ targetNlfIC=nlf; }

◆ SetTerrainElevationFtIC()

void SetTerrainElevationFtIC ( double elev )

Sets the initial terrain elevation.

Parameters

elev	Initial terrain elevation in feet

Definition at line 646 of file FGInitialCondition.cpp.

{
  double agl = GetAltitudeAGLFtIC();
  fdmex->GetInertial()->SetTerrainElevation(elev);
 
  if (lastAltitudeSet == setagl)
    SetAltitudeAGLFtIC(agl);
}

Here is the call graph for this function:

◆ SetThetaDegIC()

void SetThetaDegIC ( double theta )

inline

Sets pitch angle initial condition in degrees.

Parameters

theta Theta (pitch) angle in degrees

Definition at line 264 of file FGInitialCondition.h.

264{ SetThetaRadIC(theta*degtorad); }

◆ SetThetaRadIC()

void SetThetaRadIC ( double theta )

inline

Sets the initial pitch angle.

Parameters

theta Initial pitch angle in radians

Definition at line 593 of file FGInitialCondition.h.

593{ SetEulerAngleRadIC(eTht, theta); }

◆ SetUBodyFpsIC()

void SetUBodyFpsIC ( double ubody )

inline

Sets the initial body axis X velocity.

Parameters

ubody Initial X velocity in feet/second

Definition at line 406 of file FGInitialCondition.h.

406{ SetBodyVelFpsIC(eU, ubody); }

◆ SetVBodyFpsIC()

void SetVBodyFpsIC ( double vbody )

inline

Sets the initial body axis Y velocity.

Parameters

vbody Initial Y velocity in feet/second

Definition at line 410 of file FGInitialCondition.h.

410{ SetBodyVelFpsIC(eV, vbody); }

◆ SetVcalibratedKtsIC()

void SetVcalibratedKtsIC ( double vc )

Set calibrated airspeed initial condition in knots.

Parameters

vc	Calibrated airspeed in knots

Definition at line 178 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double pressure = Atmosphere->GetPressure(altitudeASL);
  double mach = Auxiliary->MachFromVcalibrated(fabs(vcas)*ktstofps, pressure);
  double soundSpeed = Atmosphere->GetSoundSpeed(altitudeASL);
 
  SetVtrueFpsIC(mach * soundSpeed);
  lastSpeedSet = setvc;
}

Here is the call graph for this function:

◆ SetVDownFpsIC()

void SetVDownFpsIC ( double vd )

inline

Sets the initial local axis down velocity.

Parameters

vd	Initial down velocity in feet/second

Definition at line 426 of file FGInitialCondition.h.

426{ SetNEDVelFpsIC(eW, vd); }

◆ SetVEastFpsIC()

void SetVEastFpsIC ( double ve )

inline

Sets the initial local axis east velocity.

Parameters

ve	Initial east velocity in feet/second

Definition at line 422 of file FGInitialCondition.h.

422{ SetNEDVelFpsIC(eV, ve); }

◆ SetVequivalentKtsIC()

void SetVequivalentKtsIC ( double ve )

Set equivalent airspeed initial condition in knots.

Parameters

ve	Equivalent airspeed in knots

Definition at line 156 of file FGInitialCondition.cpp.

{
  const auto Atmosphere = fdmex->GetAtmosphere();
  double altitudeASL = GetAltitudeASLFtIC();
  double rho = Atmosphere->GetDensity(altitudeASL);
  SetVtrueFpsIC(ve*ktstofps*sqrt(FGAtmosphere::StdDaySLdensity/rho));
  lastSpeedSet = setve;
}

Here is the call graph for this function:

◆ SetVgroundFpsIC()

void SetVgroundFpsIC ( double vg )

Sets the initial ground speed.

Parameters

vg	Initial ground speed in feet/second

Definition at line 241 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
 
  vUVW_NED(eU) = vg * orientation.GetCosEuler(ePsi);
  vUVW_NED(eV) = vg * orientation.GetSinEuler(ePsi);
  vUVW_NED(eW) = 0.;
  _vt_NED = vUVW_NED + _vWIND_NED;
  vt = _vt_NED.Magnitude();
 
  calcAeroAngles(_vt_NED);
 
  lastSpeedSet = setvg;
}

Here is the call graph for this function:

◆ SetVgroundKtsIC()

void SetVgroundKtsIC ( double vg )

inline

Set ground speed initial condition in knots.

Parameters

vg	Ground speed in knots

Definition at line 248 of file FGInitialCondition.h.

248{ SetVgroundFpsIC(vg*ktstofps); }

◆ SetVNorthFpsIC()

void SetVNorthFpsIC ( double vn )

inline

Sets the initial local axis north velocity.

Parameters

vn	Initial north velocity in feet/second

Definition at line 418 of file FGInitialCondition.h.

418{ SetNEDVelFpsIC(eU, vn); }

◆ SetVtrueFpsIC()

void SetVtrueFpsIC ( double vt )

Sets the initial true airspeed.

Parameters

vt	Initial true airspeed in feet/second

Definition at line 265 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
 
  if (vt > 0.1)
    _vt_NED *= vtrue / vt;
  else
    _vt_NED = Tb2l * Tw2b * FGColumnVector3(vtrue, 0., 0.);
 
  vt = vtrue;
  vUVW_NED = _vt_NED - _vWIND_NED;
 
  calcAeroAngles(_vt_NED);
 
  lastSpeedSet = setvt;
}

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetVtrueKtsIC()

void SetVtrueKtsIC ( double vtrue )

inline

Set true airspeed initial condition in knots.

Parameters

vtrue True airspeed in knots

Definition at line 244 of file FGInitialCondition.h.

244{ SetVtrueFpsIC(vtrue*ktstofps); }

◆ SetWBodyFpsIC()

void SetWBodyFpsIC ( double wbody )

inline

Sets the initial body axis Z velocity.

Parameters

wbody Initial Z velocity in feet/second

Definition at line 414 of file FGInitialCondition.h.

414{ SetBodyVelFpsIC(eW, wbody); }

◆ SetWindDirDegIC()

void SetWindDirDegIC ( double dir )

Sets the initial wind direction.

Parameters

dir	Initial direction wind is coming from in degrees

Definition at line 628 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
  double mag = _vWIND_NED.Magnitude(eU, eV);
  FGColumnVector3 _vHEAD(mag*cos(dir*degtorad), mag*sin(dir*degtorad), 0.);
 
  _vWIND_NED(eU) = _vHEAD(eU);
  _vWIND_NED(eV) = _vHEAD(eV);
  _vt_NED = vUVW_NED + _vWIND_NED;
  vt = _vt_NED.Magnitude();
 
  calcAeroAngles(_vt_NED);
}

Here is the call graph for this function:

◆ SetWindDownKtsIC()

void SetWindDownKtsIC ( double wD )

Sets the initial wind downward speed.

Parameters

wD	Initial downward wind speed in knots

Definition at line 586 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
 
  _vt_NED(eW) = vUVW_NED(eW) + wD * ktstofps;
  vt = _vt_NED.Magnitude();
 
  calcAeroAngles(_vt_NED);
}

Here is the call graph for this function:

◆ SetWindMagFpsIC()

void SetWindMagFpsIC ( double mag )

inline

Sets the initial total wind speed.

Parameters

mag	Initial wind velocity magnitude in feet/second

Definition at line 448 of file FGInitialCondition.h.

448{ SetWindMagKtsIC(mag * fpstokts); }

JSBSim::FGInitialCondition::SetWindMagKtsIC

void SetWindMagKtsIC(double mag)

Sets the initial total wind speed.

Definition FGInitialCondition.cpp:602

◆ SetWindMagKtsIC()

void SetWindMagKtsIC ( double mag )

Sets the initial total wind speed.

Parameters

mag	Initial wind velocity magnitude in knots

Definition at line 602 of file FGInitialCondition.cpp.

{
  const FGMatrix33& Tb2l = orientation.GetTInv();
  FGColumnVector3 _vt_NED = Tb2l * Tw2b * FGColumnVector3(vt, 0., 0.);
  FGColumnVector3 _vWIND_NED = _vt_NED - vUVW_NED;
  FGColumnVector3 _vHEAD(_vWIND_NED(eU), _vWIND_NED(eV), 0.);
  double windMag = _vHEAD.Magnitude();
 
  if (windMag > 0.001)
    _vHEAD *= (mag*ktstofps) / windMag;
  else
    _vHEAD = {mag*ktstofps, 0., 0.};
 
  _vWIND_NED(eU) = _vHEAD(eU);
  _vWIND_NED(eV) = _vHEAD(eV);
  _vt_NED = vUVW_NED + _vWIND_NED;
  vt = _vt_NED.Magnitude();
 
  calcAeroAngles(_vt_NED);
}

Here is the call graph for this function:

◆ SetWindNEDFpsIC()

void SetWindNEDFpsIC	(	double	wN,
		double	wE,
		double	wD
	)

Sets the initial wind velocity.

Parameters

wN	Initial wind velocity in local north direction, feet/second
wE	Initial wind velocity in local east direction, feet/second
wD	Initial wind velocity in local down direction, feet/second

Definition at line 522 of file FGInitialCondition.cpp.

{
  FGColumnVector3 _vt_NED = vUVW_NED + FGColumnVector3(wN, wE, wD);
  vt = _vt_NED.Magnitude();
 
  calcAeroAngles(_vt_NED);
}

Here is the call graph for this function:

◆ TrimRequested()

int TrimRequested ( void ) const

inline

Does initialization file call for trim ?

Returns: Trim type, if any requested (version 1).

Definition at line 685 of file FGInitialCondition.h.

685{ return trimRequested; }

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

Detailed Description

Usage Notes

Speed

Alpha,Gamma, and Theta

Properties

Public Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

◆ FGInitialCondition()

◆ ~FGInitialCondition()

Member Function Documentation

◆ bind()

◆ GetAlphaDegIC()

◆ GetAlphaRadIC()

◆ GetAltitudeAGLFtIC()

◆ GetAltitudeASLFtIC()

◆ GetBetaDegIC()

◆ GetBetaRadIC()

◆ GetClimbRateFpmIC()

◆ GetClimbRateFpsIC()

◆ GetEarthPositionAngleIC()

◆ GetFlightPathAngleDegIC()

◆ GetFlightPathAngleRadIC()

◆ GetGeodLatitudeDegIC()

◆ GetGeodLatitudeRadIC()

◆ GetLatitudeDegIC()

◆ GetLatitudeRadIC()

◆ GetLongitudeDegIC()

◆ GetLongitudeRadIC()

◆ GetMachIC()

◆ GetOrientation()

◆ GetPhiDegIC()

◆ GetPhiRadIC()

◆ GetPosition()

◆ GetPQRRadpsIC()

◆ GetPRadpsIC()

◆ GetPsiDegIC()

◆ GetPsiRadIC()

◆ GetQRadpsIC()

◆ GetRRadpsIC()

◆ GetSpeedSet()

◆ GetTargetNlfIC()

◆ GetTerrainElevationFtIC()

◆ GetThetaDegIC()

◆ GetThetaRadIC()

◆ GetUBodyFpsIC()

◆ GetUVWFpsIC()

◆ GetVBodyFpsIC()

◆ GetVcalibratedKtsIC()

◆ GetVDownFpsIC()

◆ GetVEastFpsIC()

◆ GetVequivalentKtsIC()

◆ GetVgroundFpsIC()

◆ GetVgroundKtsIC()

◆ GetVNorthFpsIC()

◆ GetVtrueFpsIC()

◆ GetVtrueKtsIC()

◆ GetWBodyFpsIC()

◆ GetWindDFpsIC()

◆ GetWindDirDegIC()

◆ GetWindEFpsIC()

◆ GetWindMagFpsIC()

◆ GetWindNEDFpsIC()

◆ GetWindNFpsIC()

◆ GetWindUFpsIC()

◆ GetWindVFpsIC()

◆ GetWindWFpsIC()

◆ InitializeIC()

◆ IsEngineRunning()

◆ Load()

◆ ResetIC()

◆ SetAlphaDegIC()

◆ SetAlphaRadIC()

◆ SetAltitudeAGLFtIC()

◆ SetAltitudeASLFtIC()

◆ SetBetaDegIC()

◆ SetBetaRadIC()

◆ SetClimbRateFpmIC()

◆ SetClimbRateFpsIC()

◆ SetCrossWindKtsIC()