1 // FGAILocalTraffic - AIEntity derived class with enough logic to
2 // fly and interact with the traffic pattern.
4 // Written by David Luff, started March 2002.
6 // Copyright (C) 2002 David C. Luff - david.luff@nottingham.ac.uk
8 // This program is free software; you can redistribute it and/or
9 // modify it under the terms of the GNU General Public License as
10 // published by the Free Software Foundation; either version 2 of the
11 // License, or (at your option) any later version.
13 // This program is distributed in the hope that it will be useful, but
14 // WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 // General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the Free Software
20 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 /*****************************************************************
24 * WARNING - Curt has some ideas about AI traffic so anything in here
25 * may get rewritten or scrapped. Contact Curt curt@flightgear.org
26 * before spending any time or effort on this code!!!
28 ******************************************************************/
30 #ifndef _FG_AILocalTraffic_HXX
31 #define _FG_AILocalTraffic_HXX
35 #include <simgear/math/point3d.hxx>
36 #include <Main/fg_props.hxx>
39 #include "AIPlane.hxx"
40 #include "ATCProjection.hxx"
43 typedef enum PatternLeg {
57 typedef enum TaxiState {
63 typedef enum OperatingState {
69 // perhaps we could use an FGRunway instead of this
70 typedef struct RunwayDetails {
71 Point3D threshold_pos;
72 Point3D end1ortho; // ortho projection end1 (the threshold ATM)
73 Point3D end2ortho; // ortho projection end2 (the take off end in the current hardwired scheme)
76 double hdg; // true runway heading
80 typedef struct StartofDescent {
86 class FGAILocalTraffic : public FGAIPlane {
96 // Run the internal calculations
97 void Update(double dt);
99 // Go out and practice circuits
100 void FlyCircuits(int numCircuits, bool tag);
104 // Attempt to enter the traffic pattern in a reasonably intelligent manner
105 void EnterTrafficPattern(double dt);
107 // Do what is necessary to land and parkup at home airport
108 void ReturnToBase(double dt);
112 OperatingState operatingState;
113 int circuitsToFly; //Number of circuits still to do in this session NOT INCLUDING THE CURRENT ONE
114 bool touchAndGo; //True if circuits should be flown touch and go, false for full stop
116 // Its possible that this might be moved out to the ground/airport class at some point.
117 FGATCAlignedProjection ortho; // Orthogonal mapping of the local area with the threshold at the origin
118 // and the runway aligned with the y axis.
120 // Airport/runway/pattern details
121 char* airportID; // The ICAO code of the airport that we're operating around
122 FGGround airport; // FIXME FIXME FIXME This is a complete hardwired cop-out at the moment - we need to connect to the correct ground in the same way we do to the tower.
123 FGTower* tower; // A pointer to the tower control.
125 double patternDirection; // 1 for right, -1 for left (This is double because we multiply/divide turn rates
126 // with it to get RH/LH turns - DON'T convert it to int under ANY circumstances!!
127 double glideAngle; // Assumed to be visual glidepath angle for FGAILocalTraffic - can be found at www.airnav.com
128 // Its conceivable that patternDirection and glidePath could be moved into the RunwayDetails structure.
130 // Performance characteristics of the plane in knots and ft/min - some of this might get moved out into FGAIPlane
132 double best_rate_of_climb_speed;
133 double best_rate_of_climb;
134 double nominal_climb_speed;
135 double nominal_climb_rate;
136 double nominal_circuit_speed;
137 double min_circuit_speed;
138 double max_circuit_speed;
139 double nominal_descent_rate;
140 double nominal_approach_speed;
141 double nominal_final_speed;
142 double stall_speed_landing_config;
143 double nominal_taxi_speed;
145 // environment - some of this might get moved into FGAIPlane
146 SGPropertyNode* wind_from_hdg; //degrees
147 SGPropertyNode* wind_speed_knots; //knots
149 // Pattern details that (may) change
150 int numInPattern; // Number of planes in the pattern (this might get more complicated if high performance GA aircraft fly a higher pattern eventually)
151 int numAhead; // More importantly - how many of them are ahead of us?
152 double distToNext; // And even more importantly, how near are we getting to the one immediately ahead?
153 PatternLeg leg; // Out current position in the pattern
154 StartofDescent SoD; // Start of descent calculated wrt wind, pattern size & altitude, glideslope etc
157 // At the moment this assumes that all taxiing in is to gates (a loose term that includes
158 // any permitted parking spot) and that all taxiing out is to runways.
162 double desiredTaxiHeading;
163 double taxiTurnRadius;
164 double nominalTaxiSpeed;
166 ground_network_path_type path; // a path through the ground network for the plane to taxi
167 int taxiPathPos; // position of iterator in taxi path when applicable
168 node* nextTaxiNode; // next node in taxi path
169 //Runway out_dest; //FIXME - implement this
171 void FlyTrafficPattern(double dt);
173 // TODO - need to add something to define what option we are flying - Touch and go / Stop and go / Landing properly / others?
175 void TransmitPatternPositionReport();
177 void CalculateStartofDescent();
179 void ExitRunway(Point3D orthopos);
183 void Taxi(double dt);
185 void GetNextTaxiNode();
188 #endif // _FG_AILocalTraffic_HXX