FGFDMExec Class Reference

Detailed Description

Encapsulates the JSBSim simulation executive.

This class is the executive class through which all other simulation classes are instantiated, initialized, and run. When integrated with FlightGear (or other flight simulator) this class is typically instantiated by an interface class on the simulator side.

At the time of simulation initialization, the interface class creates an instance of this executive class. The executive is subsequently directed to load the chosen aircraft specification file:

fdmex = new FGFDMExec( ... );
result = fdmex->LoadModel( ... );

When an aircraft model is loaded, the config file is parsed and for each of the sections of the config file (propulsion, flight control, etc.) the corresponding Load() method is called (e.g. FGFCS::Load()).

Subsequent to the creation of the executive and loading of the model, initialization is performed. Initialization involves copying control inputs into the appropriate JSBSim data storage locations, configuring it for the set of user supplied initial conditions, and then copying state variables from JSBSim. The state variables are used to drive the instrument displays and to place the vehicle model in world space for visual rendering:

copy_to_JSBsim(); // copy control inputs to JSBSim
fdmex->RunIC(); // loop JSBSim once w/o integrating
copy_from_JSBsim(); // update the bus

Once initialization is complete, cyclic execution proceeds:

copy_to_JSBsim(); // copy control inputs to JSBSim
fdmex->Run(); // execute JSBSim
copy_from_JSBsim(); // update the bus

JSBSim can be used in a standalone mode by creating a compact stub program that effectively performs the same progression of steps as outlined above for the integrated version, but with two exceptions. First, the copy_to_JSBSim() and copy_from_JSBSim() functions are not used because the control inputs are handled directly by the scripting facilities and outputs are handled by the output (data logging) class. Second, the name of a script file can be supplied to the stub program. Scripting (see FGScript) provides a way to supply command inputs to the simulation:

FDMExec = new JSBSim::FGFDMExec();
FDMExec->LoadScript( ScriptName ); // the script loads the aircraft and ICs
result = FDMExec->Run();
while (result) { // cyclic execution
  result = FDMExec->Run(); // execute JSBSim
}

The standalone mode has been useful for verifying changes before committing updates to the source code repository. It is also useful for running sets of tests that reveal some aspects of simulated aircraft performance, such as range, time-to-climb, takeoff distance, etc.

JSBSim Debugging Directives

This describes to any interested entity the debug level requested by setting the JSBSIM_DEBUG environment variable. The bitmasked value choices are as follows:

• unset: In this case (the default) JSBSim would only print out the normally expected messages, essentially echoing the config files as they are read. If the environment variable is not set, debug_lvl is set to 1 internally
• 0: This requests JSBSim not to output any messages whatsoever
• 1: This value explicity requests the normal JSBSim startup messages
• 2: This value asks for a message to be printed out when a class is instantiated
• 4: When this value is set, a message is displayed when a FGModel object executes its Run() method
• 8: When this value is set, various runtime state variables are printed out periodically
• 16: When set various parameters are sanity checked and a message is printed out when they go out of bounds

Properties

• simulator/do_trim (write only) Can be set to the integer equivalent to one of tLongitudinal (0), tFull (1), tGround (2), tPullup (3), tCustom (4), tTurn (5). Setting this to a legal value (such as by a script) causes a trim to be performed. This property actually maps toa function call of DoTrim().

Author

Jon S. Berndt

Version

Revision

1.106

Definition at line 184 of file FGFDMExec.h.

#include <FGFDMExec.h>

Inheritance diagram for FGFDMExec:

Collaboration diagram for FGFDMExec:

Classes
struct	PropertyCatalogStructure

Public Types
enum	eModels {   ePropagate =0 , eInput , eInertial , eAtmosphere ,   eWinds , eSystems , eMassBalance , eAuxiliary ,   ePropulsion , eAerodynamics , eGroundReactions , eExternalReactions ,   eBuoyantForces , eAircraft , eAccelerations , eOutput ,   eNumStandardModels }
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...

Public Member Functions
	FGFDMExec (FGPropertyManager *root=nullptr, std::shared_ptr< unsigned int > fdmctr=nullptr)
	Default constructor.
	~FGFDMExec ()
	Default destructor.
void	AddTemplateFunc (const std::string &name, Element *el)
void	BuildPropertyCatalog (struct PropertyCatalogStructure *pcs)
	Builds a catalog of properties.
void	CheckIncrementalHold (void)
	Checks if required to hold afer increment.
void	DisableOutput (void)
	Disables data logging to all outputs.
void	DoLinearization (int)
	Executes linearization with state-space output You must trim first to get an accurate state-space model.
void	DoTrim (int mode)
	Executes trimming in the selected mode.
void	EnableIncrementThenHold (int Timesteps)
	Turn on hold after increment.
void	EnableOutput (void)
	Enables data logging to all outputs.
std::vector< std::string >	EnumerateFDMs (void)
	Returns a vector of strings representing the names of all loaded models (future)
void	ForceOutput (int idx=0)
	Forces the specified output object to print its items once.
const SGPath &	GetAircraftPath (void)
	Retrieves the aircraft path.
auto	GetChildFDM (int i) const
	Gets a particular child FDM.
int	GetDebugLevel (void) const
	Retrieves the current debug level setting.
double	GetDeltaT (void) const
	Returns the simulation delta T.
const SGPath &	GetEnginePath (void)
	Retrieves the engine path.
size_t	GetFDMCount (void) const
	Gets the number of child FDMs.
unsigned int	GetFrame (void) const
	Retrieves the current frame count.
const SGPath &	GetFullAircraftPath (void)
	Retrieves the full aircraft path name.
bool	GetHoldDown (void) const
	Gets the value of the property forces/hold-down.
const std::string &	GetModelName (void) const
	Returns the model name.
std::string	GetOutputFileName (int n) const
	Retrieves the current output filename.
const SGPath &	GetOutputPath (void)
	Retrieves the path to the output files.
std::vector< std::string > &	GetPropertyCatalog (void)
std::shared_ptr< FGPropertyManager >	GetPropertyManager (void) const
	Returns a pointer to the property manager object.
double	GetPropertyValue (const std::string &property)
	Retrieves the value of a property.
std::string	GetPropulsionTankReport () const
auto	GetRandomGenerator (void) const
const SGPath &	GetRootDir (void) const
	Retrieve the Root Directory.
double	GetSimTime (void) const
	Returns the cumulative simulation time in seconds.
const SGPath &	GetSystemsPath (void)
	Retrieves the systems path.
FGTemplateFunc_ptr	GetTemplateFunc (const std::string &name)
int	GetTrimMode (void) const
bool	GetTrimStatus (void) const
void	Hold (void)
	Pauses execution by preventing time from incrementing.
bool	Holding (void)
	Returns true if the simulation is Holding (i.e. simulation time is not moving).
double	IncrTime (void)
	Increments the simulation time if not in Holding mode.
void	Initialize (const FGInitialCondition *FGIC)
	Initializes the simulation with initial conditions.
