Merge branch 'next' into navaids-radio

[flightgear.git] / src / Radio / antenna.hxx

diff --git a/src/Radio/antenna.hxx b/src/Radio/antenna.hxx
index 3e6da25664b6a7f1186919f1e6b8302a370c0363..55247e61e94b895abac0ef077f0f3d8cd7d60a1c 100644 (file)
--- a/src/Radio/antenna.hxx
+++ b/src/Radio/antenna.hxx
@@ -1,6 +1,6 @@
 // antenna.hxx -- FGRadioAntenna: class to represent antenna properties
 //
-// Written by Adrian Musceac, started December 2011.
+// Written by Adrian Musceac YO8RZZ, started December 2011.
 //
 // This program is free software; you can redistribute it and/or
 // modify it under the terms of the GNU General Public License as
@@ -27,11 +27,21 @@
 #include <simgear/math/sg_geodesy.hxx>
 #include <simgear/debug/logstream.hxx>
 
+using std::string;
+
 class FGRadioAntenna
 {
 private:
-       void load_antenna_pattern();
-       int _mirror_y;
+       
+/*** load external plot file generated by NEC2. needs to have a txt extension
+*      when naming plots, use the following scheme: type_frequencyMHz.txt
+*      eg: yagi_110.txt or LPDA_333.txt
+*      @param: name of file
+*      @return: none
+***/
+       void load_NEC_antenna_pattern(string type);
+       
+       int _mirror_y;  
        int _mirror_z;
        int _invert_ground;
        double _heading_deg;
@@ -41,15 +51,22 @@ private:
                double elevation;
                double gain;
        };
-       
-       typedef std::vector<AntennaGain> AntennaPattern;
+       SGPath _pattern_file;
+       typedef std::vector<AntennaGain*> AntennaPattern;
        AntennaPattern _pattern;
        
 public:
        
-       FGRadioAntenna();
+       FGRadioAntenna(string type);
     ~FGRadioAntenna();
-       double calculate_gain(double azimuth, double elevation);
-       
+
+/*** calculate far-field antenna gain on a 3D volume around it
+*      @param: bearing to the other station, vertical angle (some call it theta)
+*      @return: gain relative to maximum normalized gain. will be negative in all cases
+***/
+       double calculate_gain(double bearing, double angle);
        
+       /// some convenience setters and getters (unused for now)
+       inline void set_heading(double heading_deg) {_heading_deg = heading_deg ;};
+       inline void set_elevation_angle(double elevation_angle_deg) {_elevation_angle_deg = elevation_angle_deg ;};
 };