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

136 lines
3.6 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>
turn a few #include paths from the "foo" form to <foo> The quotes form is normally only used for headers with path relative to the including file's path, though the standard doesn't strictly mandate this. This is consistent with the rest of sg/fg, it makes the code's intent clearer and helps to find headers. (And it's a few milliseconds faster, too.)
2009-05-14 20:55:09 +00:00
#include <Airports/runwaybase.hxx>
Initial revision.
2000-08-16 01:28:33 +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
// forward decls
class FGAirport;
Directly associate runways objects with their ILS navrecord (if one exists)
2009-06-11 21:53:30 +00:00
class FGNavRecord;
Initial framing for reading in-scenery airport data.
2009-08-29 10:21:21 +00:00
class SGPropertyNode;
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
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
namespace flightgear {
class SID;
class STAR;
}
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
{
FGAirport* _airport;
Make FGRunway track reciprocal runways.
2009-09-16 00:17:12 +00:00
bool _isReciprocal;
FGRunway* _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;
Directly associate runways objects with their ILS navrecord (if one exists)
2009-06-11 21:53:30 +00:00
FGNavRecord* _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:
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
FGRunway(FGAirport* 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,
const int surface_code,
const bool reciprocal);
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
/**
* Test if this runway is the reciprocal. This allows users who iterate
* over runways to avoid counting runways twice, if desired.
*/
bool isReciprocal() const
Make FGRunway track reciprocal runways.
2009-09-16 00:17:12 +00:00
{ return _isReciprocal; }
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 runway begining 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
{ return _displ_thresh * SG_FEET_TO_METER; }
double stopwayM() const
{ return _stopway * SG_FEET_TO_METER; }
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
*/
FGAirport* airport() const
{ return _airport; }
// FIXME - should die once airport / runway creation is cleaned up
void setAirport(FGAirport* aAirport)
{ _airport = aAirport; }
Directly associate runways objects with their ILS navrecord (if one exists)
2009-06-11 21:53:30 +00:00
FGNavRecord* ILS() const { return _ils; }
void setILS(FGNavRecord* nav) { _ils = nav; }
Initial framing for reading in-scenery airport data.
2009-08-29 10:21:21 +00:00
Make FGRunway track reciprocal runways.
2009-09-16 00:17:12 +00:00
FGRunway* reciprocalRunway() const
{ return _reciprocal; }
void setReciprocalRunway(FGRunway* other);
Initial framing for reading in-scenery airport data.
2009-08-29 10:21:21 +00:00
/**
* Helper to process property data loaded from an ICAO.threshold.xml file
*/
void processThreshold(SGPropertyNode* aThreshold);
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
*/
std::vector<flightgear::SID*> getSIDs();
/**
* Get STARs associared with this runway
*/
std::vector<flightgear::STAR*> getSTARs();
Initial revision.
2000-08-16 01:28:33 +00:00
};
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