bool	IntegrationSuspended (void) const
	Returns the simulation suspension state.
bool	LoadModel (const SGPath &AircraftPath, const SGPath &EnginePath, const SGPath &SystemsPath, const std::string &model, bool addModelToPath=true)
	Loads an aircraft model.
bool	LoadModel (const std::string &model, bool addModelToPath=true)
	Loads an aircraft model.
bool	LoadPlanet (const SGPath &PlanetPath, bool useAircraftPath=true)
	Loads the planet.
bool	LoadScript (const SGPath &Script, double deltaT=0.0, const SGPath &initfile=SGPath())
	Load a script.
void	PrintPropertyCatalog (void)
void	PrintSimulationConfiguration (void) const
std::string	QueryPropertyCatalog (const std::string &check, const std::string &end_of_line="\n")
	Retrieves property or properties matching the supplied string.
void	ResetToInitialConditions (int mode)
	Resets the initial conditions object and prepares the simulation to run again.
void	Resume (void)
	Resumes execution from a "Hold".
void	ResumeIntegration (void)
	Resumes the simulation by resetting delta T to the correct value.
bool	Run (void)
	This function executes each scheduled model in succession.
bool	RunIC (void)
	Initializes the sim from the initial condition object and executes each scheduled model without integrating i.e.
bool	SetAircraftPath (const SGPath &path)
	Set the path to the aircraft config file directories.
void	SetChild (bool ch)
	Marks this instance of the Exec object as a "child" object.
void	SetDebugLevel (int level)
	Sets the debug level.
void	Setdt (double delta_t)
	Sets the integration time step for the simulation executive.
bool	SetEnginePath (const SGPath &path)
	Set the path to the engine config file directories.
void	SetHoldDown (bool hd)
	Sets the property forces/hold-down.
void	SetLoggingRate (double rate)
	Sets the logging rate in Hz for all output objects (if any).
bool	SetOutputDirectives (const SGPath &fname)
	Sets the output (logging) mechanism for this run.
bool	SetOutputFileName (const int n, const std::string &fname)
	Sets (or overrides) the output filename.
bool	SetOutputPath (const SGPath &path)
	Set the directory where the output files will be written.
void	SetPropertyValue (const std::string &property, double value)
	Sets a property value.
void	SetRootDir (const SGPath &rootDir)
	Set the root directory that is used to obtain absolute paths from relative paths.
double	Setsim_time (double cur_time)
	Sets the current sim time.
bool	SetSystemsPath (const SGPath &path)
	Set the path to the systems config file directories.
void	SetTrimMode (int mode)
void	SetTrimStatus (bool status)
int	SRand (void) const
void	SuspendIntegration (void)
	Suspends the simulation and sets the delta T to zero.
void	Unbind (void)
	Unbind all tied JSBSim properties.
Top-level executive State and Model retrieval mechanism
Returns the FGAtmosphere pointer.
std::shared_ptr< FGAtmosphere >	GetAtmosphere (void) const
std::shared_ptr< FGAccelerations >	GetAccelerations (void) const
	Returns the FGAccelerations pointer.
std::shared_ptr< FGWinds >	GetWinds (void) const
	Returns the FGWinds pointer.
std::shared_ptr< FGFCS >	GetFCS (void) const
	Returns the FGFCS pointer.
std::shared_ptr< FGPropulsion >	GetPropulsion (void) const
	Returns the FGPropulsion pointer.
std::shared_ptr< FGMassBalance >	GetMassBalance (void) const
	Returns the FGAircraft pointer.
std::shared_ptr< FGAerodynamics >	GetAerodynamics (void) const
	Returns the FGAerodynamics pointer.
std::shared_ptr< FGInertial >	GetInertial (void) const
	Returns the FGInertial pointer.
std::shared_ptr< FGGroundReactions >	GetGroundReactions (void) const
	Returns the FGGroundReactions pointer.
std::shared_ptr< FGExternalReactions >	GetExternalReactions (void) const
	Returns the FGExternalReactions pointer.
std::shared_ptr< FGBuoyantForces >	GetBuoyantForces (void) const
	Returns the FGBuoyantForces pointer.
std::shared_ptr< FGAircraft >	GetAircraft (void) const
	Returns the FGAircraft pointer.
std::shared_ptr< FGPropagate >	GetPropagate (void) const
	Returns the FGPropagate pointer.
std::shared_ptr< FGAuxiliary >	GetAuxiliary (void) const
	Returns the FGAuxiliary pointer.
std::shared_ptr< FGInput >	GetInput (void) const
	Returns the FGInput pointer.
std::shared_ptr< FGOutput >	GetOutput (void) const
	Returns the FGOutput pointer.
std::shared_ptr< FGScript >	GetScript (void) const
	Retrieves the script object.
std::shared_ptr< FGInitialCondition >	GetIC (void) const
	Returns a pointer to the FGInitialCondition object.
std::shared_ptr< FGTrim >	GetTrim (void)
	Returns a pointer to the FGTrim object.
Public Member Functions inherited from FGJSBBase
	FGJSBBase ()
	Constructor for FGJSBBase.
virtual	~FGJSBBase ()
	Destructor for FGJSBBase.
void	disableHighLighting (void)
	Disables highlighting in the console output.

Static Public Attributes
static const int	DONT_EXECUTE_RUN_IC = 0x2
static const int	START_NEW_OUTPUT = 0x1
	Mode flags for ResetToInitialConditions.
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

Additional Inherited Members
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 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/(fttom*fttom*fttom)
static constexpr double	in3tom3 = inchtoft*inchtoft*inchtoft/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__

Member Enumeration Documentation

eModels

enum eModels

Definition at line 225 of file FGFDMExec.h.

               { ePropagate=0,
                 eInput,
                 eInertial,
                 eAtmosphere,
                 eWinds,
                 eSystems,
                 eMassBalance,
                 eAuxiliary,
                 ePropulsion,
                 eAerodynamics,
                 eGroundReactions,
                 eExternalReactions,
                 eBuoyantForces,
                 eAircraft,
                 eAccelerations,
                 eOutput,
                 eNumStandardModels };

Constructor & Destructor Documentation

FGFDMExec()

FGFDMExec	(	FGPropertyManager *	root = nullptr,
		std::shared_ptr< unsigned int >	fdmctr = nullptr
	)

Default constructor.

