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__)
61 static const char *IdSrc = "$Id$";
62 static const char *IdHdr = ID_ENGINE;
64 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
66 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
69 FGEngine::FGEngine(FGFDMExec* exec)
73 EnginePitch(0), EngineYaw(0),
74 SLFuelFlowMax(0), SLOxiFlowMax(0),
75 MaxThrottle(1.0), MinThrottle(0.0),
81 FuelNeed(0.0), OxidizerNeed(0.0),
82 Starved(false), Flameout(false), Running(false), Cranking(false),
83 Augmentation(false), Injection(false), Ignition(false),
84 Reversed(false), Cutoff(true), Nitrous(false),
89 ManifoldPressure_inHg(0.0),
90 ExhaustGasTemp_degK(0.0),
91 CylinderHeadTemp_degK(0.0),
95 N1(0.0), N2(0.0), EGT_degC(0.0),
96 InletPosition(0.0), NozzlePosition(0.0),
98 State(FDMExec->GetState()),
99 Atmosphere(FDMExec->GetAtmosphere()),
100 FCS(FDMExec->GetFCS()),
101 Propulsion(FDMExec->GetPropulsion()),
102 Aircraft(FDMExec->GetAircraft()),
103 Translation(FDMExec->GetTranslation()),
104 Rotation(FDMExec->GetRotation()),
105 Position(FDMExec->GetPosition()),
106 Auxiliary(FDMExec->GetAuxiliary()),
107 Output(FDMExec->GetOutput())
112 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
114 FGEngine::~FGEngine()
119 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
120 // This base class function should be called from within the
121 // derived class' Calculate() function before any other calculations are done.
122 // This base class method removes fuel from the fuel tanks as appropriate,
123 // and sets the starved flag if necessary.
125 void FGEngine::ConsumeFuel(void)
127 double Fshortage, Oshortage;
130 if (TrimMode) return;
131 Fshortage = Oshortage = 0.0;
132 for (unsigned int i=0; i<SourceTanks.size(); i++) {
133 Tank = Propulsion->GetTank(SourceTanks[i]);
134 if (Tank->GetType() == FGTank::ttFUEL) {
135 Fshortage += Tank->Reduce(CalcFuelNeed()/Propulsion->GetnumSelectedFuelTanks());
137 Oshortage += Tank->Reduce(CalcOxidizerNeed()/Propulsion->GetnumSelectedOxiTanks());
141 if (Fshortage < 0.00 || Oshortage < 0.00) Starved = true;
142 else Starved = false;
145 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
147 double FGEngine::CalcFuelNeed(void) {
148 FuelNeed = SLFuelFlowMax*PctPower*State->Getdt()*Propulsion->GetRate();
152 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
154 double FGEngine::CalcOxidizerNeed(void) {
155 OxidizerNeed = SLOxiFlowMax*PctPower*State->Getdt()*Propulsion->GetRate();
159 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
161 void FGEngine::SetPlacement(double x, double y, double z, double pitch, double yaw) {
169 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
171 void FGEngine::AddFeedTank(int tkID)
173 SourceTanks.push_back(tkID);
176 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
177 // The bitmasked value choices are as follows:
178 // unset: In this case (the default) JSBSim would only print
179 // out the normally expected messages, essentially echoing
180 // the config files as they are read. If the environment
181 // variable is not set, debug_lvl is set to 1 internally
182 // 0: This requests JSBSim not to output any messages
184 // 1: This value explicity requests the normal JSBSim
186 // 2: This value asks for a message to be printed out when
187 // a class is instantiated
188 // 4: When this value is set, a message is displayed when a
189 // FGModel object executes its Run() method
190 // 8: When this value is set, various runtime state variables
191 // are printed out periodically
192 // 16: When set various parameters are sanity checked and
193 // a message is printed out when they go out of bounds
195 void FGEngine::Debug(int from)
197 if (debug_lvl <= 0) return;
199 if (debug_lvl & 1) { // Standard console startup message output
200 if (from == 0) { // Constructor
204 if (debug_lvl & 2 ) { // Instantiation/Destruction notification
205 if (from == 0) cout << "Instantiated: FGEngine" << endl;
206 if (from == 1) cout << "Destroyed: FGEngine" << endl;
208 if (debug_lvl & 4 ) { // Run() method entry print for FGModel-derived objects
210 if (debug_lvl & 8 ) { // Runtime state variables
212 if (debug_lvl & 16) { // Sanity checking
214 if (debug_lvl & 64) {
215 if (from == 0) { // Constructor
216 cout << IdSrc << endl;
217 cout << IdHdr << endl;