1 // metar interface class
3 // Written by Melchior FRANZ, started December 2003.
5 // Copyright (C) 2003 Melchior FRANZ - mfranz@aon.at
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.
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.
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.
30 #include <simgear/constants.h>
36 const double SGMetarNaN = -1E20;
37 #define NaN SGMetarNaN
47 class SGMetarVisibility {
70 void set(double dist, int dir = -1, int mod = -1, int tend = -1);
72 inline double getVisibility_m() const { return _distance; }
73 inline double getVisibility_ft() const { return _distance == NaN ? NaN : _distance * SG_METER_TO_FEET; }
74 inline double getVisibility_sm() const { return _distance == NaN ? NaN : _distance * SG_METER_TO_SM; }
75 inline int getDirection() const { return _direction; }
76 inline int getModifier() const { return _modifier; }
77 inline int getTendency() const { return _tendency; }
87 // runway condition (surface and visibility)
100 _wind_shear(false) {}
102 inline int getDeposit() const { return _deposit; }
103 inline const char *getDepositString() const { return _deposit_string; }
104 inline double getExtent() const { return _extent; }
105 inline const char *getExtentString() const { return _extent_string; }
106 inline double getDepth() const { return _depth; }
107 inline double getFriction() const { return _friction; }
108 inline const char *getFrictionString() const { return _friction_string; }
109 inline const char *getComment() const { return _comment; }
110 inline const bool getWindShear() const { return _wind_shear; }
111 inline const SGMetarVisibility& getMinVisibility() const { return _min_visibility; }
112 inline const SGMetarVisibility& getMaxVisibility() const { return _max_visibility; }
115 SGMetarVisibility _min_visibility;
116 SGMetarVisibility _max_visibility;
118 const char *_deposit_string;
120 const char *_extent_string;
123 const char *_friction_string;
124 const char *_comment;
131 friend class SGMetar;
137 COVERAGE_SCATTERED = 2,
139 COVERAGE_OVERCAST = 4
142 static const char * COVERAGE_NIL_STRING;
143 static const char * COVERAGE_CLEAR_STRING;
144 static const char * COVERAGE_FEW_STRING;
145 static const char * COVERAGE_SCATTERED_STRING;
146 static const char * COVERAGE_BROKEN_STRING;
147 static const char * COVERAGE_OVERCAST_STRING;
149 SGMetarCloud() : _coverage(COVERAGE_NIL), _altitude(NaN), _type(0), _type_long(0) {}
151 void set(double alt, Coverage cov = COVERAGE_NIL );
153 inline Coverage getCoverage() const { return _coverage; }
154 static Coverage getCoverage( const std::string & coverage );
155 inline double getAltitude_m() const { return _altitude; }
156 inline double getAltitude_ft() const { return _altitude == NaN ? NaN : _altitude * SG_METER_TO_FEET; }
157 inline const char *getTypeString() const { return _type; }
158 inline const char *getTypeLongString() const { return _type_long; }
161 Coverage _coverage; // quarters: 0 -> clear ... 4 -> overcast
162 double _altitude; // 1000 m
163 const char *_type; // CU
164 const char *_type_long; // cumulus
170 SGMetar(const string& m, const string& proxy = "", const string& port = "",
171 const string &auth = "", const time_t time = 0);
189 Weather() { intensity = NIL; vincinity = false; }
192 vector<string> descriptions;
193 vector<string> phenomena;
196 inline const char *getData() const { return _data; }
197 inline const char *getUnusedData() const { return _m; }
198 inline const bool getProxy() const { return _x_proxy; }
199 inline const char *getId() const { return _icao; }
200 inline int getYear() const { return _year; }
201 inline int getMonth() const { return _month; }
202 inline int getDay() const { return _day; }
203 inline int getHour() const { return _hour; }
204 inline int getMinute() const { return _minute; }
205 inline int getReportType() const { return _report_type; }
207 inline int getWindDir() const { return _wind_dir; }
208 inline double getWindSpeed_mps() const { return _wind_speed; }
209 inline double getWindSpeed_kmh() const { return _wind_speed == NaN ? NaN : _wind_speed * SG_MPS_TO_KMH; }
210 inline double getWindSpeed_kt() const { return _wind_speed == NaN ? NaN : _wind_speed * SG_MPS_TO_KT; }
211 inline double getWindSpeed_mph() const { return _wind_speed == NaN ? NaN : _wind_speed * SG_MPS_TO_MPH; }
213 inline double getGustSpeed_mps() const { return _gust_speed; }
214 inline double getGustSpeed_kmh() const { return _gust_speed == NaN ? NaN : _gust_speed * SG_MPS_TO_KMH; }
215 inline double getGustSpeed_kt() const { return _gust_speed == NaN ? NaN : _gust_speed * SG_MPS_TO_KT; }
216 inline double getGustSpeed_mph() const { return _gust_speed == NaN ? NaN : _gust_speed * SG_MPS_TO_MPH; }
218 inline int getWindRangeFrom() const { return _wind_range_from; }
219 inline int getWindRangeTo() const { return _wind_range_to; }
221 inline const SGMetarVisibility& getMinVisibility() const { return _min_visibility; }
222 inline const SGMetarVisibility& getMaxVisibility() const { return _max_visibility; }
223 inline const SGMetarVisibility& getVertVisibility() const { return _vert_visibility; }
224 inline const SGMetarVisibility *getDirVisibility() const { return _dir_visibility; }
226 inline double getTemperature_C() const { return _temp; }
227 inline double getTemperature_F() const { return _temp == NaN ? NaN : 1.8 * _temp + 32; }
228 inline double getDewpoint_C() const { return _dewp; }
229 inline double getDewpoint_F() const { return _dewp == NaN ? NaN : 1.8 * _dewp + 32; }
230 inline double getPressure_hPa() const { return _pressure == NaN ? NaN : _pressure / 100; }
231 inline double getPressure_inHg() const { return _pressure == NaN ? NaN : _pressure * SG_PA_TO_INHG; }
233 inline int getRain() const { return _rain; }
234 inline int getHail() const { return _hail; }
235 inline int getSnow() const { return _snow; }
236 inline bool getCAVOK() const { return _cavok; }
238 double getRelHumidity() const;
240 inline const vector<SGMetarCloud>& getClouds() const { return _clouds; }
241 inline const map<string, SGMetarRunway>& getRunways() const { return _runways; }
242 inline const vector<string>& getWeather() const { return _weather; }
243 inline const vector<struct Weather> getWeather2() const { return _weather2; }
261 int _wind_range_from;
270 vector<struct Weather> _weather2;
272 SGMetarVisibility _min_visibility;
273 SGMetarVisibility _max_visibility;
274 SGMetarVisibility _vert_visibility;
275 SGMetarVisibility _dir_visibility[8];
276 vector<SGMetarCloud> _clouds;
277 map<string, SGMetarRunway> _runways;
278 vector<string> _weather;
280 bool scanPreambleDate();
281 bool scanPreambleTime();
282 void useCurrentDate();
289 bool scanVariability();
290 bool scanVisibility();
291 bool scanRwyVisRange();
292 bool scanSkyCondition();
294 bool scanTemperature();
296 bool scanRunwayReport();
297 bool scanWindShear();
298 bool scanTrendForecast();
299 bool scanColorState();
301 bool scanRemainder();
303 int scanNumber(char **str, int *num, int min, int max = 0);
304 bool scanBoundary(char **str);
305 const struct Token *scanToken(char **str, const struct Token *list);
306 char *loadData(const char *id, const string& proxy, const string& port,
307 const string &auth, time_t time);
308 void normalizeData();