Definition at line 80 of file FGFDMExec.cpp.

  : RandomSeed(0), RandomGenerator(make_shared<RandomNumberGenerator>(RandomSeed)),
    FDMctr(fdmctr)
{
  Frame           = 0;
  disperse        = 0;
 
  RootDir = "";
 
  modelLoaded = false;
  IsChild = false;
  holding = false;
  Terminate = false;
  HoldDown = false;
 
  IncrementThenHolding = false;  // increment then hold is off by default
  TimeStepsUntilHold = -1;
 
  sim_time = 0.0;
  dT = 1.0/120.0; // a default timestep size. This is needed for when JSBSim is
                  // run in standalone mode with no initialization file.
 
  AircraftPath = "aircraft";
  EnginePath = "engine";
  SystemsPath = "systems";
 
  if (const char* num = getenv("JSBSIM_DEBUG"); num != nullptr)
    debug_lvl = strtol(num, nullptr, 0);
 
  if (!FDMctr) {
    FDMctr = std::make_shared<unsigned int>(); // Create and initialize the child FDM counter
    *FDMctr = 0;
  }
 
  // Store this FDM's ID
  IdFDM = *FDMctr; // The main (parent) JSBSim instance is always the "zeroth"
 
  // Prepare FDMctr for the next child FDM id
  (*FDMctr)++;       // instance. "child" instances are loaded last.
 
  if (root == nullptr)          // Then this is the root FDM
    Root = new SGPropertyNode();
  else
    Root = root->GetNode();
 
  SGPropertyNode* instanceRoot = Root->getNode("fdm/jsbsim", IdFDM, true);
  instance = std::make_shared<FGPropertyManager>(instanceRoot);
 
  if (const char* num = getenv("JSBSIM_DISPERSE");
      num != nullptr && strtol(num, nullptr, 0) != 0)
  {
    disperse = 1;  // set dispersions on
  }
 
  Debug(0);
  // this is to catch errors in binding member functions to the property tree.
  try {
    Allocate();
  } catch (const BaseException& e) {
    LogException err;
    err << endl << "Caught error: " << e.what() << endl;
    throw err;
  }
 
  trim_status = false;
  ta_mode     = 99;
  trim_completed = 0;
 
  Constructing = true;
  instance->Tie<FGFDMExec, int>("simulation/do_simple_trim", this, nullptr, &FGFDMExec::DoTrim);
  instance->Tie<FGFDMExec, int>("simulation/do_linearization", this, nullptr, &FGFDMExec::DoLinearization);
  instance->Tie<FGFDMExec, int>("simulation/reset", this, nullptr, &FGFDMExec::ResetToInitialConditions);
  instance->Tie("simulation/disperse", this, &FGFDMExec::GetDisperse);
  instance->Tie("simulation/randomseed", this, &FGFDMExec::SRand, &FGFDMExec::SRand);
  instance->Tie("simulation/terminate", &Terminate);
  instance->Tie("simulation/pause", &holding);
  instance->Tie("simulation/sim-time-sec", this, &FGFDMExec::GetSimTime);
  instance->Tie("simulation/dt", this, &FGFDMExec::GetDeltaT);
  instance->Tie("simulation/jsbsim-debug", this, &FGFDMExec::GetDebugLevel, &FGFDMExec::SetDebugLevel);
  instance->Tie("simulation/frame", reinterpret_cast<int*>(&Frame));
  instance->Tie("simulation/trim-completed", &trim_completed);
  instance->Tie("forces/hold-down", this, &FGFDMExec::GetHoldDown, &FGFDMExec::SetHoldDown);
 
  Constructing = false;
}

Here is the call graph for this function:

~FGFDMExec()

~FGFDMExec

(

)

Default destructor.

Definition at line 168 of file FGFDMExec.cpp.

{
  try {
    Unbind();
    DeAllocate();
  } catch (const string& msg ) {
    FGLogging log(LogLevel::FATAL);
    log << "Caught error: " << msg << endl;
  }
 
  if (!FDMctr) (*FDMctr)--;
 
  Debug(1);
}

Here is the call graph for this function:

Member Function Documentation

AddTemplateFunc()

void AddTemplateFunc ( const std::string &  name, Element *  el  )

inline

Definition at line 623 of file FGFDMExec.h.

                                                           {
    TemplateFunctions[name] = std::make_shared<FGTemplateFunc>(this, el);
  }

BuildPropertyCatalog()

void BuildPropertyCatalog

(

struct PropertyCatalogStructure *

pcs

)

Builds a catalog of properties.

This function descends the property tree and creates a list (an STL vector) containing the name and node for all properties.

Parameters

pcs	The "root" property catalog structure pointer.

Definition at line 1083 of file FGFDMExec.cpp.

{
  auto pcsNew = std::make_unique<struct PropertyCatalogStructure>();
  const SGPropertyNode* root_node = instance->GetNode();
  const string root_name = GetFullyQualifiedName(root_node) + "/";
  const size_t root_name_length = root_name.length();
 
  for (int i=0; i<pcs->node->nChildren(); i++) {
    string access="";
    pcsNew->base_string = pcs->base_string + "/" + pcs->node->getChild(i)->getNameString();
    int node_idx = pcs->node->getChild(i)->getIndex();
    if (node_idx != 0) {
      pcsNew->base_string = CreateIndexedPropertyName(pcsNew->base_string, node_idx);
    }
    if (pcs->node->getChild(i)->nChildren() == 0) {
      if (pcsNew->base_string.substr(0, root_name_length) == root_name) {
        pcsNew->base_string = pcsNew->base_string.erase(0, root_name_length);
      }
      if (pcs->node->getChild(i)->getAttribute(SGPropertyNode::READ)) access="R";
      if (pcs->node->getChild(i)->getAttribute(SGPropertyNode::WRITE)) access+="W";
      PropertyCatalog.push_back(pcsNew->base_string+" ("+access+")");
    } else {
      pcsNew->node = pcs->node->getChild(i);
      BuildPropertyCatalog(pcsNew.get());
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

CheckIncrementalHold()

void CheckIncrementalHold

(

void

)

Checks if required to hold afer increment.

Definition at line 1306 of file FGFDMExec.cpp.

{
  // Only check if increment then hold is on
  if( IncrementThenHolding ) {
 
    if (TimeStepsUntilHold == 0) {
 
      // Should hold simulation if TimeStepsUntilHold has reached zero
      holding = true;
 
      // Still need to decrement TimeStepsUntilHold as value of -1
      // indicates that incremental then hold is turned off
      IncrementThenHolding = false;
      TimeStepsUntilHold--;
 
    } else if ( TimeStepsUntilHold > 0 ) {
      // Keep decrementing until 0 is reached
      TimeStepsUntilHold--;
    }
  }
}

DisableOutput()

void DisableOutput ( void  )

inline

Disables data logging to all outputs.

Definition at line 485 of file FGFDMExec.h.

{ Output->Disable(); }

DoLinearization()

void DoLinearization

(

int

)

Executes linearization with state-space output You must trim first to get an accurate state-space model.

Definition at line 1351 of file FGFDMExec.cpp.

{
  double dt0 = this->GetDeltaT();
  FGLinearization lin(this);
  lin.WriteScicoslab();
  this->Setdt(dt0);
}

Here is the call graph for this function:

Here is the caller graph for this function:

DoTrim()

void DoTrim

(

int

mode

)

Executes trimming in the selected mode.

Parameters

mode	Specifies how to trim: tLongitudinal=0 tFull tGround tPullup tCustom tTurn tNone

Definition at line 1330 of file FGFDMExec.cpp.

{
  if (Constructing) return;
 
  if (mode < 0 || mode > JSBSim::tNone)
    throw TrimFailureException("Illegal trimming mode!");
 
  FGTrim trim(this, (JSBSim::TrimMode)mode);
  bool success = trim.DoTrim();
 
  if (debug_lvl > 0)
    trim.Report();
 
  if (!success)
    throw TrimFailureException("Trim Failed");
 
  trim_completed = 1;
}

Here is the caller graph for this function:

EnableIncrementThenHold()

void EnableIncrementThenHold ( int  Timesteps )

inline

Turn on hold after increment.

Definition at line 491 of file FGFDMExec.h.

{TimeStepsUntilHold = Timesteps; IncrementThenHolding = true;}

Here is the caller graph for this function:

EnableOutput()

void EnableOutput ( void  )

inline

Enables data logging to all outputs.

Definition at line 487 of file FGFDMExec.h.

{ Output->Enable(); }

EnumerateFDMs()

vector< string > EnumerateFDMs

(

void

)

Returns a vector of strings representing the names of all loaded models (future)

Definition at line 717 of file FGFDMExec.cpp.

{
  vector <string> FDMList;
  FDMList.push_back(Aircraft->GetAircraftName());
 
  for (auto &ChildFDM: ChildFDMList)
    FDMList.push_back(ChildFDM->exec->GetAircraft()->GetAircraftName());
 
  return FDMList;
}

Here is the call graph for this function:

ForceOutput()

void ForceOutput ( int  idx = 0 )

inline

Forces the specified output object to print its items once.

Definition at line 451 of file FGFDMExec.h.

{ Output->ForceOutput(idx); }

GetAccelerations()

std::shared_ptr< FGAccelerations > GetAccelerations

(

void

)

const

Returns the FGAccelerations pointer.

Definition at line 367 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGAccelerations>(Models[eAccelerations]);
}

Here is the caller graph for this function:

GetAerodynamics()

std::shared_ptr< FGAerodynamics > GetAerodynamics

(

void

)

const

Returns the FGAerodynamics pointer.

Definition at line 332 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGAerodynamics>(Models[eAerodynamics]);
}

Here is the caller graph for this function:

GetAircraft()

std::shared_ptr< FGAircraft > GetAircraft

(

void

)

const

Returns the FGAircraft pointer.

Definition at line 360 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGAircraft>(Models[eAircraft]);
}

