1 /*****************************************************************************
4 Author: Christian Mayer
8 -------- Copyright (C) 1999 Christian Mayer (fgfs@christianmayer.de) --------
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 ------------------------------------------------------------------------------
29 A hot air balloon simulator
32 ------------------------------------------------------------------------------
33 01.09.1999 Christian Mayer Created
34 03.10.1999 Christian Mayer cleaned the code by moveing WeatherDatabase
35 calls inside the update()
36 *****************************************************************************/
38 /****************************************************************************/
40 /****************************************************************************/
45 #include <simgear/constants.h>
47 #include <Aircraft/aircraft.hxx>
49 # include <WeatherCM/FGLocalWeatherDatabase.h>
52 #include "BalloonSim.h"
56 /****************************************************************************/
57 /********************************** CODE ************************************/
58 /****************************************************************************/
60 /****************************************************************************/
63 /* Set the balloon model to some values that seem reasonable as I haven't */
64 /* got much original values */
66 /****************************************************************************/
70 ground_level = 3400.0;
72 sgSetVec3(gravity_vector, 0.0, 0.0, -9.81);
73 sgSetVec3(velocity, 0.0, 0.0, 0.0);
74 sgSetVec3(position, 0.0, 0.0, 0.0);
75 sgSetVec3(hpr, 0.0, 0.0, 0.0);
77 /************************************************************************/
78 /* My balloon has a radius of 8.8 metres as that gives a envelope */
79 /* volume of about 2854 m^3 which is about 77000 ft^3, a very common */
80 /* size for hot air balloons */
81 /************************************************************************/
83 balloon_envelope_area = 4.0 * (8.8 * 8.8) * SGD_PI;
84 balloon_envelope_volume = (4.0/3.0) * (8.8 * 8.8 * 8.8) * SGD_PI;
86 wind_facing_area_of_balloon = SGD_PI * (8.8 * 8.8);
87 wind_facing_area_of_basket = 2.0; //guessed: 2 m^2
89 cw_envelope=0.45; //a sphere in this case
92 weight_of_total_fuel = 40.0; //big guess
93 weight_of_envelope = 200.0; //big guess
94 weight_of_basket = 40.0; //big guess
95 weight_of_cargo = 750.0; //big guess
98 max_flow_of_fuel_per_second=10.0*1.0/3600.0; //assuming 10% of one hour of total burn time
99 current_burner_strength = 0.0; //the throttle
101 lambda = 0.15; //for plasic
102 l_of_the_envelope = 1.0/1000.0; //the thickness of the envelope (in m): 1mm
104 T = 273.16 + 130.6; //Temperature in the envelope => still at ground level
107 void balloon::update()
109 /************************************************************************/
110 /* I'm simplifying the balloon by reducing the simulation to two */
112 /* the center of the basket (CB) and the center of the envelope (CE) */
117 /* cg (=center of gravity) */
121 /* On each center are forces acting: gravity and wind resitance. CE */
122 /* additionally got the lift (=> I need to calculate the weight of the */
123 /* air inside, too) */
125 /* The weight of the air in the envelope is dependant of the tempera- */
126 /* ture. This temperature is decreasing over the time that is dependant */
127 /* of the insulation of the envelope material (lambda), the gas used */
128 /* (air) and the wind speed. For a plane surface it's for air: */
130 /* alpha = 4.8 + 3.4*v with v < 5.0 m/s */
132 /* The value k that takes all of that into account is defined as: */
134 /* 1 / k = 1 / alpha1 + 1 / alpha2 + l / lambda */
136 /* with 'l' beeing the 'length' i.e. thickness of the insulator, alpha1 */
137 /* the air inside and alpha2 the air outside of the envelope. So our k */
140 /* k = 1 / [1/4.8 + 1/(4.8+3.4v) + l/lambda] */
142 /* The energy lost by this process is defined as: */
144 /* dQ = k * A * t * dT */
146 /* with Q being the energy, k that value defined above, A the total */
147 /* area of the envelope, t the time (in hours) and dT the temperature */
148 /* difference between the inside and the outside. */
149 /* To get the temperature of the air in the inside I need the formula: */
151 /* dQ = cAir * m * dT */
153 /* with cAir being the specific heat capacity(?) of air (= 1.00 kcal / */
154 /* kg * degree), m the mass of the air and dT the temperature change. */
155 /* As the envelope is open I'm assuming that the same air pressure is */
156 /* inside and outside of it (practical there should be a slightly */
157 /* higher air pressure in the inside or the envelope would collapse). */
158 /* So it's easy to calculate the density of the air inside: */
160 /* rho = p / R * T */
162 /* with p being the pressure, R the gas constant(?) which is for air */
163 /* 287.14 N * m / kg * K and T the absolute temperature. */
165 /* The value returned by this function is the displacement of the CB */
166 /************************************************************************/
168 /************************************************************************/
169 /* NOTE: This is the simplified version: I'm assuming that the whole */
170 /* balloon consists only of the envelope.I will improove the simulation */
171 /* later, but currently was my main concern to get it going... */
172 /************************************************************************/
177 FGPhysicalProperty wdbpos = WeatherDatabase->get(position);
179 //get the current wind velocity and store it in v
180 //Point3D temp = wdbpos.Wind;
181 //sgSetVec3(v, temp.x(), temp.y(), temp.z());
182 sgCopyVec3(v, wdbpos.Wind );
184 sgSubVec3(v, velocity);
185 float speed = sgLengthVec3(v);
187 // calculate the density of the gas inside
188 double rho = wdbpos.AirPressure / (287.14 * T);
190 // calculate the mass of the air
191 double mAir = rho * balloon_envelope_volume;
193 // loss of energy by cooling down:
194 float k = 1.0 / (1.0/4.8 + 1.0/(4.8+3.4*speed) + l_of_the_envelope/lambda);
195 float Q = k * balloon_envelope_area * (dt/3600.0) * (wdbpos.Temperature - T); //(dt/3600.0) = time since last call in hours
198 // I realy don't think there is a solution for this without WeatherCM
199 // but this is a hack, and it's working -- EMH
204 // gain of energy by heating:
205 if (fuel_left > 0.0) //but only with some fuel left ;-)
207 float fuel_burning = current_burner_strength * max_flow_of_fuel_per_second * dt * weight_of_total_fuel; //in kg
209 //convert to cubemetres (I'm wrongly assuming 'normal' conditions; but that's correct for my special case)
210 float cube_metres_burned = fuel_burning / 2.2; //2.2 is the density for propane
212 fuel_left -= fuel_burning / weight_of_total_fuel;
214 // get energy through burning.
215 Q += 22250.0 * cube_metres_burned; //22250 for propan, 29500 would be butane and if you dare: 2580 would be hydrogen...
218 // calculate the new temperature in the inside:
219 T += Q / (1.00 * mAir);
221 //calculate the masses of the envelope and the basket
222 float mEnvelope = mAir + weight_of_envelope;
223 float mBasket = weight_of_total_fuel*fuel_left + weight_of_basket + weight_of_cargo;
225 float mTotal = mEnvelope + mBasket;
227 //calulate the forces
228 sgVec3 fTotal, fFriction, fLift;
230 sgScaleVec3(fTotal, gravity_vector, mTotal);
232 sgScaleVec3(fFriction, v, cw_envelope * wind_facing_area_of_balloon * WeatherDatabase->getAirDensity(position) * speed / 2.0); //wind resistance
233 sgScaleVec3(fLift, gravity_vector, -balloon_envelope_volume * wdbpos.AirPressure / (287.14 * wdbpos.Temperature));
236 sgAddVec3(fTotal, fLift);
237 sgAddVec3(fTotal, fFriction);
239 //claculate acceleration: a = F / m
240 sgVec3 aTotal, vTotal, dTotal;
242 sgScaleVec3(aTotal, fTotal, 1.0 / mTotal);
244 //integrate the displacement: d = 0.5 * a * dt**2 + v * dt + d
245 sgScaleVec3(vTotal, velocity, dt);
246 sgScaleVec3(dTotal, aTotal, 0.5*dt*dt); sgAddVec3(dTotal, vTotal);
248 //integrate the velocity to 'velocity': v = a * dt + v
249 sgScaleVec3(vTotal, aTotal, dt); sgAddVec3(velocity, vTotal);
251 /************************************************************************/
252 /* VERY WRONG STUFF: it's just here to get some results to start with */
253 /************************************************************************/
255 // care for the ground
256 if (position[2] < (ground_level+0.001) )
257 position[2] = ground_level;
260 sgAddVec3(position, dTotal);
262 //cout << "BallonSim: T: " << (T-273.16) << " alt: " << position[2] << " ground: " << ground_level << " throttle: " << current_burner_strength << "\n";
265 void balloon::set_burner_strength(const float bs)
267 if ((bs>=0.0) && (bs<=1.0))
268 current_burner_strength = bs;
271 void balloon::getVelocity(sgVec3 v) const
273 sgCopyVec3(v, velocity);
276 void balloon::setVelocity(const sgVec3 v)
278 sgCopyVec3(velocity, v);
281 void balloon::getPosition(sgVec3 v) const
283 sgCopyVec3(v, position);
286 void balloon::setPosition(const sgVec3 v)
288 sgCopyVec3(position, v);
291 void balloon::getHPR(sgVec3 angles) const //the balloon isn't allways exactly vertical
293 sgCopyVec3(angles, hpr);
296 void balloon::setHPR(const sgVec3 angles) //the balloon isn't allways exactly vertical
298 sgCopyVec3(hpr, angles);
301 void balloon::setGroundLevel(const float altitude)
303 ground_level = altitude;
306 float balloon::getTemperature(void) const
311 float balloon::getFuelLeft(void) const
322 sgVec3 pos={0.0, 0.0, 0.0};
327 bool hysteresis = false; // moving up
330 for (int i=0; i<100; i++)
332 bal.update(0.1); acc_dt += 0.1;
333 bal.getPosition(pos);
341 if ((alt < 2990) && (hysteresis == true))
346 if ((bal.getTemperature()-273.16)>250.0)
347 burner = false; //emergency
357 //printf("Position: (%f/%f/%f), dP: (%f/%f/%f), burner: ", pos[0], pos[1], pos[2], dp[0], dp[1], dp[2]);
358 printf("%f \t%f \t%f \t%f\n", acc_dt/60.0, bal.getTemperature()-273.16, pos[2], bal.getFuelLeft());
362 bal.set_burner_strength(1.0);
367 bal.set_burner_strength(0.0);