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)
58 #include "FGPropeller.h"
63 static const char *IdSrc = "$Id$";
64 static const char *IdHdr = ID_ENGINE;
66 /*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
68 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
71 FGEngine::FGEngine(FGFDMExec* exec, int engine_number) : EngineNumber(engine_number)
76 EnginePitch = EngineYaw = 0.0;
77 SLFuelFlowMax = SLOxiFlowMax = 0.0;
84 FuelNeed = OxidizerNeed = 0.0;
85 Starved = Running = Cranking = false;
93 State = FDMExec->GetState();
94 Atmosphere = FDMExec->GetAtmosphere();
95 FCS = FDMExec->GetFCS();
96 Propulsion = FDMExec->GetPropulsion();
97 Aircraft = FDMExec->GetAircraft();
98 Propagate = FDMExec->GetPropagate();
99 Auxiliary = FDMExec->GetAuxiliary();
100 Output = FDMExec->GetOutput();
102 PropertyManager = FDMExec->GetPropertyManager();
104 char property_name[80];
105 snprintf(property_name, 80, "propulsion/engine[%u]/thrust", EngineNumber);
106 PropertyManager->Tie( property_name, &Thrust);
111 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
113 FGEngine::~FGEngine()
115 if (Thruster) delete Thruster;
117 char property_name[80];
118 snprintf(property_name, 80, "propulsion/engine[%u]/thrust", EngineNumber);
119 PropertyManager->Untie( property_name);
124 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
125 // This base class function should be called from within the
126 // derived class' Calculate() function before any other calculations are done.
127 // This base class method removes fuel from the fuel tanks as appropriate,
128 // and sets the starved flag if necessary.
130 void FGEngine::ConsumeFuel(void)
132 if (FuelFreeze) return;
134 double Fshortage, Oshortage, TanksWithFuel;
137 if (TrimMode) return;
138 Fshortage = Oshortage = TanksWithFuel = 0.0;
140 // count how many assigned tanks have fuel
141 for (i=0; i<SourceTanks.size(); i++) {
142 Tank = Propulsion->GetTank(SourceTanks[i]);
143 if (Tank->GetContents() > 0.0) {
147 if (!TanksWithFuel) return;
149 for (i=0; i<SourceTanks.size(); i++) {
150 Tank = Propulsion->GetTank(SourceTanks[i]);
151 if (Tank->GetType() == FGTank::ttFUEL) {
152 Fshortage += Tank->Drain(CalcFuelNeed()/TanksWithFuel);
154 Oshortage += Tank->Drain(CalcOxidizerNeed()/TanksWithFuel);
158 if (Fshortage < 0.00 || Oshortage < 0.00) Starved = true;
159 else Starved = false;
162 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
164 double FGEngine::CalcFuelNeed(void)
166 FuelNeed = SLFuelFlowMax*PctPower*State->Getdt()*Propulsion->GetRate();
170 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
172 double FGEngine::CalcOxidizerNeed(void)
174 OxidizerNeed = SLOxiFlowMax*PctPower*State->Getdt()*Propulsion->GetRate();
178 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
180 void FGEngine::SetPlacement(double x, double y, double z, double pitch, double yaw)
189 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
191 void FGEngine::AddFeedTank(int tkID)
193 SourceTanks.push_back(tkID);
196 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
198 FGColumnVector3& FGEngine::GetBodyForces(void)
200 return Thruster->GetBodyForces();
203 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
205 FGColumnVector3& FGEngine::GetMoments(void)
207 return Thruster->GetMoments();
210 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
212 bool FGEngine::LoadThruster(FGConfigFile* AC_cfg)
214 string token, fullpath, localpath;
215 string thrusterFileName, thrType, engineFileName;
216 FGConfigFile* Cfg_ptr = 0;
217 double xLoc, yLoc, zLoc, Pitch, Yaw;
218 double P_Factor = 0, Sense = 0.0;
219 string enginePath = FDMExec->GetEnginePath();
220 string aircraftPath = FDMExec->GetAircraftPath();
221 thrusterFileName = AC_cfg->GetValue("FILE");
224 fullpath = enginePath + "/";
225 localpath = aircraftPath + "/" + "/Engines/";
227 fullpath = enginePath + ";";
228 localpath = aircraftPath + ";" + ";Engines;";
231 // Look in the Aircraft/Engines directory first
232 FGConfigFile Local_Thruster_cfg(localpath + thrusterFileName + ".xml");
233 FGConfigFile Thruster_cfg(fullpath + thrusterFileName + ".xml");
235 if (Local_Thruster_cfg.IsOpen()) {
236 Cfg_ptr = &Local_Thruster_cfg;
237 if (debug_lvl > 0) cout << "\n Reading thruster from file: " << localpath
238 + thrusterFileName + ".xml"<< endl;
240 if (Thruster_cfg.IsOpen()) {
241 Cfg_ptr = &Thruster_cfg;
242 if (debug_lvl > 0) cout << "\n Reading thruster from file: " << fullpath
243 + thrusterFileName + ".xml"<< endl;
248 Cfg_ptr->GetNextConfigLine();
249 thrType = Cfg_ptr->GetValue();
251 if (thrType == "FG_PROPELLER") {
252 Thruster = new FGPropeller(FDMExec, Cfg_ptr, EngineNumber);
253 } else if (thrType == "FG_NOZZLE") {
254 Thruster = new FGNozzle(FDMExec, Cfg_ptr, EngineNumber);
255 } else if (thrType == "FG_DIRECT") {
256 Thruster = new FGThruster( FDMExec, Cfg_ptr, EngineNumber);
259 AC_cfg->GetNextConfigLine();
260 while ((token = AC_cfg->GetValue()) != string("/AC_THRUSTER")) {
262 if (token == "XLOC") *AC_cfg >> xLoc;
263 else if (token == "YLOC") *AC_cfg >> yLoc;
264 else if (token == "ZLOC") *AC_cfg >> zLoc;
265 else if (token == "PITCH") *AC_cfg >> Pitch;
266 else if (token == "YAW") *AC_cfg >> Yaw;
267 else if (token == "P_FACTOR") *AC_cfg >> P_Factor;
268 else if (token == "SENSE") *AC_cfg >> Sense;
269 else cerr << "Unknown identifier: " << token << " in engine file: "
270 << engineFileName << endl;
273 Thruster->SetLocation(xLoc, yLoc, zLoc);
274 Thruster->SetAnglesToBody(0, Pitch, Yaw);
275 if (thrType == "FG_PROPELLER" && P_Factor > 0.001) {
276 ((FGPropeller*)Thruster)->SetPFactor(P_Factor);
277 if (debug_lvl > 0) cout << " P-Factor: " << P_Factor << endl;
278 ((FGPropeller*)Thruster)->SetSense(fabs(Sense)/Sense);
279 if (debug_lvl > 0) cout << " Sense: " << Sense << endl;
281 Thruster->SetdeltaT(State->Getdt() * Propulsion->GetRate());
285 cerr << "Could not read thruster config file: " << fullpath
286 + thrusterFileName + ".xml" << endl;
292 //%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
293 // The bitmasked value choices are as follows:
294 // unset: In this case (the default) JSBSim would only print
295 // out the normally expected messages, essentially echoing
296 // the config files as they are read. If the environment
297 // variable is not set, debug_lvl is set to 1 internally
298 // 0: This requests JSBSim not to output any messages
300 // 1: This value explicity requests the normal JSBSim
302 // 2: This value asks for a message to be printed out when
303 // a class is instantiated
304 // 4: When this value is set, a message is displayed when a
305 // FGModel object executes its Run() method
306 // 8: When this value is set, various runtime state variables
307 // are printed out periodically
308 // 16: When set various parameters are sanity checked and
309 // a message is printed out when they go out of bounds
311 void FGEngine::Debug(int from)
313 if (debug_lvl <= 0) return;
315 if (debug_lvl & 1) { // Standard console startup message output
316 if (from == 0) { // Constructor
320 if (debug_lvl & 2 ) { // Instantiation/Destruction notification
321 if (from == 0) cout << "Instantiated: FGEngine" << endl;
322 if (from == 1) cout << "Destroyed: FGEngine" << endl;
324 if (debug_lvl & 4 ) { // Run() method entry print for FGModel-derived objects
326 if (debug_lvl & 8 ) { // Runtime state variables
328 if (debug_lvl & 16) { // Sanity checking
330 if (debug_lvl & 64) {
331 if (from == 0) { // Constructor
332 cout << IdSrc << endl;
333 cout << IdHdr << endl;