fly/flightgear
1
0
Fork 0
Code Activity
flightgear/src/Environment/environment.hxx

154 lines
4.7 KiB
C++
Raw Normal View History

Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
// environment.hxx -- routines to model the natural environment.
//
// Written by David Megginson, started February 2002.
//
// Copyright (C) 2002 David Megginson - david@megginson.com
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
// published by the Free Software Foundation; either version 2 of the
// License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
new FSF address
2006-02-21 01:16:04 +00:00
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
//
#ifndef _ENVIRONMENT_HXX
#define _ENVIRONMENT_HXX
#include <simgear/compiler.h>
This should apply, and everything should build cleanly, in isolation from the SimGear change. It changes all the SG_xxxx to be the 'real' includes, and gets rid of many #ifdef SG_HAVE_STD_INCLUDES. As an added bonus, rather than replacing 'SG_USING_NAMESPACE(std)' with 'using namespace std', I just fixed the small number of places to use std:: explicitly. So we're no longer polluting the global namespace with the entire contents of std, in many cases. There is one more 'mechanical' change to come - getting rid of SG_USING_STD(X), but I want to keep that separate from everything else. (There's another mechnical change, replacing <math.h> with <cmath> and so on *everywhere*, but one step at a time)
2008-07-25 18:38:29 +00:00
#include <cmath>
Move tiedpropertylist from flightgear to simgear
2011-02-06 14:44:09 +00:00
#include <simgear/props/tiedpropertylist.hxx>
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
/**
* Model the natural environment.
*
* This class models the natural environment at a specific place and
* time. A separate instance is necessary for each location or time.
*
* This class should eventually move to SimGear.
*/
Added FGEnvironmentMgr to provide information on the environment in different locations, and hitched it into FGGlobals. FGEnvironmentMgr has taken over as the subsystem, while FGEnvironment is simple the information that it returns. I've removed current_environment completely -- everything now uses properties or goes through FGGlobals. FGGlobals itself has a couple of useful methods: const FGEnvironment * get_environment (); const FGEnvironment * get_environment (double lat, double lon, double alt); The first one returns the environment data for the plane's current position, while the second returns the environment data for any arbitrary location. Currently, they both return the same information, but that will change soon.
2002-02-22 22:51:34 +00:00
class FGEnvironment
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
{
public:
FGEnvironment();
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
FGEnvironment (const FGEnvironment &environment);
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
virtual ~FGEnvironment();
Removed FGEnvironmentMgr as a special case in globals, initialization, etc. Improved the weather system to interpolate between different elevations and deal with boundary-layer conditions. The configuration properties are now different (see $FG_ROOT/preferences.xml).
2003-06-08 14:47:03 +00:00
Environment controller overhaul This is the initial commit for a reworked environment controller. The main intention is to decouple the individual modules like metar fetch, metar properties, environment interpolation etc. to make it easier for other weather module developers to modify environment settings. As a side effect, the dialogs for weather-scenario, weather-conditions, clouds and precipitations have been merged into a single dialog
2010-09-11 14:11:35 +00:00
FGEnvironment & operator = ( const FGEnvironment & other );
Removed FGEnvironmentMgr as a special case in globals, initialization, etc. Improved the weather system to interpolate between different elevations and deal with boundary-layer conditions. The configuration properties are now different (see $FG_ROOT/preferences.xml).
2003-06-08 14:47:03 +00:00
virtual void read (const SGPropertyNode * node);
Environment controller overhaul This is the initial commit for a reworked environment controller. The main intention is to decouple the individual modules like metar fetch, metar properties, environment interpolation etc. to make it easier for other weather module developers to modify environment settings. As a side effect, the dialogs for weather-scenario, weather-conditions, clouds and precipitations have been merged into a single dialog
2010-09-11 14:11:35 +00:00
virtual void Tie( SGPropertyNode_ptr base, bool setArchivable = true );
virtual void Untie();
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
virtual double get_visibility_m () const;
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
virtual double get_temperature_sea_level_degc () const;
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
virtual double get_temperature_degc () const;
Added Farenheit temperature conversion to the property tree.
2005-05-20 19:42:53 +00:00
virtual double get_temperature_degf () const;
Air density is now calculated automatically from air pressure, temperature, and dewpoint. The /environment/density-sea-level-slugft3 property has been removed, and the /environment/density-slugft3 property is read-only.
2002-06-06 00:21:23 +00:00
virtual double get_dewpoint_sea_level_degc () const;
virtual double get_dewpoint_degc () const;
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
virtual double get_pressure_sea_level_inhg () const;
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
virtual double get_pressure_inhg () const;
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
virtual double get_density_slugft3 () const;
Mark's dynamic sun color changes.
2006-07-27 05:16:06 +00:00
virtual double get_relative_humidity () const;
virtual double get_density_tropo_avg_kgm3 () const;
virtual double get_altitude_half_to_sun_m () const;
virtual double get_altitude_tropo_top_m () const;
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
virtual double get_wind_from_heading_deg () const;
virtual double get_wind_speed_kt () const;
virtual double get_wind_from_north_fps () const;
virtual double get_wind_from_east_fps () const;
virtual double get_wind_from_down_fps () const;
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
Add the ability to control turbulence rate as well as magnitude. Square the normalized direction acceleration for the y and z axes, so that turbulence predominantly affects pitch. Bind to the /environment/turbulence/magnitude-norm and /environment/turbulence/rate-hz properties in FlightGear.
2003-07-13 20:13:18 +00:00
virtual double get_turbulence_magnitude_norm () const;
virtual double get_turbulence_rate_hz () const;
Removed FGEnvironmentMgr as a special case in globals, initialization, etc. Improved the weather system to interpolate between different elevations and deal with boundary-layer conditions. The configuration properties are now different (see $FG_ROOT/preferences.xml).
2003-06-08 14:47:03 +00:00
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
virtual void set_visibility_m (double v);
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
virtual void set_temperature_sea_level_degc (double t);
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
virtual void set_temperature_degc (double t);
Air density is now calculated automatically from air pressure, temperature, and dewpoint. The /environment/density-sea-level-slugft3 property has been removed, and the /environment/density-slugft3 property is read-only.
2002-06-06 00:21:23 +00:00
virtual void set_dewpoint_sea_level_degc (double d);
virtual void set_dewpoint_degc (double d);
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
virtual void set_pressure_sea_level_inhg (double p);
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
virtual void set_pressure_inhg (double p);
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
virtual void set_wind_from_heading_deg (double h);
virtual void set_wind_speed_kt (double s);
virtual void set_wind_from_north_fps (double n);
virtual void set_wind_from_east_fps (double e);
virtual void set_wind_from_down_fps (double d);
Add the ability to control turbulence rate as well as magnitude. Square the normalized direction acceleration for the y and z axes, so that turbulence predominantly affects pitch. Bind to the /environment/turbulence/magnitude-norm and /environment/turbulence/rate-hz properties in FlightGear.
2003-07-13 20:13:18 +00:00
virtual void set_turbulence_magnitude_norm (double t);
virtual void set_turbulence_rate_hz (double t);
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
virtual double get_elevation_ft () const;
virtual void set_elevation_ft (double elevation_ft);
Mark's dynamic sun color changes.
2006-07-27 05:16:06 +00:00
virtual void set_altitude_half_to_sun_m (double alt);
virtual void set_altitude_tropo_top_m (double alt);
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
Save more than 20 percent execution time by avoiding multiple calculation of properties.
2009-05-31 10:18:45 +00:00
virtual bool set_live_update(bool live_update);
Environment controller overhaul This is the initial commit for a reworked environment controller. The main intention is to decouple the individual modules like metar fetch, metar properties, environment interpolation etc. to make it easier for other weather module developers to modify environment settings. As a side effect, the dialogs for weather-scenario, weather-conditions, clouds and precipitations have been merged into a single dialog
2010-09-11 14:11:35 +00:00
FGEnvironment & interpolate (const FGEnvironment & env2, double fraction, FGEnvironment * result) const;
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
private:
Environment controller overhaul This is the initial commit for a reworked environment controller. The main intention is to decouple the individual modules like metar fetch, metar properties, environment interpolation etc. to make it easier for other weather module developers to modify environment settings. As a side effect, the dialogs for weather-scenario, weather-conditions, clouds and precipitations have been merged into a single dialog
2010-09-11 14:11:35 +00:00
virtual void copy (const FGEnvironment &environment);
FGEnvironment: fix broken copy constructor. Noticed by Csaba Halász.
2009-01-14 08:19:41 +00:00
void _init();
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
void _recalc_hdgspd ();
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
void _recalc_sl_temperature ();
Air density is now calculated automatically from air pressure, temperature, and dewpoint. The /environment/density-sea-level-slugft3 property has been removed, and the /environment/density-slugft3 property is read-only.
2002-06-06 00:21:23 +00:00
void _recalc_sl_dewpoint ();
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
void _recalc_sl_pressure ();
Mark's dynamic sun color changes.
2006-07-27 05:16:06 +00:00
void _recalc_density_tropo_avg_kgm3 ();
Environment controller overhaul This is the initial commit for a reworked environment controller. The main intention is to decouple the individual modules like metar fetch, metar properties, environment interpolation etc. to make it easier for other weather module developers to modify environment settings. As a side effect, the dialogs for weather-scenario, weather-conditions, clouds and precipitations have been merged into a single dialog
2010-09-11 14:11:35 +00:00
void _recalc_ne ();
void _recalc_alt_dewpoint ();
void _recalc_density ();
void _recalc_relative_humidity ();
void _recalc_alt_pt ();
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
Mark's dynamic sun color changes.
2006-07-27 05:16:06 +00:00
double elevation_ft;
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
double visibility_m;
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
Mark's dynamic sun color changes.
2006-07-27 05:16:06 +00:00
// Atmosphere
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
double temperature_sea_level_degc;
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
double temperature_degc;
Air density is now calculated automatically from air pressure, temperature, and dewpoint. The /environment/density-sea-level-slugft3 property has been removed, and the /environment/density-slugft3 property is read-only.
2002-06-06 00:21:23 +00:00
double dewpoint_sea_level_degc;
double dewpoint_degc;
General cleanups to cut cross-dependencies and speed up compilation. Added two new properties: /environment/temperature-sea-level-degc /environment/pressure-sea-level-inhg These are now supported in FGEnvironment as well, though they always have the same value for now. They need to be hooked up to the FDMs.
2002-02-22 23:37:45 +00:00
double pressure_sea_level_inhg;
Environment manager overhaul -- return a copy of an FGEnvironment object rather than a pointer. FGEnvironment now has the beginning of an atmospheric model, and will recalculate temperature (not pressure or density, yet) based on elevation. FGEnvironment has a copy constructor.
2002-05-11 23:23:42 +00:00
double pressure_inhg;
Finished off the atmosphere model (Troposphere and lower Stratosphere). The atmospheric properties are as follow: /environment/temperature-sea-level-degc /environment/temperature-degc /environment/pressure-sea-level-inhg /environment/pressure-inhg /environment/density-sea-level-slugft3 /environment/density-slugft3 Setting either the sea-level or altitude value automatically sets the other value appropriate, except for temperature at altitude above the Troposphere (where there's no reliable way to back-calculate it). The atmosphere model appears in the atmosphere_data array in environment.cxx, and can easily be extended into the upper stratosphere and beyond. These are not yet tied into the FDMs or steam module.
2002-05-15 03:00:41 +00:00
double density_slugft3;
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
Mark's dynamic sun color changes.
2006-07-27 05:16:06 +00:00
double density_tropo_avg_kgm3;
double relative_humidity;
double altitude_half_to_sun_m;
double altitude_tropo_top_m;
Add the ability to control turbulence rate as well as magnitude. Square the normalized direction acceleration for the y and z axes, so that turbulence predominantly affects pitch. Bind to the /environment/turbulence/magnitude-norm and /environment/turbulence/rate-hz properties in FlightGear.
2003-07-13 20:13:18 +00:00
double turbulence_magnitude_norm;
double turbulence_rate_hz;
Removed FGEnvironmentMgr as a special case in globals, initialization, etc. Improved the weather system to interpolate between different elevations and deal with boundary-layer conditions. The configuration properties are now different (see $FG_ROOT/preferences.xml).
2003-06-08 14:47:03 +00:00
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
double wind_from_heading_deg;
double wind_speed_kt;
double wind_from_north_fps;
double wind_from_east_fps;
double wind_from_down_fps;
Save more than 20 percent execution time by avoiding multiple calculation of properties.
2009-05-31 10:18:45 +00:00
bool live_update;
Move tiedpropertylist from flightgear to simgear
2011-02-06 14:44:09 +00:00
simgear::TiedPropertyList _tiedProperties;
Save more than 20 percent execution time by avoiding multiple calculation of properties.
2009-05-31 10:18:45 +00:00
Initial take of new environment subsystem. Configure with --use-new-environment to active it.
2002-02-19 14:21:19 +00:00
};
#endif // _ENVIRONMENT_HXX
Copy permalink