]> git.mxchange.org Git - flightgear.git/blob - src/AIModel/AIAircraft.cxx
Merge branch 'master' of git://gitorious.org/fg/flightgear into next
[flightgear.git] / src / AIModel / AIAircraft.cxx
1 // // // FGAIAircraft - FGAIBase-derived class creates an AI airplane
2 //
3 // Written by David Culp, started October 2003.
4 //
5 // Copyright (C) 2003  David P. Culp - davidculp2@comcast.net
6 //
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.
11 //
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.
16 //
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.
20
21 #ifdef HAVE_CONFIG_H
22 #  include <config.h>
23 #endif
24
25 #include <simgear/route/waypoint.hxx>
26 #include <Main/fg_props.hxx>
27 #include <Main/globals.hxx>
28 #include <Main/viewer.hxx>
29 #include <Scenery/scenery.hxx>
30 #include <Scenery/tilemgr.hxx>
31 #include <Airports/dynamics.hxx>
32
33 #include <string>
34 #include <math.h>
35 #include <time.h>
36
37 #ifdef _MSC_VER
38 #  include <float.h>
39 #  define finite _finite
40 #elif defined(__sun) || defined(sgi)
41 #  include <ieeefp.h>
42 #endif
43
44 using std::string;
45
46 #include "AIAircraft.hxx"
47 #include "performancedata.hxx"
48 #include "performancedb.hxx"
49
50 //#include <Airports/trafficcontroller.hxx>
51
52 static string tempReg;
53
54 FGAIAircraft::FGAIAircraft(FGAISchedule *ref) : FGAIBase(otAircraft) {
55     trafficRef = ref;
56     if (trafficRef) {
57         groundOffset = trafficRef->getGroundOffset();
58         setCallSign(trafficRef->getCallSign());
59     }
60     else
61         groundOffset = 0;
62
63     fp = 0;
64     controller = 0;
65     prevController = 0;
66     dt_count = 0;
67     dt_elev_count = 0;
68     use_perf_vs = true;
69
70     no_roll = false;
71     tgt_speed = 0;
72     speed = 0;
73     groundTargetSpeed = 0;
74
75     // set heading and altitude locks
76     hdg_lock = false;
77     alt_lock = false;
78     roll = 0;
79     headingChangeRate = 0.0;
80     headingError = 0;
81
82     holdPos = false;
83     needsTaxiClearance = false;
84
85     _performance = 0; //TODO initialize to JET_TRANSPORT from PerformanceDB
86     dt = 0;
87 }
88
89
90 FGAIAircraft::~FGAIAircraft() {
91     //delete fp;
92     if (controller)
93         controller->signOff(getID());
94 }
95
96
97 void FGAIAircraft::readFromScenario(SGPropertyNode* scFileNode) {
98     if (!scFileNode)
99         return;
100
101     FGAIBase::readFromScenario(scFileNode);
102
103     setPerformance(scFileNode->getStringValue("class", "jet_transport"));
104     setFlightPlan(scFileNode->getStringValue("flightplan"),
105                   scFileNode->getBoolValue("repeat", false));
106     setCallSign(scFileNode->getStringValue("callsign"));
107 }
108
109
110 void FGAIAircraft::bind() {
111     FGAIBase::bind();
112
113     props->tie("controls/gear/gear-down",
114                SGRawValueMethods<FGAIAircraft,bool>(*this,
115                                                     &FGAIAircraft::_getGearDown));
116     props->tie("transponder-id",
117                SGRawValueMethods<FGAIAircraft,const char*>(*this,
118                                                     &FGAIAircraft::_getTransponderCode));
119 }
120
121
122 void FGAIAircraft::unbind() {
123     FGAIBase::unbind();
124
125     props->untie("controls/gear/gear-down");
126     props->untie("transponder-id");
127 }
128
129
130 void FGAIAircraft::update(double dt) {
131     FGAIBase::update(dt);
132     Run(dt);
133     Transform();
134 }
135
136 void FGAIAircraft::setPerformance(const std::string& acclass) {
137      static PerformanceDB perfdb; //TODO make it a global service
138      setPerformance(perfdb.getDataFor(acclass));
139   }
140
141
142  void FGAIAircraft::setPerformance(PerformanceData *ps) {
143      _performance = ps;
144   }
145
146
147  void FGAIAircraft::Run(double dt) {
148       FGAIAircraft::dt = dt;
149     
150      bool outOfSight = false, 
151         flightplanActive = true;
152      updatePrimaryTargetValues(flightplanActive, outOfSight); // target hdg, alt, speed
153      if (outOfSight) {
154         return;
155      }
156
157      if (!flightplanActive) {
158         groundTargetSpeed = 0;
159      }
160
161      handleATCRequests(); // ATC also has a word to say
162      updateSecondaryTargetValues(); // target roll, vertical speed, pitch
163      updateActualState(); 
164      UpdateRadar(manager);
165      checkVisibility();
166   }
167
168 void FGAIAircraft::checkVisibility() 
169 {
170   double visibility_meters = fgGetDouble("/environment/visibility-m");
171   FGViewer* vw = globals->get_current_view();
172   invisible = (SGGeodesy::distanceM(vw->getPosition(), pos) > visibility_meters);
173 }
174
175
176
177 void FGAIAircraft::AccelTo(double speed) {
178     tgt_speed = speed;
179 }
180
181
182 void FGAIAircraft::PitchTo(double angle) {
183     tgt_pitch = angle;
184     alt_lock = false;
185 }
186
187
188 void FGAIAircraft::RollTo(double angle) {
189     tgt_roll = angle;
190     hdg_lock = false;
191 }
192
193
194 void FGAIAircraft::YawTo(double angle) {
195     tgt_yaw = angle;
196 }
197
198
199 void FGAIAircraft::ClimbTo(double alt_ft ) {
200     tgt_altitude_ft = alt_ft;
201     alt_lock = true;
202 }
203
204
205 void FGAIAircraft::TurnTo(double heading) {
206     tgt_heading = heading;
207     hdg_lock = true;
208 }
209
210
211 double FGAIAircraft::sign(double x) {
212     if (x == 0.0)
213         return x;
214     else
215         return x/fabs(x);
216 }
217
218
219 void FGAIAircraft::setFlightPlan(const std::string& flightplan, bool repeat) {
220     if (!flightplan.empty()) {
221         FGAIFlightPlan* fp = new FGAIFlightPlan(flightplan);
222         fp->setRepeat(repeat);
223         SetFlightPlan(fp);
224     }
225 }
226
227
228 void FGAIAircraft::SetFlightPlan(FGAIFlightPlan *f) {
229     delete fp;
230     fp = f;
231 }
232
233
234 void FGAIAircraft::ProcessFlightPlan( double dt, time_t now ) {
235
236     // the one behind you
237     FGAIFlightPlan::waypoint* prev = 0;
238     // the one ahead
239     FGAIFlightPlan::waypoint* curr = 0;
240     // the next plus 1
241     FGAIFlightPlan::waypoint* next = 0;
242
243     prev = fp->getPreviousWaypoint();
244     curr = fp->getCurrentWaypoint();
245     next = fp->getNextWaypoint();
246
247     dt_count += dt;
248
249     ///////////////////////////////////////////////////////////////////////////
250     // Initialize the flightplan
251     //////////////////////////////////////////////////////////////////////////
252     if (!prev) {
253         handleFirstWaypoint();
254         return;
255     }                            // end of initialization
256     if (! fpExecutable(now))
257           return;
258     dt_count = 0;
259
260     if (! leadPointReached(curr)) {
261         controlHeading(curr);
262         controlSpeed(curr, next);
263     } else {
264         if (curr->finished)      //end of the flight plan
265         {
266             if (fp->getRepeat())
267                 fp->restart();
268             else
269                 setDie(true);
270             return;
271         }
272
273         if (next) {
274             //TODO more intelligent method in AIFlightPlan, no need to send data it already has :-)
275             tgt_heading = fp->getBearing(curr, next);
276             spinCounter = 0;
277         }
278
279         //TODO let the fp handle this (loading of next leg)
280         fp->IncrementWaypoint( trafficRef != 0 );
281         if (!(fp->getNextWaypoint()) && trafficRef != 0)
282             if (!loadNextLeg()) {
283                 setDie(true);
284                 return;
285             }
286
287         prev = fp->getPreviousWaypoint();
288         curr = fp->getCurrentWaypoint();
289         next = fp->getNextWaypoint();
290
291         // Now that we have incremented the waypoints, excute some traffic manager specific code
292         if (trafficRef) {
293             //TODO isn't this best executed right at the beginning?
294             if (! aiTrafficVisible()) {
295                 setDie(true);
296                 return;
297             }
298
299             if (! handleAirportEndPoints(prev, now)) {
300                 setDie(true);
301                 return;
302             }
303
304             announcePositionToController();
305
306         }
307
308         if (next) {
309             fp->setLeadDistance(tgt_speed, tgt_heading, curr, next);
310         }
311
312         if (!(prev->on_ground))  // only update the tgt altitude from flightplan if not on the ground
313         {
314             tgt_altitude_ft = prev->altitude;
315             if (curr->crossat > -1000.0) {
316                 use_perf_vs = false;
317                 tgt_vs = (curr->crossat - altitude_ft) / (fp->getDistanceToGo(pos.getLatitudeDeg(), pos.getLongitudeDeg(), curr)
318                          / 6076.0 / speed*60.0);
319                 tgt_altitude_ft = curr->crossat;
320             } else {
321                 use_perf_vs = true;
322             }
323         }
324         tgt_speed = prev->speed;
325         hdg_lock = alt_lock = true;
326         no_roll = prev->on_ground;
327     }
328 }
329
330
331 void FGAIAircraft::initializeFlightPlan() {
332 }
333
334
335 bool FGAIAircraft::_getGearDown() const {
336     return _performance->gearExtensible(this);
337 }
338
339
340 const char * FGAIAircraft::_getTransponderCode() const {
341   return transponderCode.c_str();
342 }
343
344
345 bool FGAIAircraft::loadNextLeg() {
346
347     int leg;
348     if ((leg = fp->getLeg())  == 10) {
349         if (!trafficRef->next()) {
350             return false;
351         }
352         setCallSign(trafficRef->getCallSign());
353         leg = 1;
354         fp->setLeg(leg);
355     }
356
357     FGAirport *dep = trafficRef->getDepartureAirport();
358     FGAirport *arr = trafficRef->getArrivalAirport();
359     if (!(dep && arr)) {
360         setDie(true);
361
362     } else {
363         double cruiseAlt = trafficRef->getCruiseAlt() * 100;
364
365         fp->create (this,
366                     dep,
367                     arr,
368                     leg,
369                     cruiseAlt,
370                     trafficRef->getSpeed(),
371                     _getLatitude(),
372                     _getLongitude(),
373                     false,
374                     trafficRef->getRadius(),
375                     trafficRef->getFlightType(),
376                     acType,
377                     company);
378        //cerr << "created  leg " << leg << " for " << trafficRef->getCallSign() << endl;
379     }
380     return true;
381 }
382
383
384 // Note: This code is copied from David Luff's AILocalTraffic
385 // Warning - ground elev determination is CPU intensive
386 // Either this function or the logic of how often it is called
387 // will almost certainly change.
388
389 void FGAIAircraft::getGroundElev(double dt) {
390     dt_elev_count += dt;
391
392     // Update minimally every three secs, but add some randomness
393     // to prevent all AI objects doing this in synchrony
394     if (dt_elev_count < (3.0) + (rand() % 10))
395         return;
396
397     dt_elev_count = 0;
398
399     // Only do the proper hitlist stuff if we are within visible range of the viewer.
400     if (!invisible) {
401         double visibility_meters = fgGetDouble("/environment/visibility-m");
402         FGViewer* vw = globals->get_current_view();
403         
404         if (SGGeodesy::distanceM(vw->getPosition(), pos) > visibility_meters) {
405             return;
406         }
407
408         double range = 500.0;
409         if (!globals->get_tile_mgr()->scenery_available(pos, range)) {
410             // Try to shedule tiles for that position.
411             globals->get_tile_mgr()->update( pos, range );
412         }
413
414         double alt;
415         if (getGroundElevationM(SGGeod::fromGeodM(pos, 20000), alt, 0))
416             tgt_altitude_ft = alt * SG_METER_TO_FEET;
417     }
418 }
419
420
421 void FGAIAircraft::doGroundAltitude() {
422     if (fabs(altitude_ft - (tgt_altitude_ft+groundOffset)) > 1000.0)
423         altitude_ft = (tgt_altitude_ft + groundOffset);
424     else
425         altitude_ft += 0.1 * ((tgt_altitude_ft+groundOffset) - altitude_ft);
426 }
427
428
429 void FGAIAircraft::announcePositionToController() {
430     if (trafficRef) {
431         int leg = fp->getLeg();
432
433         // Note that leg has been incremented after creating the current leg, so we should use
434         // leg numbers here that are one higher than the number that is used to create the leg
435         //
436         switch (leg) {
437           case 2:              // Startup and Push back
438             if (trafficRef->getDepartureAirport()->getDynamics())
439                 controller = trafficRef->getDepartureAirport()->getDynamics()->getStartupController();
440             break;
441         case 3:              // Taxiing to runway
442             if (trafficRef->getDepartureAirport()->getDynamics()->getGroundNetwork()->exists())
443                 controller = trafficRef->getDepartureAirport()->getDynamics()->getGroundNetwork();
444             break;
445         case 4:              //Take off tower controller
446             if (trafficRef->getDepartureAirport()->getDynamics()) {
447                 controller = trafficRef->getDepartureAirport()->getDynamics()->getTowerController();
448             } else {
449                 cerr << "Error: Could not find Dynamics at airport : " << trafficRef->getDepartureAirport()->getId() << endl;
450             }
451             break;
452         case 9:              // Taxiing for parking
453             if (trafficRef->getArrivalAirport()->getDynamics()->getGroundNetwork()->exists())
454                 controller = trafficRef->getArrivalAirport()->getDynamics()->getGroundNetwork();
455             break;
456         default:
457             controller = 0;
458             break;
459         }
460
461         if ((controller != prevController) && (prevController != 0)) {
462             prevController->signOff(getID());
463         }
464         prevController = controller;
465         if (controller) {
466             controller->announcePosition(getID(), fp, fp->getCurrentWaypoint()->routeIndex,
467                                          _getLatitude(), _getLongitude(), hdg, speed, altitude_ft,
468                                          trafficRef->getRadius(), leg, this);
469         }
470     }
471 }
472
473 // Process ATC instructions and report back
474
475 void FGAIAircraft::processATC(FGATCInstruction instruction) {
476     if (instruction.getCheckForCircularWait()) {
477         // This is not exactly an elegant solution, 
478         // but at least it gives me a chance to check
479         // if circular waits are resolved.
480         // For now, just take the offending aircraft 
481         // out of the scene
482         setDie(true);
483         // a more proper way should be - of course - to
484         // let an offending aircraft take an evasive action
485         // for instance taxi back a little bit.
486     }
487     //cerr << "Processing ATC instruction (not Implimented yet)" << endl;
488     if (instruction.getHoldPattern   ()) {}
489
490     // Hold Position
491     if (instruction.getHoldPosition  ()) {
492         if (!holdPos) {
493             holdPos = true;
494         }
495         AccelTo(0.0);
496     } else {
497         if (holdPos) {
498             //if (trafficRef)
499             //  cerr << trafficRef->getCallSign() << " Resuming Taxi." << endl;
500             holdPos = false;
501         }
502         // Change speed Instruction. This can only be excecuted when there is no
503         // Hold position instruction.
504         if (instruction.getChangeSpeed   ()) {
505             //  if (trafficRef)
506             //cerr << trafficRef->getCallSign() << " Changing Speed " << endl;
507             AccelTo(instruction.getSpeed());
508         } else {
509             if (fp) AccelTo(fp->getPreviousWaypoint()->speed);
510         }
511     }
512     if (instruction.getChangeHeading ()) {
513         hdg_lock = false;
514         TurnTo(instruction.getHeading());
515     } else {
516         if (fp) {
517             hdg_lock = true;
518         }
519     }
520     if (instruction.getChangeAltitude()) {}
521
522 }
523
524
525 void FGAIAircraft::handleFirstWaypoint() {
526     bool eraseWaypoints;         //TODO YAGNI
527     headingError = 0;
528     if (trafficRef) {
529         eraseWaypoints = true;
530     } else {
531         eraseWaypoints = false;
532     }
533
534     FGAIFlightPlan::waypoint* prev = 0; // the one behind you
535     FGAIFlightPlan::waypoint* curr = 0; // the one ahead
536     FGAIFlightPlan::waypoint* next = 0;// the next plus 1
537
538     spinCounter = 0;
539     tempReg = "";
540
541     //TODO fp should handle this
542     fp->IncrementWaypoint(eraseWaypoints);
543     if (!(fp->getNextWaypoint()) && trafficRef)
544         if (!loadNextLeg()) {
545             setDie(true);
546             return;
547         }
548
549     prev = fp->getPreviousWaypoint();   //first waypoint
550     curr = fp->getCurrentWaypoint();    //second waypoint
551     next = fp->getNextWaypoint();       //third waypoint (might not exist!)
552
553     setLatitude(prev->latitude);
554     setLongitude(prev->longitude);
555     setSpeed(prev->speed);
556     setAltitude(prev->altitude);
557
558     if (prev->speed > 0.0)
559         setHeading(fp->getBearing(prev->latitude, prev->longitude, curr));
560     else
561         setHeading(fp->getBearing(curr->latitude, curr->longitude, prev));
562
563     // If next doesn't exist, as in incrementally created flightplans for
564     // AI/Trafficmanager created plans,
565     // Make sure lead distance is initialized otherwise
566     if (next)
567         fp->setLeadDistance(speed, hdg, curr, next);
568
569     if (curr->crossat > -1000.0) //use a calculated descent/climb rate
570     {
571         use_perf_vs = false;
572         tgt_vs = (curr->crossat - prev->altitude)
573                  / (fp->getDistanceToGo(pos.getLatitudeDeg(), pos.getLongitudeDeg(), curr)
574                     / 6076.0 / prev->speed*60.0);
575         tgt_altitude_ft = curr->crossat;
576     } else {
577         use_perf_vs = true;
578         tgt_altitude_ft = prev->altitude;
579     }
580     alt_lock = hdg_lock = true;
581     no_roll = prev->on_ground;
582     if (no_roll) {
583         Transform();             // make sure aip is initialized.
584         getGroundElev(60.1);     // make sure it's executed first time around, so force a large dt value
585         doGroundAltitude();
586     }
587     // Make sure to announce the aircraft's position
588     announcePositionToController();
589     prevSpeed = 0;
590 }
591
592
593 /**
594  * Check Execution time (currently once every 100 ms)
595  * Add a bit of randomization to prevent the execution of all flight plans
596  * in synchrony, which can add significant periodic framerate flutter.
597  *
598  * @param now
599  * @return
600  */
601 bool FGAIAircraft::fpExecutable(time_t now) {
602     double rand_exec_time = (rand() % 100) / 100;
603     return (dt_count > (0.1+rand_exec_time)) && (fp->isActive(now));
604 }
605
606
607 /**
608  * Check to see if we've reached the lead point for our next turn
609  *
610  * @param curr
611  * @return
612  */
613 bool FGAIAircraft::leadPointReached(FGAIFlightPlan::waypoint* curr) {
614     double dist_to_go = fp->getDistanceToGo(pos.getLatitudeDeg(), pos.getLongitudeDeg(), curr);
615
616     //cerr << "2" << endl;
617     double lead_dist = fp->getLeadDistance();
618     // experimental: Use fabs, because speed can be negative (I hope) during push_back.
619
620     if (lead_dist < fabs(2*speed)) {
621       //don't skip over the waypoint
622       lead_dist = fabs(2*speed);
623       //cerr << "Extending lead distance to " << lead_dist << endl;
624     }
625
626     //prev_dist_to_go = dist_to_go;
627     //if (dist_to_go < lead_dist)
628     //     cerr << trafficRef->getCallSign() << " Distance : " 
629     //          << dist_to_go << ": Lead distance " 
630     //          << lead_dist << " " << curr->name 
631     //          << " Ground target speed " << groundTargetSpeed << endl;
632    // if (trafficRef) {
633    //      if (trafficRef->getCallSign() == "Transavia7584") {
634    //           cerr << trafficRef->getCallSign() << " " << tgt_altitude_ft << " " << _getSpeed() << " " 
635    //                << _getAltitude() << " "<< _getLatitude() << " " << _getLongitude() << " " << dist_to_go << " " << lead_dist << curr->name << endl; 
636    //      }
637    //  }
638     return dist_to_go < lead_dist;
639 }
640
641
642 bool FGAIAircraft::aiTrafficVisible() {
643   SGGeod userPos(SGGeod::fromDeg(fgGetDouble("/position/longitude-deg"), 
644     fgGetDouble("/position/latitude-deg")));
645   
646   return (SGGeodesy::distanceNm(userPos, pos) <= TRAFFICTOAIDISTTODIE);
647 }
648
649
650 /**
651  * Handle release of parking gate, once were taxiing. Also ensure service time at the gate
652  * in the case of an arrival.
653  *
654  * @param prev
655  * @return
656  */
657
658 //TODO the trafficRef is the right place for the method
659 bool FGAIAircraft::handleAirportEndPoints(FGAIFlightPlan::waypoint* prev, time_t now) {
660     // prepare routing from one airport to another
661     FGAirport * dep = trafficRef->getDepartureAirport();
662     FGAirport * arr = trafficRef->getArrivalAirport();
663
664     if (!( dep && arr))
665         return false;
666
667     // This waypoint marks the fact that the aircraft has passed the initial taxi
668     // departure waypoint, so it can release the parking.
669     //cerr << trafficRef->getCallSign() << " has passed waypoint " << prev->name << " at speed " << speed << endl;
670     if (prev->name == "PushBackPoint") {
671         dep->getDynamics()->releaseParking(fp->getGate());
672         AccelTo(0.0);
673         setTaxiClearanceRequest(true);
674     }
675
676     // This is the last taxi waypoint, and marks the the end of the flight plan
677     // so, the schedule should update and wait for the next departure time.
678     if (prev->name == "END") {
679         time_t nextDeparture = trafficRef->getDepartureTime();
680         // make sure to wait at least 20 minutes at parking to prevent "nervous" taxi behavior
681         if (nextDeparture < (now+1200)) {
682             nextDeparture = now + 1200;
683         }
684         fp->setTime(nextDeparture); // should be "next departure"
685     }
686
687     return true;
688 }
689
690
691 /**
692  * Check difference between target bearing and current heading and correct if necessary.
693  *
694  * @param curr
695  */
696 void FGAIAircraft::controlHeading(FGAIFlightPlan::waypoint* curr) {
697     double calc_bearing = fp->getBearing(pos.getLatitudeDeg(), pos.getLongitudeDeg(), curr);
698     //cerr << "Bearing = " << calc_bearing << endl;
699     if (speed < 0) {
700         calc_bearing +=180;
701         if (calc_bearing > 360)
702             calc_bearing -= 360;
703     }
704
705     if (finite(calc_bearing)) {
706         double hdg_error = calc_bearing - tgt_heading;
707         if (fabs(hdg_error) > 0.01) {
708             TurnTo( calc_bearing );
709         }
710
711     } else {
712         cerr << "calc_bearing is not a finite number : "
713         << "Speed " << speed
714         << "pos : " << pos.getLatitudeDeg() << ", " << pos.getLongitudeDeg()
715         << "waypoint " << curr->latitude << ", " << curr->longitude << endl;
716         cerr << "waypoint name " << curr->name;
717         exit(1);                 // FIXME
718     }
719 }
720
721
722 /**
723  * Update the lead distance calculation if speed has changed sufficiently
724  * to prevent spinning (hopefully);
725  *
726  * @param curr
727  * @param next
728  */
729 void FGAIAircraft::controlSpeed(FGAIFlightPlan::waypoint* curr, FGAIFlightPlan::waypoint* next) {
730     double speed_diff = speed - prevSpeed;
731
732     if (fabs(speed_diff) > 10) {
733         prevSpeed = speed;
734         if (next) {
735             fp->setLeadDistance(speed, tgt_heading, curr, next);
736         }
737     }
738 }
739
740
741 /**
742  * Update target values (heading, alt, speed) depending on flight plan or control properties
743  */
744 void FGAIAircraft::updatePrimaryTargetValues(bool& flightplanActive, bool& aiOutOfSight) {
745     if (fp)                      // AI object has a flightplan
746     {
747         //TODO make this a function of AIBase
748         time_t now = time(NULL) + fgGetLong("/sim/time/warp");
749         //cerr << "UpateTArgetValues() " << endl;
750         ProcessFlightPlan(dt, now);
751
752         // Do execute Ground elev for inactive aircraft, so they
753         // Are repositioned to the correct ground altitude when the user flies within visibility range.
754         // In addition, check whether we are out of user range, so this aircraft
755         // can be deleted.
756         if (onGround()) {
757                 Transform();     // make sure aip is initialized.
758                 getGroundElev(dt);
759                 doGroundAltitude();
760                 // Transform();
761                 pos.setElevationFt(altitude_ft);
762         }
763         if (trafficRef) {
764            //cerr << trafficRef->getRegistration() << " Setting altitude to " << altitude_ft;
765             aiOutOfSight = !aiTrafficVisible();
766             if (aiOutOfSight) {
767                 setDie(true);
768                 //cerr << trafficRef->getRegistration() << " is set to die " << endl;
769                 aiOutOfSight = true;
770                 return;
771             }
772         }
773         timeElapsed = now - fp->getStartTime();
774         flightplanActive = fp->isActive(now);
775     } else {
776         // no flight plan, update target heading, speed, and altitude
777         // from control properties.  These default to the initial
778         // settings in the config file, but can be changed "on the
779         // fly".
780         string lat_mode = props->getStringValue("controls/flight/lateral-mode");
781         if ( lat_mode == "roll" ) {
782             double angle
783             = props->getDoubleValue("controls/flight/target-roll" );
784             RollTo( angle );
785         } else {
786             double angle
787             = props->getDoubleValue("controls/flight/target-hdg" );
788             TurnTo( angle );
789         }
790
791         string lon_mode
792         = props->getStringValue("controls/flight/longitude-mode");
793         if ( lon_mode == "alt" ) {
794             double alt = props->getDoubleValue("controls/flight/target-alt" );
795             ClimbTo( alt );
796         } else {
797             double angle
798             = props->getDoubleValue("controls/flight/target-pitch" );
799             PitchTo( angle );
800         }
801
802         AccelTo( props->getDoubleValue("controls/flight/target-spd" ) );
803     }
804 }
805
806 void FGAIAircraft::updatePosition() {
807     // convert speed to degrees per second
808     double speed_north_deg_sec = cos( hdg * SGD_DEGREES_TO_RADIANS )
809                                  * speed * 1.686 / ft_per_deg_lat;
810     double speed_east_deg_sec  = sin( hdg * SGD_DEGREES_TO_RADIANS )
811                                  * speed * 1.686 / ft_per_deg_lon;
812
813     // set new position
814     pos.setLatitudeDeg( pos.getLatitudeDeg() + speed_north_deg_sec * dt);
815     pos.setLongitudeDeg( pos.getLongitudeDeg() + speed_east_deg_sec * dt);
816 }
817
818
819 void FGAIAircraft::updateHeading() {
820     // adjust heading based on current bank angle
821     if (roll == 0.0)
822         roll = 0.01;
823
824     if (roll != 0.0) {
825         // double turnConstant;
826         //if (no_roll)
827         //  turnConstant = 0.0088362;
828         //else
829         //  turnConstant = 0.088362;
830         // If on ground, calculate heading change directly
831         if (onGround()) {
832             double headingDiff = fabs(hdg-tgt_heading);
833             double bank_sense = 0.0;
834         /*
835         double diff = fabs(hdg - tgt_heading);
836         if (diff > 180)
837             diff = fabs(diff - 360);
838
839         double sum = hdg + diff;
840         if (sum > 360.0)
841             sum -= 360.0;
842         if (fabs(sum - tgt_heading) < 1.0) {
843             bank_sense = 1.0;    // right turn
844         } else {
845             bank_sense = -1.0;   // left turn
846         }*/
847             if (headingDiff > 180)
848                 headingDiff = fabs(headingDiff - 360);
849             double sum = hdg + headingDiff;
850             if (sum > 360.0) 
851                 sum -= 360.0;
852             if (fabs(sum - tgt_heading) > 0.0001) {
853                 bank_sense = -1.0;
854             } else {
855                 bank_sense = 1.0;
856             }
857             //if (trafficRef)
858                 //cerr << trafficRef->getCallSign() << " Heading " 
859                 //     << hdg << ". Target " << tgt_heading <<  ". Diff " << fabs(sum - tgt_heading) << ". Speed " << speed << endl;
860             //if (headingDiff > 60) {
861             groundTargetSpeed = tgt_speed; // * cos(headingDiff * SG_DEGREES_TO_RADIANS);
862                 //groundTargetSpeed = tgt_speed - tgt_speed * (headingDiff/180);
863             //} else {
864             //    groundTargetSpeed = tgt_speed;
865             //}
866             if (sign(groundTargetSpeed) != sign(tgt_speed))
867                 groundTargetSpeed = 0.21 * sign(tgt_speed); // to prevent speed getting stuck in 'negative' mode
868
869             if (headingDiff > 30.0) {
870                 // invert if pushed backward
871                 headingChangeRate += 10.0 * dt * sign(roll);
872
873                 // Clamp the maximum steering rate to 30 degrees per second,
874                 // But only do this when the heading error is decreasing.
875                 if ((headingDiff < headingError)) {
876                     if (headingChangeRate > 30)
877                         headingChangeRate = 30;
878                     else if (headingChangeRate < -30)
879                         headingChangeRate = -30;
880                 }
881             } else {
882                    if (fabs(headingChangeRate) > headingDiff)
883                        headingChangeRate = headingDiff*sign(roll);
884                    else
885                        headingChangeRate += dt * sign(roll);
886             }
887
888             hdg += headingChangeRate * dt * (fabs(speed) / 15);
889             headingError = headingDiff;
890         } else {
891             if (fabs(speed) > 1.0) {
892                 turn_radius_ft = 0.088362 * speed * speed
893                                  / tan( fabs(roll) / SG_RADIANS_TO_DEGREES );
894             } else {
895                 // Check if turn_radius_ft == 0; this might lead to a division by 0.
896                 turn_radius_ft = 1.0;
897             }
898             double turn_circum_ft = SGD_2PI * turn_radius_ft;
899             double dist_covered_ft = speed * 1.686 * dt;
900             double alpha = dist_covered_ft / turn_circum_ft * 360.0;
901             hdg += alpha * sign(roll);
902         }
903         while ( hdg > 360.0 ) {
904             hdg -= 360.0;
905             spinCounter++;
906         }
907         while ( hdg < 0.0) {
908             hdg += 360.0;
909             spinCounter--;
910         }
911     }
912 }
913
914
915 void FGAIAircraft::updateBankAngleTarget() {
916     // adjust target bank angle if heading lock engaged
917     if (hdg_lock) {
918         double bank_sense = 0.0;
919         double diff = fabs(hdg - tgt_heading);
920         if (diff > 180)
921             diff = fabs(diff - 360);
922
923         double sum = hdg + diff;
924         if (sum > 360.0)
925             sum -= 360.0;
926         if (fabs(sum - tgt_heading) < 1.0) {
927             bank_sense = 1.0;    // right turn
928         } else {
929             bank_sense = -1.0;   // left turn
930         }
931         if (diff < _performance->maximumBankAngle()) {
932             tgt_roll = diff * bank_sense;
933         } else {
934             tgt_roll = _performance->maximumBankAngle() * bank_sense;
935         }
936         if ((fabs((double) spinCounter) > 1) && (diff > _performance->maximumBankAngle())) {
937             tgt_speed *= 0.999;  // Ugly hack: If aircraft get stuck, they will continually spin around.
938             // The only way to resolve this is to make them slow down.
939         }
940     }
941 }
942
943
944 void FGAIAircraft::updateVerticalSpeedTarget() {
945     // adjust target Altitude, based on ground elevation when on ground
946     if (onGround()) {
947         getGroundElev(dt);
948         doGroundAltitude();
949     } else if (alt_lock) {
950         // find target vertical speed
951         if (use_perf_vs) {
952             if (altitude_ft < tgt_altitude_ft) {
953                 tgt_vs = tgt_altitude_ft - altitude_ft;
954                 if (tgt_vs > _performance->climbRate())
955                     tgt_vs = _performance->climbRate();
956             } else {
957                 tgt_vs = tgt_altitude_ft - altitude_ft;
958                 if (tgt_vs  < (-_performance->descentRate()))
959                     tgt_vs = -_performance->descentRate();
960             }
961         } else {
962             double max_vs = 4*(tgt_altitude_ft - altitude_ft);
963             double min_vs = 100;
964             if (tgt_altitude_ft < altitude_ft)
965                 min_vs = -100.0;
966             if ((fabs(tgt_altitude_ft - altitude_ft) < 1500.0)
967                     && (fabs(max_vs) < fabs(tgt_vs)))
968                 tgt_vs = max_vs;
969
970             if (fabs(tgt_vs) < fabs(min_vs))
971                 tgt_vs = min_vs;
972         }
973     } //else 
974     //    tgt_vs = 0.0;
975 }
976
977 void FGAIAircraft::updatePitchAngleTarget() {
978     // if on ground and above vRotate -> initial rotation
979     if (onGround() && (speed > _performance->vRotate()))
980         tgt_pitch = 8.0; // some rough B737 value 
981
982     //TODO pitch angle on approach and landing
983     
984     // match pitch angle to vertical speed
985     else if (tgt_vs > 0) {
986         tgt_pitch = tgt_vs * 0.005;
987     } else {
988         tgt_pitch = tgt_vs * 0.002;
989     }
990 }
991
992 string FGAIAircraft::atGate() {
993      string tmp("");
994      if (fp->getLeg() < 3) {
995          if (trafficRef) {
996              if (fp->getGate() > 0) {
997                  FGParking *park =
998                      trafficRef->getDepartureAirport()->getDynamics()->getParking(fp->getGate());
999                  tmp = park->getName();
1000              }
1001          }
1002      }
1003      return tmp;
1004 }
1005
1006 void FGAIAircraft::handleATCRequests() {
1007     //TODO implement NullController for having no ATC to save the conditionals
1008     if (controller) {
1009         controller->update(getID(),
1010                            pos.getLatitudeDeg(),
1011                            pos.getLongitudeDeg(),
1012                            hdg,
1013                            speed,
1014                            altitude_ft, dt);
1015         processATC(controller->getInstruction(getID()));
1016     }
1017 }
1018
1019 void FGAIAircraft::updateActualState() {
1020     //update current state
1021     //TODO have a single tgt_speed and check speed limit on ground on setting tgt_speed
1022     updatePosition();
1023
1024     if (onGround())
1025         speed = _performance->actualSpeed(this, groundTargetSpeed, dt);
1026     else
1027         speed = _performance->actualSpeed(this, tgt_speed, dt);
1028
1029     updateHeading();
1030     roll = _performance->actualBankAngle(this, tgt_roll, dt);
1031
1032     // adjust altitude (meters) based on current vertical speed (fpm)
1033     altitude_ft += vs / 60.0 * dt;
1034     pos.setElevationFt(altitude_ft);
1035
1036     vs = _performance->actualVerticalSpeed(this, tgt_vs, dt);
1037     pitch = _performance->actualPitch(this, tgt_pitch, dt);
1038 }
1039
1040 void FGAIAircraft::updateSecondaryTargetValues() {
1041     // derived target state values
1042     updateBankAngleTarget();
1043     updateVerticalSpeedTarget();
1044     updatePitchAngleTarget();
1045
1046     //TODO calculate wind correction angle (tgt_yaw)
1047 }