fly/flightgear
1
0
Fork 0
Code Activity
flightgear/src/Airports/runways.hxx

135 lines
3.5 KiB
C++
Raw Normal View History

Initial revision.
2000-08-16 01:28:33 +00:00
// runways.hxx -- a simple class to manage airport runway info
//
// Written by Curtis Olson, started August 2000.
//
Fix my mailing address by replacing it with my web page.
2004-11-19 22:10:41 +00:00
// Copyright (C) 2000 Curtis L. Olson - http://www.flightgear.org/~curt
Initial revision.
2000-08-16 01:28:33 +00:00
//
// 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 revision.
2000-08-16 01:28:33 +00:00
//
// $Id$
Redo the runway database scheme to use a flat/ascii file and load the entire database into memory at the start. This should completely eliminate any dependencies we have on metakit.
2003-08-29 04:11:23 +00:00
#ifndef _FG_RUNWAYS_HXX
#define _FG_RUNWAYS_HXX
Initial revision.
2000-08-16 01:28:33 +00:00
#include <simgear/compiler.h>
Clean up/prepare for porting NasalPositioned to cppbind
2013-03-04 15:31:37 +00:00
#include <Navaids/procedure.hxx>
#include "runwaybase.hxx"
#include "airports_fwd.hxx"
Airways/procedures code - add new data structures to store waypoints and procedures, and routing algorithms, and modify the GPS, route manager and WaypointList to use the new objects.
2009-10-11 11:37:13 +00:00
Split runway and taxiway into separate classes, with a (new) common base. This makes taxiways smaller (important since at present there are so many). Restructure the apt.dat parsing code to use a helper class instead of one long function, and to do less work when parsing the file. Some of these ideas come from Yon Uriarte's patches - thanks Yon.
2008-12-29 22:23:22 +00:00
class FGRunway : public FGRunwayBase
{
Implement a persistent cache for navigation data. Cache the parsed navigation and airport data in a binary file to reduce startup times and memory consumption (since only referenced FGPositioned elements are held in memory). Data will be reimported when the mod-time of any input file is changed. If a global file is changed (nav.dat, awy.dat, apt.dat, etc), the cache will be completely rebuilt, which takes approximately 30 seconds on moderate hardware. (Future work may reduce this).
2012-08-27 23:26:36 +00:00
PositionedID _airport;
PositionedID _reciprocal;
Finish conversion of FGRunway to a real class - all public members are gone.
2008-12-24 15:45:35 +00:00
double _displ_thresh;
double _stopway;
Implement a persistent cache for navigation data. Cache the parsed navigation and airport data in a binary file to reduce startup times and memory consumption (since only referenced FGPositioned elements are held in memory). Data will be reimported when the mod-time of any input file is changed. If a global file is changed (nav.dat, awy.dat, apt.dat, etc), the cache will be completely rebuilt, which takes approximately 30 seconds on moderate hardware. (Future work may reduce this).
2012-08-27 23:26:36 +00:00
PositionedID _ils;
James Turner: Improved runway management code: - Runways are now part of an airport, instead of a separate list - Runways are no longer represented as a boring struct, but as a class of their own. -Improved runway access to unify various runway access methods.
2008-08-14 18:13:39 +00:00
public:
Implement a persistent cache for navigation data. Cache the parsed navigation and airport data in a binary file to reduce startup times and memory consumption (since only referenced FGPositioned elements are held in memory). Data will be reimported when the mod-time of any input file is changed. If a global file is changed (nav.dat, awy.dat, apt.dat, etc), the cache will be completely rebuilt, which takes approximately 30 seconds on moderate hardware. (Future work may reduce this).
2012-08-27 23:26:36 +00:00
FGRunway(PositionedID aGuid,
PositionedID aAirport, const std::string& rwy_no,
FGPositioned clean-ups - apply some desirable changes (such as making members const) which were previously tricky but now easy. Make it possible not to index certain types (used for taxiways) and exclude anonymous items from the name index. Related to this, clean up FGRunway further - remove some public members, and fix a dumb bug of mine, where we create reciprocal entries for taxiways. This should make startup (slightly) quicker, and shrinks FGRunway somewhat.
2008-12-24 14:48:30 +00:00
const SGGeod& aGeod,
James Turner: Improved runway management code: - Runways are now part of an airport, instead of a separate list - Runways are no longer represented as a boring struct, but as a class of their own. -Improved runway access to unify various runway access methods.
2008-08-14 18:13:39 +00:00
const double heading, const double length,
const double width,
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
const double displ_thresh,
const double stopway,
Remove isReciprocal from FGRunway. This was a bogus concept, either runways have a reciprocal or not (if singled-ended), really this was simply exposing an artefact of the apt.dat encoding. Change to an API which gives what is actually wanted - the ability to extract an airport's runways without any reciprocals included.
2013-02-28 18:21:23 +00:00
const int surface_code);
James Turner: Improved runway management code: - Runways are now part of an airport, instead of a separate list - Runways are no longer represented as a boring struct, but as a class of their own. -Improved runway access to unify various runway access methods.
2008-08-14 18:13:39 +00:00
/**
* given a runway identifier (06, 18L, 31R) compute the identifier for the
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
* reciprocal heading runway (24, 36R, 13L) string.
James Turner: Improved runway management code: - Runways are now part of an airport, instead of a separate list - Runways are no longer represented as a boring struct, but as a class of their own. -Improved runway access to unify various runway access methods.
2008-08-14 18:13:39 +00:00
*/
static std::string reverseIdent(const std::string& aRunayIdent);
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
James Turner: Improved runway management code: - Runways are now part of an airport, instead of a separate list - Runways are no longer represented as a boring struct, but as a class of their own. -Improved runway access to unify various runway access methods.
2008-08-14 18:13:39 +00:00
/**
* score this runway according to the specified weights. Used by
* FGAirport::findBestRunwayForHeading
*/
double score(double aLengthWt, double aWidthWt, double aSurfaceWt) const;
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
/**
Christoph Korn/PlayDeb.net: fix typos
2012-08-17 21:51:30 +00:00
* Get the runway beginning point - this is syntatic sugar, equivalent to
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
* calling pointOnCenterline(0.0);
*/
Clean up naming of the 'point on runway' helpers, to get rid of the confusing notion of a 'displacedThreshold'. Now there's just a real threshold, displaced or otherwise, and people who care about the paved area can use 'begin' and 'end'. Thanks to John Denker for pointing out the confusion this leads to. Using 'end' also gets rid of the 'reverseThreshold' name, which was clearly a bad choice of mine.
2009-01-03 16:15:48 +00:00
SGGeod begin() const;
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
/**
* Get the (possibly displaced) threshold point.
*/
Clean up naming of the 'point on runway' helpers, to get rid of the confusing notion of a 'displacedThreshold'. Now there's just a real threshold, displaced or otherwise, and people who care about the paved area can use 'begin' and 'end'. Thanks to John Denker for pointing out the confusion this leads to. Using 'end' also gets rid of the 'reverseThreshold' name, which was clearly a bad choice of mine.
2009-01-03 16:15:48 +00:00
SGGeod threshold() const;
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
/**
Clean up naming of the 'point on runway' helpers, to get rid of the confusing notion of a 'displacedThreshold'. Now there's just a real threshold, displaced or otherwise, and people who care about the paved area can use 'begin' and 'end'. Thanks to John Denker for pointing out the confusion this leads to. Using 'end' also gets rid of the 'reverseThreshold' name, which was clearly a bad choice of mine.
2009-01-03 16:15:48 +00:00
* Get the 'far' end - this is equivalent to calling
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
* pointOnCenterline(lengthFt());
*/
Clean up naming of the 'point on runway' helpers, to get rid of the confusing notion of a 'displacedThreshold'. Now there's just a real threshold, displaced or otherwise, and people who care about the paved area can use 'begin' and 'end'. Thanks to John Denker for pointing out the confusion this leads to. Using 'end' also gets rid of the 'reverseThreshold' name, which was clearly a bad choice of mine.
2009-01-03 16:15:48 +00:00
SGGeod end() const;
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
Finish conversion of FGRunway to a real class - all public members are gone.
2008-12-24 15:45:35 +00:00
double displacedThresholdM() const
Convert runway parser and all internals to metric units and 2 runway ends. This eliminates many conversations between ft and m and gives us runway start/end points that are needed for many calculations. Also, this prepares the internals for the upcoming apt.dat 850+ format that uses the metric system as well as start/end points.
2013-02-21 21:47:01 +00:00
{ return _displ_thresh; }
Finish conversion of FGRunway to a real class - all public members are gone.
2008-12-24 15:45:35 +00:00
double stopwayM() const
Convert runway parser and all internals to metric units and 2 runway ends. This eliminates many conversations between ft and m and gives us runway start/end points that are needed for many calculations. Also, this prepares the internals for the upcoming apt.dat 850+ format that uses the metric system as well as start/end points.
2013-02-21 21:47:01 +00:00
{ return _stopway; }
Finish conversion of FGRunway to a real class - all public members are gone.
2008-12-24 15:45:35 +00:00
Directly associate runways objects with their ILS navrecord (if one exists)
2009-06-11 21:53:30 +00:00
/**
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
* Airport this runway is located at
*/
Implement a persistent cache for navigation data. Cache the parsed navigation and airport data in a binary file to reduce startup times and memory consumption (since only referenced FGPositioned elements are held in memory). Data will be reimported when the mod-time of any input file is changed. If a global file is changed (nav.dat, awy.dat, apt.dat, etc), the cache will be completely rebuilt, which takes approximately 30 seconds on moderate hardware. (Future work may reduce this).
2012-08-27 23:26:36 +00:00
FGAirport* airport() const;
James Turner: Convert FGRunway to be heap-based, and inherit FGPositioned. This is a large, ugly change, since FGRunway was essentially a plain struct, with no accessors or abstraction. This change adds various helpers and accessors to FGRunway, but doesn't change many places to use them - that will be a follow up series of patches. It's still a large patch, but outside of FGAirport and FGRunway, mostly mechanical search-and-replace. An interesting part of this change is that reciprocal runways now exist as independent objects, rather than being created on the fly by the search methods. This simplifies some pieces of code that search for and iterate runways. For users who only want one 'end' of a runway, the new 'isReciprocal' predicate allows them to ignore the 'other' end. Current the only user of this is the 'ground-radar' ATC feature. If we had data on which runways are truly 'single-ended', it would now be trivial to use this in the airport loader to *not* create the reciprocal.
2008-09-11 08:38:09 +00:00
Implement a persistent cache for navigation data. Cache the parsed navigation and airport data in a binary file to reduce startup times and memory consumption (since only referenced FGPositioned elements are held in memory). Data will be reimported when the mod-time of any input file is changed. If a global file is changed (nav.dat, awy.dat, apt.dat, etc), the cache will be completely rebuilt, which takes approximately 30 seconds on moderate hardware. (Future work may reduce this).
2012-08-27 23:26:36 +00:00
FGNavRecord* ILS() const;
Directly associate runways objects with their ILS navrecord (if one exists)
2009-06-11 21:53:30 +00:00
Traffic improvements. Make landings and takeoffs look more correct; tweak climb-out and touchdown phases in particular, so the turn to destination heading occurs earlier on climb out, and touchdown occurs close the GS transmitter / some distance down the runway from the beginning.
2012-10-30 15:43:54 +00:00
/**
* retrieve the associated glideslope transmitter, if one is defined.
*/
FGNavRecord* glideslope() const;
Implement a persistent cache for navigation data. Cache the parsed navigation and airport data in a binary file to reduce startup times and memory consumption (since only referenced FGPositioned elements are held in memory). Data will be reimported when the mod-time of any input file is changed. If a global file is changed (nav.dat, awy.dat, apt.dat, etc), the cache will be completely rebuilt, which takes approximately 30 seconds on moderate hardware. (Future work may reduce this).
2012-08-27 23:26:36 +00:00
void setILS(PositionedID nav) { _ils = nav; }
Initial framing for reading in-scenery airport data.
2009-08-29 10:21:21 +00:00
Implement a persistent cache for navigation data. Cache the parsed navigation and airport data in a binary file to reduce startup times and memory consumption (since only referenced FGPositioned elements are held in memory). Data will be reimported when the mod-time of any input file is changed. If a global file is changed (nav.dat, awy.dat, apt.dat, etc), the cache will be completely rebuilt, which takes approximately 30 seconds on moderate hardware. (Future work may reduce this).
2012-08-27 23:26:36 +00:00
FGRunway* reciprocalRunway() const;
void setReciprocalRunway(PositionedID other);
Airways/procedures code - add new data structures to store waypoints and procedures, and routing algorithms, and modify the GPS, route manager and WaypointList to use the new objects.
2009-10-11 11:37:13 +00:00
/**
* Get SIDs (DPs) associated with this runway
*/
Clean up/prepare for porting NasalPositioned to cppbind
2013-03-04 15:31:37 +00:00
flightgear::SIDList getSIDs() const;
Airways/procedures code - add new data structures to store waypoints and procedures, and routing algorithms, and modify the GPS, route manager and WaypointList to use the new objects.
2009-10-11 11:37:13 +00:00
/**
* Get STARs associared with this runway
*/
Clean up/prepare for porting NasalPositioned to cppbind
2013-03-04 15:31:37 +00:00
flightgear::STARList getSTARs() const;
Create a real FlightPlan (and Leg) class Convert the route-manager to use a flight-plan internally, and expose flightplan, leg and procedure data to Nasal. Move the Level-D parser into its own file.
2012-04-24 21:55:30 +00:00
Clean up/prepare for porting NasalPositioned to cppbind
2013-03-04 15:31:37 +00:00
flightgear::ApproachList getApproaches
(
flightgear::ProcedureType type = flightgear::PROCEDURE_INVALID
) const;
Expose FGPositioned data via property tree, and make comm-stations a real FGPositioned subclass.
2011-05-25 06:50:15 +00:00
Initial revision.
2000-08-16 01:28:33 +00:00
};
Add support for helipads from apt.dat 850+
2013-02-20 22:35:32 +00:00
class FGHelipad : public FGRunwayBase
{
public:
FGHelipad(PositionedID aGuid,
PositionedID aAirport, const std::string& rwy_no,
const SGGeod& aGeod,
const double heading, const double length,
const double width,
const int surface_code);
};
Redo the runway database scheme to use a flat/ascii file and load the entire database into memory at the start. This should completely eliminate any dependencies we have on metakit.
2003-08-29 04:11:23 +00:00
#endif // _FG_RUNWAYS_HXX
Copy permalink