src/ATCDCL/commlist.hxx

   1 // commlist.hxx -- comm frequency lookup class
   2 //
   3 // Written by David Luff and Alexander Kappes, started Jan 2003.
   4 // Based on navlist.hxx by Curtis Olson, started April 2000.
   5 //
   6 // Copyright (C) 2000  Curtis L. Olson - http://www.flightgear.org/~curt
   7 //
   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.
  12 //
  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.
  17 //
  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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  21
  22 /*****************************************************************
  23 *
  24 * FGCommList is used to store communication frequency information
  25 * for the ATC and AI subsystems.  Two maps are maintained - one
  26 * searchable by location and one searchable by frequency.  The
  27 * data structure returned from the search is the ATCData struct
  28 * defined in ATC.hxx, containing location, frequency, name, range
  29 * and type of the returned station.
  30 *
  31 ******************************************************************/
  32
  33 #ifndef _FG_COMMLIST_HXX
  34 #define _FG_COMMLIST_HXX
  35
  36
  37 #include <simgear/compiler.h>
  38 #include <simgear/misc/sg_path.hxx>
  39
  40 #include <map>
  41 #include <list>
  42 #include <string>
  43
  44 #include "ATC.hxx"
  45 #include "atis.hxx"
  46
  47 using std::list;
  48 using std::map;
  49 using std::vector;
  50 using std::string;
  51
  52 // A list of ATC stations
  53 typedef list < ATCData > comm_list_type;
  54 typedef comm_list_type::iterator comm_list_iterator;
  55 typedef comm_list_type::const_iterator comm_list_const_iterator;
  56
  57 // A map of ATC station lists
  58 typedef map < int, comm_list_type > comm_map_type;
  59 typedef comm_map_type::iterator comm_map_iterator;
  60 typedef comm_map_type::const_iterator comm_map_const_iterator;
  61
  62
  63 class FGCommList {
  64
  65 public:
  66
  67     FGCommList();
  68     ~FGCommList();
  69
  70     // load all comm frequencies and build the map
  71     bool init( const SGPath& path );
  72
  73     // query the database for the specified frequency, lon and lat are
  74     // in degrees, elev is in meters.
  75         // If no atc_type is specified, it returns true if any non-invalid type is found.
  76         // If atc_type is specifed, returns true only if the specified type is found.
  77         // Returns the station closest to the supplied position.
  78         // The data found is written into the passed-in ATCData structure.
  79     bool FindByFreq( double lon, double lat, double elev, double freq, ATCData* ad, atc_type tp = INVALID );
  80
  81     // query the database by location, lon and lat are in degrees, elev is in meters, range is in nautical miles.
  82         // Returns the number of stations of the specified atc_type tp that are in range of the position defined by
  83         // lon, lat and elev, and pushes them into stations.
  84         // If no atc_type is specifed, returns the number of all stations in range, and pushes them into stations
  85         // ** stations is erased before use **
  86     int FindByPos( double lon, double lat, double elev, double range, comm_list_type* stations, atc_type tp = INVALID );
  87
  88         // Returns the distance in meters to the closest station of a given type,
  89         // with the details written into ATCData& ad.  If no type is specifed simply
  90         // returns the distance to the closest station of any type.
  91         // Returns -9999 if no stations found within max_range in nautical miles (default 100 miles).
  92         // Note that the search algorithm starts at 10 miles and multiplies by 10 thereafter, so if
  93         // say 300 miles is specifed 10, then 100, then 1000 will be searched, breaking at first result
  94         // and giving up after 1000.
  95         // !!!Be warned that searching anything over 100 miles will pause the sim unacceptably!!!
  96         //      (The ability to search longer ranges should be used during init only).
  97         double FindClosest( double lon, double lat, double elev, ATCData& ad, atc_type tp = INVALID, double max_range = 100.0 );
  98
  99         // Find by Airport code.
 100         bool FindByCode( const string& ICAO, ATCData& ad, atc_type tp = INVALID );
 101
 102     // Return the callsign for an ATIS transmission given transmission time and airport id
 103         // This maybe should get moved somewhere else!!
 104     int GetCallSign( const string& apt_id, int hours, int mins );
 105
 106 private:
 107
 108         // Comm stations mapped by frequency
 109         comm_map_type commlist_freq;
 110
 111         // Comm stations mapped by bucket
 112         comm_map_type commlist_bck;
 113
 114         // Load comms from a specified path (which must include the filename)
 115         bool LoadComms(const SGPath& path);
 116
 117 //----------- This stuff is left over from atislist.[ch]xx and maybe should move somewhere else
 118         // Add structure and map for storing a log of atis transmissions
 119         // made in this session of FlightGear.  This allows the callsign
 120         // to be allocated correctly wrt time.
 121         typedef struct {
 122                 int hours;
 123                 int mins;
 124                 int callsign;
 125         } atis_transmission_type;
 126
 127     typedef map < string, atis_transmission_type > atis_log_type;
 128     typedef atis_log_type::iterator atis_log_iterator;
 129     typedef atis_log_type::const_iterator atis_log_const_iterator;
 130
 131     atis_log_type atislog;
 132 //-----------------------------------------------------------------------------------------------
 133
 134 };
 135
 136
 137 extern FGCommList *current_commlist;
 138
 139
 140 #endif // _FG_COMMLIST_HXX