Here is the caller graph for this function:

GetAircraftPath()

const SGPath & GetAircraftPath ( void  )

inline

Retrieves the aircraft path.

Definition at line 398 of file FGFDMExec.h.

{ return AircraftPath; }

GetAtmosphere()

std::shared_ptr< FGAtmosphere > GetAtmosphere

(

void

)

const

Definition at line 290 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGAtmosphere>(Models[eAtmosphere]);
}

GetAuxiliary()

std::shared_ptr< FGAuxiliary > GetAuxiliary

(

void

)

const

Returns the FGAuxiliary pointer.

Definition at line 318 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGAuxiliary>(Models[eAuxiliary]);
}

Here is the caller graph for this function:

GetBuoyantForces()

std::shared_ptr< FGBuoyantForces > GetBuoyantForces

(

void

)

const

Returns the FGBuoyantForces pointer.

Definition at line 353 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGBuoyantForces>(Models[eBuoyantForces]);
}

Here is the caller graph for this function:

GetChildFDM()

auto GetChildFDM ( int  i ) const

inline

Gets a particular child FDM.

Definition at line 428 of file FGFDMExec.h.

{return ChildFDMList[i];}

Here is the caller graph for this function:

GetDebugLevel()

int GetDebugLevel ( void  ) const

inline

Retrieves the current debug level setting.

Definition at line 602 of file FGFDMExec.h.

{return debug_lvl;};

Here is the caller graph for this function:

GetDeltaT()

double GetDeltaT ( void  ) const

inline

Returns the simulation delta T.

Definition at line 553 of file FGFDMExec.h.

{return dT;}

Here is the caller graph for this function:

GetEnginePath()

const SGPath & GetEnginePath ( void  )

inline

Retrieves the engine path.

Definition at line 396 of file FGFDMExec.h.

{ return EnginePath; }

GetExternalReactions()

std::shared_ptr< FGExternalReactions > GetExternalReactions

(

void

)

const

Returns the FGExternalReactions pointer.

Definition at line 346 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGExternalReactions>(Models[eExternalReactions]);
}

Here is the caller graph for this function:

GetFCS()

std::shared_ptr< FGFCS > GetFCS

(

void

)

const

Returns the FGFCS pointer.

Definition at line 304 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGFCS>(Models[eSystems]);
}

Here is the caller graph for this function:

GetFDMCount()

size_t GetFDMCount ( void  ) const

inline

Gets the number of child FDMs.

Definition at line 426 of file FGFDMExec.h.

{return ChildFDMList.size();}

Here is the caller graph for this function:

GetFrame()

unsigned int GetFrame ( void  ) const

inline

Retrieves the current frame count.

Definition at line 599 of file FGFDMExec.h.

{return Frame;}

GetFullAircraftPath()

const SGPath & GetFullAircraftPath ( void  )

inline

Retrieves the full aircraft path name.

Definition at line 402 of file FGFDMExec.h.

{ return FullAircraftPath; }

Here is the caller graph for this function:

GetGroundReactions()

std::shared_ptr< FGGroundReactions > GetGroundReactions

(

void

)

const

Returns the FGGroundReactions pointer.

Definition at line 339 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGGroundReactions>(Models[eGroundReactions]);
}

Here is the caller graph for this function:

GetHoldDown()

bool GetHoldDown ( void  ) const

inline

Gets the value of the property forces/hold-down.

Returns

zero if the 'hold-down' function is disabled, non-zero otherwise.

Definition at line 617 of file FGFDMExec.h.

{return HoldDown;}

Here is the caller graph for this function:

GetIC()

std::shared_ptr< FGInitialCondition > GetIC ( void  ) const

inline

Returns a pointer to the FGInitialCondition object.

Definition at line 390 of file FGFDMExec.h.

{return IC;}

Here is the caller graph for this function:

GetInertial()

std::shared_ptr< FGInertial > GetInertial

(

void

)

const

Returns the FGInertial pointer.

Definition at line 276 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGInertial>(Models[eInertial]);
}

Here is the caller graph for this function:

GetInput()

std::shared_ptr< FGInput > GetInput

(

void

)

const

Returns the FGInput pointer.

Definition at line 283 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGInput>(Models[eInput]);
}

Here is the caller graph for this function:

GetMassBalance()

std::shared_ptr< FGMassBalance > GetMassBalance

(

void

)

const

Returns the FGAircraft pointer.

Definition at line 311 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGMassBalance>(Models[eMassBalance]);
}

Here is the caller graph for this function:

GetModelName()

const std::string & GetModelName ( void  ) const

inline

Returns the model name.

Definition at line 419 of file FGFDMExec.h.

{ return modelName; }

GetOutput()

std::shared_ptr< FGOutput > GetOutput

(

void

)

const

Returns the FGOutput pointer.

