1 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
8 ------------- Copyright (C) 1999 Jon S. Berndt (jsb@hal-pc.org) -------------
10 This program is free software; you can redistribute it and/or modify it under
11 the terms of the GNU General Public License as published by the Free Software
12 Foundation; either version 2 of the License, or (at your option) any later
15 This program is distributed in the hope that it will be useful, but WITHOUT
16 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
17 FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
20 You should have received a copy of the GNU General Public License along with
21 this program; if not, write to the Free Software Foundation, Inc., 59 Temple
22 Place - Suite 330, Boston, MA 02111-1307, USA.
24 Further information about the GNU General Public License can also be found on
25 the world wide web at http://www.gnu.org.
27 FUNCTIONAL DESCRIPTION
28 --------------------------------------------------------------------------------
32 --------------------------------------------------------------------------------
34 09/03/99 JSB Changed Rocket thrust equation to correct -= Thrust instead of
35 += Thrust (thanks to Tony Peden)
37 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
39 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
42 # include <simgear/compiler.h>
43 # ifdef SG_HAVE_STD_INCLUDES
49 # if defined(sgi) && !defined(__GNUC__) && (_COMPILER_VERSION < 740)
61 static const char *IdSrc = "$Id$";
62 static const char *IdHdr = ID_ENGINE;
64 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
66 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
69 FGEngine::FGEngine(FGFDMExec* exec)
74 EnginePitch = EngineYaw = 0.0;
75 SLFuelFlowMax = SLOxiFlowMax = 0.0;
82 FuelNeed = OxidizerNeed = 0.0;
83 Starved = Running = Cranking = false;
91 State = FDMExec->GetState();
92 Atmosphere = FDMExec->GetAtmosphere();
93 FCS = FDMExec->GetFCS();
94 Propulsion = FDMExec->GetPropulsion();
95 Aircraft = FDMExec->GetAircraft();
96 Translation = FDMExec->GetTranslation();
97 Rotation = FDMExec->GetRotation();
98 Position = FDMExec->GetPosition();
99 Auxiliary = FDMExec->GetAuxiliary();
100 Output = FDMExec->GetOutput();
102 PropertyManager = FDMExec->GetPropertyManager();
107 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
109 FGEngine::~FGEngine()
114 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
115 // This base class function should be called from within the
116 // derived class' Calculate() function before any other calculations are done.
117 // This base class method removes fuel from the fuel tanks as appropriate,
118 // and sets the starved flag if necessary.
120 void FGEngine::ConsumeFuel(void)
122 double Fshortage, Oshortage;
125 if (TrimMode) return;
126 Fshortage = Oshortage = 0.0;
127 for (unsigned int i=0; i<SourceTanks.size(); i++) {
128 Tank = Propulsion->GetTank(SourceTanks[i]);
129 if (Tank->GetType() == FGTank::ttFUEL) {
130 Fshortage += Tank->Reduce(CalcFuelNeed()/Propulsion->GetnumSelectedFuelTanks());
132 Oshortage += Tank->Reduce(CalcOxidizerNeed()/Propulsion->GetnumSelectedOxiTanks());
136 if (Fshortage < 0.00 || Oshortage < 0.00) Starved = true;
137 else Starved = false;
140 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
142 double FGEngine::CalcFuelNeed(void)
144 FuelNeed = SLFuelFlowMax*PctPower*State->Getdt()*Propulsion->GetRate();
148 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
150 double FGEngine::CalcOxidizerNeed(void)
152 OxidizerNeed = SLOxiFlowMax*PctPower*State->Getdt()*Propulsion->GetRate();
156 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
158 void FGEngine::SetPlacement(double x, double y, double z, double pitch, double yaw)
167 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
169 void FGEngine::AddFeedTank(int tkID)
171 SourceTanks.push_back(tkID);
174 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
175 // The bitmasked value choices are as follows:
176 // unset: In this case (the default) JSBSim would only print
177 // out the normally expected messages, essentially echoing
178 // the config files as they are read. If the environment
179 // variable is not set, debug_lvl is set to 1 internally
180 // 0: This requests JSBSim not to output any messages
182 // 1: This value explicity requests the normal JSBSim
184 // 2: This value asks for a message to be printed out when
185 // a class is instantiated
186 // 4: When this value is set, a message is displayed when a
187 // FGModel object executes its Run() method
188 // 8: When this value is set, various runtime state variables
189 // are printed out periodically
190 // 16: When set various parameters are sanity checked and
191 // a message is printed out when they go out of bounds
193 void FGEngine::Debug(int from)
195 if (debug_lvl <= 0) return;
197 if (debug_lvl & 1) { // Standard console startup message output
198 if (from == 0) { // Constructor
202 if (debug_lvl & 2 ) { // Instantiation/Destruction notification
203 if (from == 0) cout << "Instantiated: FGEngine" << endl;
204 if (from == 1) cout << "Destroyed: FGEngine" << endl;
206 if (debug_lvl & 4 ) { // Run() method entry print for FGModel-derived objects
208 if (debug_lvl & 8 ) { // Runtime state variables
210 if (debug_lvl & 16) { // Sanity checking
212 if (debug_lvl & 64) {
213 if (from == 0) { // Constructor
214 cout << IdSrc << endl;
215 cout << IdHdr << endl;