1 // TankProperties.cxx -- expose (fuel)-tank properties
3 // Written by Torsten Dreyer, started January 2011.
5 // Copyright (C) 2011 Torsten Dreyer - Torsten (at) t3r _dot_ de
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License as
9 // published by the Free Software Foundation; either version 2 of the
10 // License, or (at your option) any later version.
12 // This program is distributed in the hope that it will be useful, but
13 // WITHOUT ANY WARRANTY; without even the implied warranty of
14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 // General Public License for more details.
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, write to the Free Software
19 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
26 #include "TankProperties.hxx"
28 #include <simgear/math/SGMath.hxx>
29 #include <simgear/sg_inlines.h>
30 #include <Main/fg_props.hxx>
32 static const double LBS_PER_KG = 2.20462262;
33 static const double KG_PER_LBS = 1.0/LBS_PER_KG;
34 static const double USGAL_PER_M3 = 1000.0/3.785411784;
35 static const double M3_PER_USGAL = 1.0/USGAL_PER_M3;
36 static const double IMPGAL_PER_M3 = 1000.0/4.54609;
37 static const double M3_PER_IMPGAL = 1.0/IMPGAL_PER_M3;
39 TankProperties::TankProperties(SGPropertyNode_ptr rootNode ) :
45 _tiedProperties.setRoot( rootNode );
46 _tiedProperties.Tie("level-kg", this, &TankProperties::getContent_kg, &TankProperties::setContent_kg );
47 _tiedProperties.Tie("density-kgpm3", this, &TankProperties::getDensity_kgpm3, &TankProperties::setDensity_kgpm3 );
48 _tiedProperties.Tie("capacity-m3", this, &TankProperties::getCapacity_m3, &TankProperties::setCapacity_m3 );
49 _tiedProperties.Tie("unusable-m3", this, &TankProperties::getUnusable_m3, &TankProperties::setUnusable_m3 );
50 _tiedProperties.Tie("level-m3", this, &TankProperties::getContent_m3, &TankProperties::setContent_m3 );
51 _tiedProperties.Tie("level-norm", this, &TankProperties::getContent_norm, &TankProperties::setContent_norm );
53 _tiedProperties.Tie("density-ppg", this, &TankProperties::getDensity_ppg, &TankProperties::setDensity_ppg );
54 _tiedProperties.Tie("level-lbs", this, &TankProperties::getContent_lbs, &TankProperties::setContent_lbs );
55 _tiedProperties.Tie("level-gal_us", this, &TankProperties::getContent_gal_us, &TankProperties::setContent_gal_us );
56 _tiedProperties.Tie("level-gal_imp", this, &TankProperties::getContent_gal_imp, &TankProperties::setContent_gal_imp );
58 _tiedProperties.Tie("capacity-gal_us", this, &TankProperties::getCapacity_gal_us, &TankProperties::setCapacity_gal_us );
59 _tiedProperties.Tie("unusable-gal_us", this, &TankProperties::getUnusable_gal_us, &TankProperties::setUnusable_gal_us );
61 _tiedProperties.Tie("capacity-gal_imp", this, &TankProperties::getCapacity_gal_imp, &TankProperties::setCapacity_gal_imp );
62 _tiedProperties.Tie("unusable-gal_imp", this, &TankProperties::getUnusable_gal_imp, &TankProperties::setUnusable_gal_imp );
64 _tiedProperties.Tie("empty", this, &TankProperties::getEmpty );
67 TankProperties::~TankProperties()
71 double TankProperties::getContent_kg() const
76 void TankProperties::setContent_kg( double value )
78 _content_kg = SG_MAX2<double>(value, 0.0);
81 double TankProperties::getDensity_kgpm3() const
83 return _density_kgpm3;
86 void TankProperties::setDensity_kgpm3( double value )
88 _density_kgpm3 = SG_MAX2<double>(value, 0.0);
91 double TankProperties::getDensity_ppg() const
93 return _density_kgpm3 * LBS_PER_KG / USGAL_PER_M3;
96 void TankProperties::setDensity_ppg( double value )
98 _density_kgpm3 = SG_MAX2<double>(value * KG_PER_LBS / M3_PER_USGAL, 0.0);
101 double TankProperties::getContent_lbs() const
103 return _content_kg * LBS_PER_KG;
106 void TankProperties::setContent_lbs( double value )
108 _content_kg = SG_MAX2<double>(value * KG_PER_LBS, 0.0);
111 double TankProperties::getContent_m3() const
113 return _density_kgpm3 > SGLimitsd::min() ? _content_kg / _density_kgpm3 : 0.0;
116 void TankProperties::setContent_m3( double value )
118 // ugly hack to allow setting of a volumetric content without having the density
119 _content_kg = SG_MAX2<double>(value * (_density_kgpm3>0.0?_density_kgpm3:755.0), 0.0);
122 double TankProperties::getContent_gal_us() const
124 return getContent_m3() * USGAL_PER_M3;
127 void TankProperties::setContent_gal_us( double value )
129 setContent_m3( value * M3_PER_USGAL );
132 double TankProperties::getContent_gal_imp() const
134 return getContent_m3() * IMPGAL_PER_M3;
137 void TankProperties::setContent_gal_imp( double value )
139 setContent_m3( value * M3_PER_IMPGAL );
142 double TankProperties::getCapacity_m3() const
147 void TankProperties::setCapacity_m3( double value )
149 _capacity_m3 = SG_MAX2<double>(value, 0.0);
152 double TankProperties::getCapacity_gal_us() const
154 return _capacity_m3 * USGAL_PER_M3;
157 void TankProperties::setCapacity_gal_us( double value )
159 _capacity_m3 = SG_MAX2<double>(value * M3_PER_USGAL, 0.0);
162 double TankProperties::getCapacity_gal_imp() const
164 return _capacity_m3 * IMPGAL_PER_M3;
167 void TankProperties::setCapacity_gal_imp( double value )
169 _capacity_m3 = SG_MAX2<double>(value * M3_PER_IMPGAL, 0.0);
172 double TankProperties::getUnusable_m3() const
177 void TankProperties::setUnusable_m3( double value )
179 _unusable_m3 = SG_MAX2<double>(value, 0.0);
182 double TankProperties::getUnusable_gal_us() const
184 return _unusable_m3 * USGAL_PER_M3;
187 void TankProperties::setUnusable_gal_us( double value )
189 _unusable_m3 = SG_MAX2<double>(value * M3_PER_USGAL, 0.0);
193 double TankProperties::getUnusable_gal_imp() const
195 return _unusable_m3 * IMPGAL_PER_M3;
198 void TankProperties::setUnusable_gal_imp( double value )
200 _unusable_m3 = SG_MAX2<double>(value * M3_PER_IMPGAL, 0.0);
203 double TankProperties::getContent_norm() const
205 return _capacity_m3 > SGLimitsd::min() ? getContent_m3() / _capacity_m3 : 0.0;
208 void TankProperties::setContent_norm( double value )
210 setContent_m3(_capacity_m3 * value);
213 bool TankProperties::getEmpty() const
215 return getContent_m3() <= _unusable_m3;
218 TankPropertiesList::TankPropertiesList( SGPropertyNode_ptr rootNode )
220 // we don't have a global rule how many tanks we support, so I assume eight.
221 // Because hard coded values suck, make it settable by a property.
222 // If tanks were configured, use that number
223 int n = rootNode->getChildren("tank").size();
224 if( n == 0 ) n = rootNode->getIntValue( "numtanks", 8 );
225 for( int i = 0; i < n; i++ ) {
226 push_back( new TankProperties( rootNode->getChild( "tank", i, true ) ) );
229 _tiedProperties.setRoot( rootNode );
230 _tiedProperties.Tie("total-fuel-kg", this, &TankPropertiesList::getTotalContent_kg );
231 _tiedProperties.Tie("total-fuel-lbs", this, &TankPropertiesList::getTotalContent_lbs );
232 _tiedProperties.Tie("total-fuel-gal_us", this, &TankPropertiesList::getTotalContent_gal_us );
233 _tiedProperties.Tie("total-fuel-gals", this, &TankPropertiesList::getTotalContent_gal_us );
234 _tiedProperties.Tie("total-fuel-gal_imp", this, &TankPropertiesList::getTotalContent_gal_imp );
235 _tiedProperties.Tie("total-fuel-norm", this, &TankPropertiesList::getTotalContent_norm );
238 double TankPropertiesList::getTotalContent_lbs() const
241 for( const_iterator it = begin(); it != end(); ++it )
242 value += (*it)->getContent_lbs();
246 double TankPropertiesList::getTotalContent_kg() const
249 for( const_iterator it = begin(); it != end(); ++it )
250 value += (*it)->getContent_kg();
254 double TankPropertiesList::getTotalContent_gal_us() const
257 for( const_iterator it = begin(); it != end(); ++it )
258 value += (*it)->getContent_gal_us();
262 double TankPropertiesList::getTotalContent_gal_imp() const
265 for( const_iterator it = begin(); it != end(); ++it )
266 value += (*it)->getContent_gal_imp();
270 double TankPropertiesList::getTotalContent_m3() const
273 for( const_iterator it = begin(); it != end(); ++it )
274 value += (*it)->getContent_m3();
278 double TankPropertiesList::getTotalContent_norm() const
280 double content = 0.0;
281 double capacity = 0.0;
282 for( const_iterator it = begin(); it != end(); ++it ) {
283 content += (*it)->getContent_m3();
284 capacity += (*it)->getCapacity_m3();
286 return capacity > SGLimitsd::min() ? content / capacity : 0.0;