Definition at line 374 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGOutput>(Models[eOutput]);
}

Here is the caller graph for this function:

GetOutputFileName()

std::string GetOutputFileName ( int  n ) const

inline

Retrieves the current output filename.

Parameters

n	index of file

Returns

the name of the output file for the output specified by the flight model. If none is specified, the empty string is returned.

Definition at line 466 of file FGFDMExec.h.

{ return Output->GetOutputName(n); }

GetOutputPath()

const SGPath & GetOutputPath ( void  )

inline

Retrieves the path to the output files.

Definition at line 404 of file FGFDMExec.h.

{ return OutputPath; }

Here is the caller graph for this function:

GetPropagate()

std::shared_ptr< FGPropagate > GetPropagate

(

void

)

const

Returns the FGPropagate pointer.

Definition at line 269 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGPropagate>(Models[ePropagate]);
}

Here is the caller graph for this function:

GetPropertyCatalog()

std::vector< std::string > & GetPropertyCatalog ( void  )

inline

Definition at line 540 of file FGFDMExec.h.

{return PropertyCatalog;}

GetPropertyManager()

std::shared_ptr< FGPropertyManager > GetPropertyManager ( void  ) const

inline

Returns a pointer to the property manager object.

Definition at line 422 of file FGFDMExec.h.

{ return instance; }

Here is the caller graph for this function:

GetPropertyValue()

double GetPropertyValue ( const std::string &  property )

inline

Retrieves the value of a property.

Parameters

property

the name of the property

Returns

the value of the specified property

Definition at line 409 of file FGFDMExec.h.

  { return instance->GetNode()->getDoubleValue(property.c_str()); }

GetPropulsion()

std::shared_ptr< FGPropulsion > GetPropulsion

(

void

)

const

Returns the FGPropulsion pointer.

Definition at line 325 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGPropulsion>(Models[ePropulsion]);
}

Here is the caller graph for this function:

GetPropulsionTankReport()

string GetPropulsionTankReport

(

)

const

Definition at line 1076 of file FGFDMExec.cpp.

{
  return Propulsion->GetPropulsionTankReport();
}

GetRandomGenerator()

auto GetRandomGenerator ( void  ) const

inline

Definition at line 627 of file FGFDMExec.h.

{ return RandomGenerator; }

GetRootDir()

const SGPath & GetRootDir ( void  ) const

inline

Retrieve the Root Directory.

Returns

the path to the root (base) JSBSim directory.

See also

SetRootDir

Definition at line 591 of file FGFDMExec.h.

{return RootDir;}

GetScript()

std::shared_ptr< FGScript > GetScript ( void  ) const

inline

Retrieves the script object.

Definition at line 388 of file FGFDMExec.h.

{return Script;}

GetSimTime()

double GetSimTime ( void  ) const

inline

Returns the cumulative simulation time in seconds.

Definition at line 550 of file FGFDMExec.h.

{ return sim_time; }

Here is the caller graph for this function:

GetSystemsPath()

const SGPath & GetSystemsPath ( void  )

inline

Retrieves the systems path.

Definition at line 400 of file FGFDMExec.h.

{ return SystemsPath; }

GetTemplateFunc()

FGTemplateFunc_ptr GetTemplateFunc ( const std::string &  name )

inline

Definition at line 619 of file FGFDMExec.h.

                                                            {
    return TemplateFunctions.count(name) ? TemplateFunctions[name] : nullptr;
  }

GetTrim()

std::shared_ptr< FGTrim > GetTrim

(

void

)

Returns a pointer to the FGTrim object.

Definition at line 1298 of file FGFDMExec.cpp.

{
  Trim = std::make_shared<FGTrim>(this,tNone);
  return Trim;
}

GetTrimMode()

int GetTrimMode ( void  ) const

inline

Definition at line 545 of file FGFDMExec.h.

{ return ta_mode; }

GetTrimStatus()

bool GetTrimStatus ( void  ) const

inline

Definition at line 543 of file FGFDMExec.h.

{ return trim_status; }

GetWinds()

std::shared_ptr< FGWinds > GetWinds

(

void

)

const

Returns the FGWinds pointer.

Definition at line 297 of file FGFDMExec.cpp.

{
  return static_pointer_cast<FGWinds>(Models[eWinds]);
}

Here is the caller graph for this function:

Hold()

void Hold ( void  )

inline

Pauses execution by preventing time from incrementing.

Definition at line 489 of file FGFDMExec.h.

{holding = true;}

Here is the caller graph for this function:

Holding()

bool Holding ( void  )

inline

Returns true if the simulation is Holding (i.e. simulation time is not moving).

Definition at line 497 of file FGFDMExec.h.

{return holding;}

IncrTime()

double IncrTime

(

void

)

Increments the simulation time if not in Holding mode.

The Frame counter is also incremented.

Returns

the new simulation time.

Definition at line 193 of file FGFDMExec.cpp.

                               {
  if (!holding && !IntegrationSuspended()) {
    sim_time += dT;
    Inertial->SetTime(sim_time);
    Frame++;
  }
  return sim_time;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Initialize()

void Initialize

(

const FGInitialCondition *

FGIC

)

Initializes the simulation with initial conditions.

Parameters

FGIC	The initial conditions that will be passed to the simulation.

Definition at line 673 of file FGFDMExec.cpp.

{
  Propagate->SetInitialState(FGIC);
  Winds->SetWindNED(FGIC->GetWindNEDFpsIC());
  Auxiliary->SetInitialState(FGIC);
  Run();
}

Here is the call graph for this function:

Here is the caller graph for this function:

IntegrationSuspended()

bool IntegrationSuspended ( void  ) const

inline

Returns the simulation suspension state.

Returns

true if suspended, false if executing

Definition at line 563 of file FGFDMExec.h.

{return dT == 0.0;}

Here is the caller graph for this function:

LoadModel() [1/2]

bool LoadModel	(	const SGPath &	AircraftPath,
		const SGPath &	EnginePath,
		const SGPath &	SystemsPath,
		const std::string &	model,
		bool	addModelToPath = true
	)

Loads an aircraft model.

Parameters

AircraftPath	path to the aircraft/ directory. For instance: "aircraft". Under aircraft, then, would be directories for various modeled aircraft such as C172/, x15/, etc.
EnginePath	path to the directory under which engine config files are kept, for instance "engine"
SystemsPath	path to the directory under which systems config files are kept, for instance "systems"
model	the name of the aircraft model itself. This file will be looked for in the directory specified in the AircraftPath variable, and in turn under the directory with the same name as the model. For instance: "aircraft/x15/x15.xml"
addModelToPath	set to true to add the model name to the AircraftPath, defaults to true

Returns

true if successful

Definition at line 816 of file FGFDMExec.cpp.

{
  FGFDMExec::AircraftPath = GetFullPath(AircraftPath);
  FGFDMExec::EnginePath = GetFullPath(EnginePath);
  FGFDMExec::SystemsPath = GetFullPath(SystemsPath);
 
  return LoadModel(model, addModelToPath);
}

Here is the call graph for this function:

Here is the caller graph for this function:

LoadModel() [2/2]

bool LoadModel	(	const std::string &	model,
		bool	addModelToPath = true
	)

Loads an aircraft model.

The paths to the aircraft and engine config file directories must be set prior to calling this. See below.

Parameters

model	the name of the aircraft model itself. This file will be looked for in the directory specified in the AircraftPath variable, and in turn under the directory with the same name as the model. For instance: "aircraft/x15/x15.xml"
addModelToPath	set to true to add the model name to the AircraftPath, defaults to true

Returns

true if successful

Definition at line 829 of file FGFDMExec.cpp.

{
  SGPath aircraftCfgFileName;
  bool result = false; // initialize result to false, indicating input file not yet read
 
  modelName = model; // Set the class modelName attribute
 
  if( AircraftPath.isNull() || EnginePath.isNull() || SystemsPath.isNull()) {
    FGLogging log(LogLevel::ERROR);
    log << "Error: attempted to load aircraft with undefined "
        << "aircraft, engine, and system paths" << endl;
    return false;
  }
 
  FullAircraftPath = AircraftPath;
  if (addModelToPath) FullAircraftPath.append(model);
  aircraftCfgFileName = FullAircraftPath/(model + ".xml");
 
  if (modelLoaded) {
    DeAllocate();
    Allocate();
  }
 
  int saved_debug_lvl = debug_lvl;
  FGXMLFileRead XMLFileRead;
  Element *document = XMLFileRead.LoadXMLDocument(aircraftCfgFileName); // "document" is a class member
 
  if (document) {
    if (IsChild) debug_lvl = 0;
 
    ReadPrologue(document);
 
    if (IsChild) debug_lvl = saved_debug_lvl;
 
    // Process the fileheader element in the aircraft config file. This element is OPTIONAL.
    Element* element = document->FindElement("fileheader");
    if (element) {
      result = ReadFileHeader(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft fileheader element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    }
 
    if (IsChild) debug_lvl = 0;
 
    // Process the planet element. This element is OPTIONAL.
    element = document->FindElement("planet");
    if (element) {
      result = LoadPlanet(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Planet element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    }
 
    // Process the metrics element. This element is REQUIRED.
    element = document->FindElement("metrics");
    if (element) {
      result = Models[eAircraft]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft metrics element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    } else {
      FGLogging log(LogLevel::ERROR);
      log << endl << "No metrics element was found in the aircraft config file." << endl;
      return false;
    }
 
    // Process the mass_balance element. This element is REQUIRED.
    element = document->FindElement("mass_balance");
    if (element) {
      result = Models[eMassBalance]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft mass_balance element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    } else {
      FGLogging log(LogLevel::ERROR);
      log << endl << "No mass_balance element was found in the aircraft config file." << endl;
      return false;
    }
 
    // Process the ground_reactions element. This element is REQUIRED.
    element = document->FindElement("ground_reactions");
    if (element) {
      result = Models[eGroundReactions]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl
            << "Aircraft ground_reactions element has problems in file "
            << aircraftCfgFileName << endl;
        return result;
      }
    } else {
      FGLogging log(LogLevel::ERROR);
      log << endl << "No ground_reactions element was found in the aircraft config file." << endl;
      return false;
    }
 
    // Process the external_reactions element. This element is OPTIONAL.
    element = document->FindElement("external_reactions");
    if (element) {
      result = Models[eExternalReactions]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft external_reactions element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    }
 
    // Process the buoyant_forces element. This element is OPTIONAL.
    element = document->FindElement("buoyant_forces");
    if (element) {
      result = Models[eBuoyantForces]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft buoyant_forces element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    }
 
    // Process the propulsion element. This element is OPTIONAL.
    element = document->FindElement("propulsion");
    if (element) {
      result = Propulsion->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft propulsion element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
      for (unsigned int i=0; i < Propulsion->GetNumEngines(); i++)
        FCS->AddThrottle();
    }
 
    // Process the system element[s]. This element is OPTIONAL, and there may be more than one.
    element = document->FindElement("system");
    while (element) {
      result = Models[eSystems]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft system element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
      element = document->FindNextElement("system");
    }
 
    // Process the autopilot element. This element is OPTIONAL.
    element = document->FindElement("autopilot");
    if (element) {
      result = Models[eSystems]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft autopilot element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    }
 
    // Process the flight_control element. This element is OPTIONAL.
    element = document->FindElement("flight_control");
    if (element) {
      result = Models[eSystems]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft flight_control element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    }
 
    // Process the aerodynamics element. This element is OPTIONAL, but almost always expected.
    element = document->FindElement("aerodynamics");
    if (element) {
      result = Models[eAerodynamics]->Load(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft aerodynamics element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    } else {
      FGLogging log(LogLevel::ERROR);
      log << endl << "No expected aerodynamics element was found in the aircraft config file." << endl;
    }
 
    // Process the input element. This element is OPTIONAL, and there may be more than one.
    element = document->FindElement("input");
    while (element) {
      if (!Input->Load(element))
        return false;
 
      element = document->FindNextElement("input");
    }
 
    // Process the output element[s]. This element is OPTIONAL, and there may be
    // more than one.
    element = document->FindElement("output");
    while (element) {
      if (!Output->Load(element))
        return false;
 
      element = document->FindNextElement("output");
    }
 
    // Lastly, process the child element. This element is OPTIONAL - and NOT YET SUPPORTED.
    element = document->FindElement("child");
    if (element) {
      result = ReadChild(element);
      if (!result) {
        FGXMLLogging log(element, LogLevel::ERROR);
        log << endl << "Aircraft child element has problems in file " << aircraftCfgFileName << endl;
        return result;
      }
    }
 
    // Since all vehicle characteristics have been loaded, place the values in the Inputs
    // structure for the FGModel-derived classes.
    LoadModelConstants();
 
    modelLoaded = true;
 
    if (IsChild) debug_lvl = saved_debug_lvl;
 
  } else {
    FGLogging log(LogLevel::ERROR);
    log << LogFormat::RED
        << "  JSBSim failed to open the configuration file: " << aircraftCfgFileName
        << LogFormat::DEFAULT << endl;
  }
 
  for (unsigned int i=0; i< Models.size(); i++) LoadInputs(i);
 
  if (result) {
    struct PropertyCatalogStructure masterPCS;
    masterPCS.base_string = "";
    masterPCS.node = Root;
    BuildPropertyCatalog(&masterPCS);
  }
 
  return result;
}

Here is the call graph for this function:

LoadPlanet()

bool LoadPlanet	(	const SGPath &	PlanetPath,
		bool	useAircraftPath = true
	)

Loads the planet.

Loads the definition of the planet on which the vehicle will evolve such as its radius, gravity or its atmosphere characteristics.

Parameters

PlanetPath	The name of a planet definition file
useAircraftPath	true if path is given relative to the aircraft path.

Returns

true if successful

Definition at line 739 of file FGFDMExec.cpp.

{
  SGPath PlanetFileName;
 
  if(useAircraftPath && PlanetPath.isRelative()) {
    PlanetFileName = AircraftPath/PlanetPath.utf8Str();
  } else {
    PlanetFileName = PlanetPath;
  }
 
  FGXMLFileRead XMLFileRead;
  Element* document = XMLFileRead.LoadXMLDocument(PlanetFileName);
 
  // Make sure that the document is valid
  if (!document) {
    LogException err;
    err << "File: " << PlanetFileName << " could not be read." << endl;
    throw err;
  }
 
  if (document->GetName() != "planet") {
    XMLLogException err(document);
  err << "File: " << PlanetFileName << " is not a planet file." << endl;
  throw err;
  }
 
  bool result = LoadPlanet(document);
 
  if (!result) {
    FGXMLLogging log(document, LogLevel::ERROR);
    log << endl << "Planet element has problems in file " << PlanetFileName << endl;
  }
 
  return result;
}

Here is the call graph for this function:

Here is the caller graph for this function:

LoadScript()

bool LoadScript	(	const SGPath &	Script,
		double	deltaT = 0.0,
		const SGPath &	initfile = SGPath()
	)

Load a script.

Parameters

Script	The full path name and file name for the script to be loaded.
deltaT	The simulation integration step size, if given. If no value is supplied then 0.0 is used and the value is expected to be supplied in the script file itself.
initfile	The initialization file that will override the initialization file specified in the script file. If no file name is given on the command line, the file specified in the script will be used. If an initialization file is not given in either place, an error will result.

Returns

true if successfully loads; false otherwise.

Definition at line 730 of file FGFDMExec.cpp.

{
  Script = std::make_shared<FGScript>(this);
  return Script->LoadScript(GetFullPath(script), deltaT, initfile);
}

PrintPropertyCatalog()

void PrintPropertyCatalog

(

void

)

Definition at line 1125 of file FGFDMExec.cpp.

{
  FGLogging out(LogLevel::STDOUT);
  out << endl
      << "  " << LogFormat::BLUE << highint << LogFormat::UNDERLINE_ON
      << "Property Catalog for " << modelName << LogFormat::RESET << endl << endl;
  for (auto &catalogElm: PropertyCatalog)
    out << "    " << catalogElm << endl;
}

PrintSimulationConfiguration()

void PrintSimulationConfiguration

(

void

)

const

Definition at line 1137 of file FGFDMExec.cpp.

{
  FGLogging log(LogLevel::INFO);
  log << endl << "Simulation Configuration" << endl << "------------------------" << endl;
  log << MassBalance->GetName() << endl;
  log << GroundReactions->GetName() << endl;
  log << Aerodynamics->GetName() << endl;
  log << Propulsion->GetName() << endl;
}

QueryPropertyCatalog()

string QueryPropertyCatalog	(	const std::string &	check,
		const std::string &	end_of_line = "\n"
	)

Retrieves property or properties matching the supplied string.

A string is returned that contains a carriage return delimited list of all strings in the property catalog that matches the supplied check string.

Parameters

check	The string to search for in the property catalog.
end_of_line	End of line (CR+LF if needed for Windows).

Returns

the carriage-return-delimited string containing all matching strings in the catalog.

Definition at line 1113 of file FGFDMExec.cpp.

{
  string results;
  for (auto &catalogElm: PropertyCatalog) {
    if (catalogElm.find(in) != string::npos) results += catalogElm + end_of_line;
  }
  if (results.empty()) return "No matches found"+end_of_line;
  return results;
}

Here is the caller graph for this function:

ResetToInitialConditions()

void ResetToInitialConditions

(

int

mode

)

Resets the initial conditions object and prepares the simulation to run again.

If the mode's first bit is set the output instances will take special actions such as closing the current output file and open a new one with a different name. If the second bit is set then RunIC() won't be executed, leaving it to the caller to call RunIC(), e.g. in case the caller wants to set some other state like control surface deflections which would've been reset.

Parameters

mode	Sets the reset mode.

Definition at line 683 of file FGFDMExec.cpp.

{
  if (Constructing) return;
 
  // mode flags
 
  if (mode & START_NEW_OUTPUT) Output->SetStartNewOutput();
 
  InitializeModels();
 
  if (Script)
    Script->ResetEvents();
  else
    Setsim_time(0.0);
 
  if (!(mode & DONT_EXECUTE_RUN_IC))
    RunIC();
}

Here is the call graph for this function:

Here is the caller graph for this function:

Resume()

void Resume ( void  )

inline

Resumes execution from a "Hold".

Definition at line 495 of file FGFDMExec.h.

{holding = false;}

Here is the caller graph for this function:

ResumeIntegration()

void ResumeIntegration ( void  )

inline

Resumes the simulation by resetting delta T to the correct value.

Definition at line 559 of file FGFDMExec.h.

{dT = saved_dT;}

Here is the caller graph for this function:

Run()

bool Run

(

void

)

This function executes each scheduled model in succession.

Returns

true if successful, false if sim should be ended

Definition at line 404 of file FGFDMExec.cpp.

{
  bool success=true;
 
  Debug(2);
 
  for (auto &ChildFDM: ChildFDMList) {
    ChildFDM->AssignState(Propagate); // Transfer state to the child FDM
    ChildFDM->Run();
  }
 
  IncrTime();
 
  // returns true if success, false if complete
  if (Script && !IntegrationSuspended()) success = Script->RunScript();
 
  for (unsigned int i = 0; i < Models.size(); i++) {
    LoadInputs(i);
    Models[i]->Run(holding);
  }
 
  if (Terminate) success = false;
 
  return success;
}

Here is the call graph for this function:

Here is the caller graph for this function:

RunIC()

bool RunIC

(

void

)

Initializes the sim from the initial condition object and executes each scheduled model without integrating i.e.

dt=0.

Returns

true if successful

Definition at line 634 of file FGFDMExec.cpp.

{
  SuspendIntegration(); // saves the integration rate, dt, then sets it to 0.0.
  Initialize(IC.get());
 
  Models[eInput]->InitModel();
  Models[eOutput]->InitModel();
 
  Run();
  Propagate->InitializeDerivatives();
  ResumeIntegration(); // Restores the integration rate to what it was.
 
  if (debug_lvl > 0) {
    MassBalance->GetMassPropertiesReport(0);
 
    FGLogging log(LogLevel::DEBUG);
    log << endl << LogFormat::BLUE << LogFormat::BOLD
        << "End of vehicle configuration loading." << endl
        << "-------------------------------------------------------------------------------"
        << LogFormat::RESET << std::setprecision(6) << endl;
  }
 
  for (unsigned int n=0; n < Propulsion->GetNumEngines(); ++n) {
    if (IC->IsEngineRunning(n)) {
      try {
        Propulsion->InitRunning(n);
      } catch (const string& str) {
        FGLogging log(LogLevel::ERROR);
        log << str << endl;
        return false;
      }
    }
  }
 
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

SetAircraftPath()

bool SetAircraftPath ( const SGPath &  path )

inline

Set the path to the aircraft config file directories.

Under this path, then, would be directories for various modeled aircraft such as C172/, x15/, etc. Relative paths are taken from the root directory.

Parameters

path	path to the aircraft directory, for instance "aircraft".

See also

SetRootDir

GetAircraftPath

Definition at line 326 of file FGFDMExec.h.

                                           {
    AircraftPath = GetFullPath(path);
    return true;
  }

SetChild()

void SetChild ( bool  ch )

inline

Marks this instance of the Exec object as a "child" object.

Definition at line 430 of file FGFDMExec.h.

{IsChild = ch;}

SetDebugLevel()

void SetDebugLevel ( int  level )

inline

Sets the debug level.

Definition at line 510 of file FGFDMExec.h.

{debug_lvl = level;}

Here is the caller graph for this function:

Setdt()

void Setdt ( double  delta_t )

inline

Sets the integration time step for the simulation executive.

Parameters

delta_t

the time step in seconds.

Definition at line 572 of file FGFDMExec.h.

{ dT = delta_t; }

Here is the caller graph for this function:

SetEnginePath()

bool SetEnginePath ( const SGPath &  path )

inline

Set the path to the engine config file directories.

Relative paths are taken from the root directory.

Parameters

path	path to the directory under which engine config files are kept, for instance "engine".

See also

SetRootDir

GetEnginePath

Definition at line 314 of file FGFDMExec.h.

                                         {
    EnginePath = GetFullPath(path);
    return true;
  }

SetHoldDown()

void SetHoldDown

(

bool

hd

)

Sets the property forces/hold-down.

This allows to do hard 'hold-down' such as for rockets on a launch pad with engines ignited.

Parameters

hd	enables the 'hold-down' function if non-zero

Definition at line 704 of file FGFDMExec.cpp.

{
  HoldDown = hd;
  Accelerations->SetHoldDown(hd);
  if (hd) {
    Propagate->in.vPQRidot = Accelerations->GetPQRidot();
    Propagate->in.vUVWidot = Accelerations->GetUVWidot();
  }
  Propagate->SetHoldDown(hd);
}

Here is the call graph for this function:

Here is the caller graph for this function:

SetLoggingRate()

void SetLoggingRate ( double  rate )

inline

Sets the logging rate in Hz for all output objects (if any).

Definition at line 454 of file FGFDMExec.h.

{ Output->SetRateHz(rate); }

SetOutputDirectives()

bool SetOutputDirectives ( const SGPath &  fname )

inline

Sets the output (logging) mechanism for this run.

Calling this function passes the name of an output directives file to the FGOutput object associated with this run. The call to this function should be made prior to loading an aircraft model. This call results in an FGOutput object being built as the first Output object in the FDMExec-managed list of Output objects that may be created for an aircraft model. If this call is made after an aircraft model is loaded, there is no effect. Any Output objects added by the aircraft model itself (in an <output> element) will be added after this one. Care should be taken not to refer to the same file name. An output directives file contains an <output> </output> element, within which should be specified the parameters or parameter groups that should be logged.

Parameters

fname

the filename of an output directives file.

Definition at line 447 of file FGFDMExec.h.

  { return Output->SetDirectivesFile(GetFullPath(fname)); }

SetOutputFileName()

bool SetOutputFileName ( const int  n, const std::string &  fname  )

inline

Sets (or overrides) the output filename.

Parameters

n	index of file
fname	the name of the file to output data to

Returns

true if successful, false if there is no output specified for the flight model

Definition at line 460 of file FGFDMExec.h.

{ return Output->SetOutputName(n, fname); }

SetOutputPath()

bool SetOutputPath ( const SGPath &  path )

inline

Set the directory where the output files will be written.

Relative paths are taken from the root directory.

Parameters

path	path to the directory under which the output files will be written.

See also

SetRootDir

GetOutputPath

Definition at line 348 of file FGFDMExec.h.

                                         {
    OutputPath = GetFullPath(path);
    return true;
  }

SetPropertyValue()

void SetPropertyValue ( const std::string &  property, double  value  )

inline

Sets a property value.

Parameters

property	the property to be set
value	the value to set the property to

Definition at line 415 of file FGFDMExec.h.

  { instance->GetNode()->setDoubleValue(property.c_str(), value); }

SetRootDir()

void SetRootDir ( const SGPath &  rootDir )

inline

Set the root directory that is used to obtain absolute paths from relative paths.

Aircraft, engine, systems and output paths are not updated by this method. You must call each methods (SetAircraftPath(), SetEnginePath(), etc.) individually if you need to update these paths as well.

Parameters

rootDir

the path to the root directory.

See also

GetRootDir

SetAircraftPath

SetEnginePath

SetSystemsPath

SetOutputPath

Definition at line 586 of file FGFDMExec.h.

{RootDir = rootDir;}

Setsim_time()

double Setsim_time

(

double

cur_time

)

Sets the current sim time.

Parameters

cur_time

the current time

Returns

the current simulation time.

Definition at line 185 of file FGFDMExec.cpp.

                                             {
  sim_time = cur_time;
  Inertial->SetTime(sim_time);
  return sim_time;
}

Here is the call graph for this function:

Here is the caller graph for this function:

SetSystemsPath()

bool SetSystemsPath ( const SGPath &  path )

inline

Set the path to the systems config file directories.

Relative paths are taken from the root directory.

Parameters

path	path to the directory under which systems config files are kept, for instance "systems"

See also

SetRootDir

GetSystemsPath

Definition at line 337 of file FGFDMExec.h.

                                          {
    SystemsPath = GetFullPath(path);
    return true;
  }

SetTrimMode()

void SetTrimMode ( int  mode )

inline

Definition at line 544 of file FGFDMExec.h.

{ ta_mode = mode; }

SetTrimStatus()

void SetTrimStatus ( bool  status )

inline

Definition at line 542 of file FGFDMExec.h.

{ trim_status = status; }

SRand()

int SRand ( void  ) const

inline

Definition at line 629 of file FGFDMExec.h.

{ return RandomSeed; }

SuspendIntegration()

void SuspendIntegration ( void  )

inline

Suspends the simulation and sets the delta T to zero.

Definition at line 556 of file FGFDMExec.h.

{saved_dT = dT; dT = 0.0;}

Here is the caller graph for this function:

Unbind()

void Unbind ( void  )

inline

Unbind all tied JSBSim properties.

Definition at line 244 of file FGFDMExec.h.

{instance->Unbind();}

Here is the caller graph for this function:

Member Data Documentation

DONT_EXECUTE_RUN_IC

const int DONT_EXECUTE_RUN_IC = 0x2

static

Definition at line 500 of file FGFDMExec.h.

START_NEW_OUTPUT

const int START_NEW_OUTPUT = 0x1

static

Mode flags for ResetToInitialConditions.

Definition at line 499 of file FGFDMExec.h.

---

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

• FGFDMExec.h
• FGFDMExec.cpp