/application/libraries/PEAR/Services/Weather/Metar.php
PHP | 1921 lines | 1333 code | 117 blank | 471 comment | 340 complexity | 0b932476f53b2d732e619c2c19fde57b MD5 | raw file
Possible License(s): BSD-3-Clause, GPL-3.0, LGPL-2.1
Large files files are truncated, but you can click here to view the full file
- <?php
- /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4 foldmethod=marker: */
- /**
- * PEAR::Services_Weather_Metar
- *
- * PHP versions 4 and 5
- *
- * <LICENSE>
- * Copyright (c) 2005-2009, Alexander Wirtz
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- * o Redistributions of source code must retain the above copyright notice,
- * this list of conditions and the following disclaimer.
- * o Redistributions in binary form must reproduce the above copyright notice,
- * this list of conditions and the following disclaimer in the documentation
- * and/or other materials provided with the distribution.
- * o Neither the name of the software nor the names of its contributors
- * may be used to endorse or promote products derived from this software
- * without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
- * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
- * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
- * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
- * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
- * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
- * POSSIBILITY OF SUCH DAMAGE.
- * </LICENSE>
- *
- * @category Web Services
- * @package Services_Weather
- * @author Alexander Wirtz <alex@pc4p.net>
- * @copyright 2005-2009 Alexander Wirtz
- * @license http://www.opensource.org/licenses/bsd-license.php BSD License
- * @version CVS: $Id: Metar.php 290193 2009-11-03 23:34:06Z eru $
- * @link http://pear.php.net/package/Services_Weather
- * @link http://weather.noaa.gov/weather/metar.shtml
- * @link http://weather.noaa.gov/weather/taf.shtml
- * @example examples/metar-basic.php metar-basic.php
- * @example examples/metar-extensive.php metar-extensive.php
- * @filesource
- */
- require_once "Services/Weather/Common.php";
- require_once "DB.php";
- // {{{ class Services_Weather_Metar
- /**
- * This class acts as an interface to the METAR/TAF service of
- * weather.noaa.gov. It searches for locations given in ICAO notation and
- * retrieves the current weather data.
- *
- * Of course the parsing of the METAR-data has its limitations, as it
- * follows the Federal Meteorological Handbook No.1 with modifications to
- * accomodate for non-US reports, so if the report deviates from these
- * standards, you won't get it parsed correctly.
- * Anything that is not parsed, is saved in the "noparse" array-entry,
- * returned by getWeather(), so you can do your own parsing afterwards. This
- * limitation is specifically given for remarks, as the class is not
- * processing everything mentioned there, but you will get the most common
- * fields like precipitation and temperature-changes. Again, everything not
- * parsed, goes into "noparse".
- *
- * If you think, some important field is missing or not correctly parsed,
- * please file a feature-request/bugreport at http://pear.php.net/ and be
- * sure to provide the METAR (or TAF) report with a _detailed_ explanation!
- *
- * For working examples, please take a look at
- * docs/Services_Weather/examples/metar-basic.php
- * docs/Services_Weather/examples/metar-extensive.php
- *
- *
- * @category Web Services
- * @package Services_Weather
- * @author Alexander Wirtz <alex@pc4p.net>
- * @copyright 2005-2009 Alexander Wirtz
- * @license http://www.opensource.org/licenses/bsd-license.php BSD License
- * @version Release: 1.4.5
- * @link http://pear.php.net/package/Services_Weather
- * @link http://weather.noaa.gov/weather/metar.shtml
- * @link http://weather.noaa.gov/weather/taf.shtml
- * @example examples/metar-basic.php metar-basic.php
- * @example examples/metar-extensive.php metar-extensive.php
- */
- class Services_Weather_Metar extends Services_Weather_Common
- {
- // {{{ properties
- /**
- * Information to access the location DB
- *
- * @var object DB $_db
- * @access private
- */
- var $_db;
- /**
- * The source METAR uses
- *
- * @var string $_sourceMetar
- * @access private
- */
- var $_sourceMetar;
- /**
- * The source TAF uses
- *
- * @var string $_sourceTaf
- * @access private
- */
- var $_sourceTaf;
- /**
- * This path is used to find the METAR data
- *
- * @var string $_sourcePathMetar
- * @access private
- */
- var $_sourcePathMetar;
- /**
- * This path is used to find the TAF data
- *
- * @var string $_sourcePathTaf
- * @access private
- */
- var $_sourcePathTaf;
- // }}}
- // {{{ constructor
- /**
- * Constructor
- *
- * @param array $options
- * @param mixed $error
- * @throws PEAR_Error
- * @access private
- */
- function Services_Weather_Metar($options, &$error)
- {
- $perror = null;
- $this->Services_Weather_Common($options, $perror);
- if (Services_Weather::isError($perror)) {
- $error = $perror;
- return;
- }
- // Set options accordingly
- $status = null;
- if (isset($options["dsn"])) {
- if (isset($options["dbOptions"])) {
- $status = $this->setMetarDB($options["dsn"], $options["dbOptions"]);
- } else {
- $status = $this->setMetarDB($options["dsn"]);
- }
- }
- if (Services_Weather::isError($status)) {
- $error = $status;
- return;
- }
- // Setting the data sources for METAR and TAF - have to watch out for older API usage
- if (($source = isset($options["source"])) || isset($options["sourceMetar"])) {
- $sourceMetar = $source ? $options["source"] : $options["sourceMetar"];
- if (($sourcePath = isset($options["sourcePath"])) || isset($options["sourcePathMetar"])) {
- $sourcePathMetar = $sourcePath ? $options["sourcePath"] : $options["sourcePathMetar"];
- } else {
- $sourcePathMetar = "";
- }
- } else {
- $sourceMetar = "http";
- $sourcePathMetar = "";
- }
- if (isset($options["sourceTaf"])) {
- $sourceTaf = $options["sourceTaf"];
- if (isset($option["sourcePathTaf"])) {
- $sourcePathTaf = $options["sourcePathTaf"];
- } else {
- $soucePathTaf = "";
- }
- } else {
- $sourceTaf = "http";
- $sourcePathTaf = "";
- }
- $status = $this->setMetarSource($sourceMetar, $sourcePathMetar, $sourceTaf, $sourcePathTaf);
- if (Services_Weather::isError($status)) {
- $error = $status;
- return;
- }
- }
- // }}}
- // {{{ setMetarDB()
- /**
- * Sets the parameters needed for connecting to the DB, where the
- * location-search is fetching its data from. You need to build a DB
- * with the external tool buildMetarDB first, it fetches the locations
- * and airports from a NOAA-website.
- *
- * @param string $dsn
- * @param array $dbOptions
- * @return DB_Error|bool
- * @throws DB_Error
- * @see DB::parseDSN
- * @access public
- */
- function setMetarDB($dsn, $dbOptions = array())
- {
- $dsninfo = DB::parseDSN($dsn);
- if (is_array($dsninfo) && !isset($dsninfo["mode"])) {
- $dsninfo["mode"]= 0644;
- }
- // Initialize connection to DB and store in object if successful
- $db = DB::connect($dsninfo, $dbOptions);
- if (DB::isError($db)) {
- return $db;
- }
- $this->_db = $db;
- return true;
- }
- // }}}
- // {{{ setMetarSource()
- /**
- * Sets the source, where the class tries to locate the METAR/TAF data
- *
- * Source can be http, ftp or file.
- * Alternate sourcepaths can be provided.
- *
- * @param string $sourceMetar
- * @param string $sourcePathMetar
- * @param string $sourceTaf
- * @param string $sourcePathTaf
- * @return PEAR_ERROR|bool
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_METAR_SOURCE_INVALID
- * @access public
- */
- function setMetarSource($sourceMetar, $sourcePathMetar = "", $sourceTaf = "", $sourcePathTaf = "")
- {
- if (in_array($sourceMetar, array("http", "ftp", "file"))) {
- $this->_sourceMetar = $sourceMetar;
- } else {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_METAR_SOURCE_INVALID, __FILE__, __LINE__);
- }
- // Check for a proper METAR source if parameter is set, if not set use defaults
- clearstatcache();
- if (strlen($sourcePathMetar)) {
- if (($this->_sourceMetar == "file" && is_dir($sourcePathMetar)) || ($this->_sourceMetar != "file" && parse_url($sourcePathMetar))) {
- $this->_sourcePathMetar = $sourcePathMetar;
- } else {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_METAR_SOURCE_INVALID, __FILE__, __LINE__);
- }
- } else {
- switch ($sourceMetar) {
- case "http":
- $this->_sourcePathMetar = "http://weather.noaa.gov/pub/data/observations/metar/stations";
- break;
- case "ftp":
- $this->_sourcePathMetar = "ftp://weather.noaa.gov/data/observations/metar/stations";
- break;
- case "file":
- $this->_sourcePathMetar = ".";
- break;
- }
- }
- if (in_array($sourceTaf, array("http", "ftp", "file"))) {
- $this->_sourceTaf = $sourceTaf;
- } elseif ($sourceTaf != "") {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_METAR_SOURCE_INVALID, __FILE__, __LINE__);
- }
- // Check for a proper TAF source if parameter is set, if not set use defaults
- clearstatcache();
- if (strlen($sourcePathTaf)) {
- if (($this->_sourceTaf == "file" && is_dir($sourcePathTaf)) || ($this->_sourceTaf != "file" && parse_url($sourcePathTaf))) {
- $this->_sourcePathTaf = $sourcePathTaf;
- } else {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_METAR_SOURCE_INVALID, __FILE__, __LINE__);
- }
- } else {
- switch ($sourceTaf) {
- case "http":
- $this->_sourcePathTaf = "http://weather.noaa.gov/pub/data/forecasts/taf/stations";
- break;
- case "ftp":
- $this->_sourcePathTaf = "ftp://weather.noaa.gov/data/forecasts/taf/stations";
- break;
- case "file":
- $this->_sourcePathTaf = ".";
- break;
- }
- }
- return true;
- }
- // }}}
- // {{{ _checkLocationID()
- /**
- * Checks the id for valid values and thus prevents silly requests to
- * METAR server
- *
- * @param string $id
- * @return PEAR_Error|bool
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_NO_LOCATION
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_INVALID_LOCATION
- * @access private
- */
- function _checkLocationID($id)
- {
- if (is_array($id) || is_object($id) || !strlen($id)) {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_NO_LOCATION, __FILE__, __LINE__);
- } elseif (!ctype_alnum($id) || (strlen($id) > 4)) {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_INVALID_LOCATION, __FILE__, __LINE__);
- }
- return true;
- }
- // }}}
- /**
- * Downloads the weather- or forecast-data for an id from the server dependant on the datatype and returns it
- *
- * @param string $id
- * @param string $dataType
- * @return PEAR_Error|array
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA
- * @access private
- */
- // {{{ _retrieveServerData()
- function _retrieveServerData($id, $dataType) {
- switch($this->{"_source".ucfirst($dataType)}) {
- case "file":
- // File source is used, get file and read as-is into a string
- $source = realpath($this->{"_sourcePath".ucfirst($dataType)}."/".$id.".TXT");
- $data = @file_get_contents($source);
- if ($data === false) {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA, __FILE__, __LINE__);
- }
- break;
- case "http":
- // HTTP used, acquire request object and fetch data from webserver. Return body of reply
- include_once "HTTP/Request.php";
- $request = &new HTTP_Request($this->{"_sourcePath".ucfirst($dataType)}."/".$id.".TXT", $this->_httpOptions);
- $status = $request->sendRequest();
- if (Services_Weather::isError($status) || (int) $request->getResponseCode() <> 200) {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA, __FILE__, __LINE__);
- }
- $data = $request->getResponseBody();
- break;
- case "ftp":
- // FTP as source, acquire neccessary object first
- include_once "Net/FTP.php";
- // Parse source to get the server data
- $server = parse_url($this->{"_sourcePath".ucfirst($dataType)}."/".$id.".TXT");
- // If neccessary options are not set, use defaults
- if (!isset($server["port"]) || $server["port"] == "" || $server["port"] == 0) {
- $server["port"] = 21;
- }
- if (!isset($server["user"]) || $server["user"] == "") {
- $server["user"] = "ftp";
- }
- if (!isset($server["pass"]) || $server["pass"] == "") {
- $server["pass"] = "ftp@";
- }
- // Instantiate object and connect to server
- $ftp = &new Net_FTP($server["host"], $server["port"], $this->_httpOptions["timeout"]);
- $status = $ftp->connect();
- if (Services_Weather::isError($status)) {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA, __FILE__, __LINE__);
- }
- // Login to server...
- $status = $ftp->login($server["user"], $server["pass"]);
- if (Services_Weather::isError($status)) {
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA, __FILE__, __LINE__);
- }
- // ...and retrieve the data into a temporary file
- $tempfile = tempnam("./", "Services_Weather_Metar");
- $status = $ftp->get($server["path"], $tempfile, true, FTP_ASCII);
- if (Services_Weather::isError($status)) {
- unlink($tempfile);
- return Services_Weather::raiseError(SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA, __FILE__, __LINE__);
- }
- // Disconnect FTP server, and read data from temporary file
- $ftp->disconnect();
- $data = @file_get_contents($tempfile);
- unlink($tempfile);
- break;
- }
- // Split data into an array and return
- return preg_split("/\n|\r\n|\n\r/", $data);
- }
- // }}}
- // {{{ _parseWeatherData()
- /**
- * Parses the data and caches it
- *
- * METAR KPIT 091955Z COR 22015G25KT 3/4SM R28L/2600FT TSRA OVC010CB
- * 18/16 A2992 RMK SLP045 T01820159
- *
- * @param array $data
- * @return PEAR_Error|array
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_UNKNOWN_LOCATION
- * @access private
- */
- function _parseWeatherData($data)
- {
- static $compass;
- static $clouds;
- static $cloudtypes;
- static $conditions;
- static $sensors;
- if (!isset($compass)) {
- $compass = array(
- "N", "NNE", "NE", "ENE",
- "E", "ESE", "SE", "SSE",
- "S", "SSW", "SW", "WSW",
- "W", "WNW", "NW", "NNW"
- );
- $clouds = array(
- "skc" => "sky clear",
- "nsc" => "no significant cloud",
- "few" => "few",
- "sct" => "scattered",
- "bkn" => "broken",
- "ovc" => "overcast",
- "vv" => "vertical visibility",
- "tcu" => "Towering Cumulus",
- "cb" => "Cumulonimbus",
- "clr" => "clear below 12,000 ft"
- );
- $cloudtypes = array(
- "low" => array(
- "/" => "Overcast",
- "0" => "None", "1" => "Cumulus (fair weather)",
- "2" => "Cumulus (towering)", "3" => "Cumulonimbus (no anvil)",
- "4" => "Stratocumulus (from Cumulus)", "5" => "Stratocumulus (not Cumulus)",
- "6" => "Stratus or Fractostratus (fair)", "7" => "Fractocumulus/Fractostratus (bad weather)",
- "8" => "Cumulus and Stratocumulus", "9" => "Cumulonimbus (thunderstorm)"
- ),
- "middle" => array(
- "/" => "Overcast",
- "0" => "None", "1" => "Altostratus (thin)",
- "2" => "Altostratus (thick)", "3" => "Altocumulus (thin)",
- "4" => "Altocumulus (patchy)", "5" => "Altocumulus (thickening)",
- "6" => "Altocumulus (from Cumulus)", "7" => "Altocumulus (w/ Altocumulus, Altostratus, Nimbostratus)",
- "8" => "Altocumulus (w/ turrets)", "9" => "Altocumulus (chaotic)"
- ),
- "high" => array(
- "/" => "Overcast",
- "0" => "None", "1" => "Cirrus (filaments)",
- "2" => "Cirrus (dense)", "3" => "Cirrus (often w/ Cumulonimbus)",
- "4" => "Cirrus (thickening)", "5" => "Cirrus/Cirrostratus (low in sky)",
- "6" => "Cirrus/Cirrostratus (high in sky)", "7" => "Cirrostratus (entire sky)",
- "8" => "Cirrostratus (partial)", "9" => "Cirrocumulus or Cirrocumulus/Cirrus/Cirrostratus"
- )
- );
- $conditions = array(
- "+" => "heavy", "-" => "light",
- "vc" => "vicinity", "re" => "recent",
- "nsw" => "no significant weather",
- "mi" => "shallow", "bc" => "patches",
- "pr" => "partial", "ts" => "thunderstorm",
- "bl" => "blowing", "sh" => "showers",
- "dr" => "low drifting", "fz" => "freezing",
- "dz" => "drizzle", "ra" => "rain",
- "sn" => "snow", "sg" => "snow grains",
- "ic" => "ice crystals", "pe" => "ice pellets",
- "pl" => "ice pellets", "gr" => "hail",
- "gs" => "small hail/snow pellets", "up" => "unknown precipitation",
- "br" => "mist", "fg" => "fog",
- "fu" => "smoke", "va" => "volcanic ash",
- "sa" => "sand", "hz" => "haze",
- "py" => "spray", "du" => "widespread dust",
- "sq" => "squall", "ss" => "sandstorm",
- "ds" => "duststorm", "po" => "well developed dust/sand whirls",
- "fc" => "funnel cloud",
- "+fc" => "tornado/waterspout"
- );
- $sensors = array(
- "rvrno" => "Runway Visual Range Detector offline",
- "pwino" => "Present Weather Identifier offline",
- "pno" => "Tipping Bucket Rain Gauge offline",
- "fzrano" => "Freezing Rain Sensor offline",
- "tsno" => "Lightning Detection System offline",
- "visno" => "2nd Visibility Sensor offline",
- "chino" => "2nd Ceiling Height Indicator offline"
- );
- }
- $metarCode = array(
- "report" => "METAR|SPECI",
- "station" => "\w{4}",
- "update" => "(\d{2})?(\d{4})Z",
- "type" => "AUTO|COR",
- "wind" => "(\d{3}|VAR|VRB)(\d{2,3})(G(\d{2,3}))?(FPS|KPH|KT|KTS|MPH|MPS)",
- "windVar" => "(\d{3})V(\d{3})",
- "visFrac" => "(\d{1})",
- "visibility" => "(\d{4})|((M|P)?((\d{1,2}|((\d) )?(\d)\/(\d))(SM|KM)))|(CAVOK)",
- "runway" => "R(\d{2})(\w)?\/(P|M)?(\d{4})(FT)?(V(P|M)?(\d{4})(FT)?)?(\w)?",
- "condition" => "(-|\+|VC|RE|NSW)?(MI|BC|PR|TS|BL|SH|DR|FZ)?((DZ)|(RA)|(SN)|(SG)|(IC)|(PE)|(PL)|(GR)|(GS)|(UP))*(BR|FG|FU|VA|DU|SA|HZ|PY)?(PO|SQ|FC|SS|DS)?",
- "clouds" => "(SKC|CLR|NSC|((FEW|SCT|BKN|OVC|VV)(\d{3}|\/{3})(TCU|CB)?))",
- "temperature" => "(M)?(\d{2})\/((M)?(\d{2})|XX|\/\/)?",
- "pressure" => "(A)(\d{4})|(Q)(\d{4})",
- "trend" => "NOSIG|TEMPO|BECMG",
- "remark" => "RMK"
- );
- $remarks = array(
- "nospeci" => "NOSPECI",
- "autostation" => "AO(1|2)",
- "presschg" => "PRES(R|F)R",
- "seapressure" => "SLP(\d{3}|NO)",
- "precip" => "(P|6|7)(\d{4}|\/{4})",
- "snowdepth" => "4\/(\d{3})",
- "snowequiv" => "933(\d{3})",
- "cloudtypes" => "8\/(\d|\/)(\d|\/)(\d|\/)",
- "sunduration" => "98(\d{3})",
- "1htempdew" => "T(0|1)(\d{3})((0|1)(\d{3}))?",
- "6hmaxtemp" => "1(0|1)(\d{3})",
- "6hmintemp" => "2(0|1)(\d{3})",
- "24htemp" => "4(0|1)(\d{3})(0|1)(\d{3})",
- "3hpresstend" => "5([0-8])(\d{3})",
- "sensors" => "RVRNO|PWINO|PNO|FZRANO|TSNO|VISNO|CHINO",
- "maintain" => "[\$]"
- );
- if (SERVICES_WEATHER_DEBUG) {
- for ($i = 0; $i < sizeof($data); $i++) {
- echo $data[$i]."\n";
- }
- }
- // Eliminate trailing information
- for ($i = 0; $i < sizeof($data); $i++) {
- if (strpos($data[$i], "=") !== false) {
- $data[$i] = substr($data[$i], 0, strpos($data[$i], "="));
- $data = array_slice($data, 0, $i + 1);
- break;
- }
- }
- // Start with parsing the first line for the last update
- $weatherData = array();
- $weatherData["station"] = "";
- $weatherData["dataRaw"] = implode(" ", $data);
- $weatherData["update"] = strtotime(trim($data[0])." GMT");
- $weatherData["updateRaw"] = trim($data[0]);
- // and prepare the rest for stepping through
- array_shift($data);
- $metar = explode(" ", preg_replace("/\s{2,}/", " ", implode(" ", $data)));
- // Add a few local variables for data processing
- $trendCount = 0; // If we have trends, we need this
- $pointer =& $weatherData; // Pointer to the array we add the data to
- for ($i = 0; $i < sizeof($metar); $i++) {
- // Check for whitespace and step loop, if nothing's there
- $metar[$i] = trim($metar[$i]);
- if (!strlen($metar[$i])) {
- continue;
- }
- if (SERVICES_WEATHER_DEBUG) {
- $tab = str_repeat("\t", 3 - floor((strlen($metar[$i]) + 2) / 8));
- echo "\"".$metar[$i]."\"".$tab."-> ";
- }
- // Initialize some arrays
- $result = array();
- $resultVF = array();
- $lresult = array();
- $found = false;
- foreach ($metarCode as $key => $regexp) {
- // Check if current code matches current metar snippet
- if (($found = preg_match("/^".$regexp."$/i", $metar[$i], $result)) == true) {
- switch ($key) {
- case "station":
- $pointer["station"] = $result[0];
- unset($metarCode["station"]);
- break;
- case "wind":
- // Parse wind data, first the speed, convert from kt to chosen unit
- if ($result[5] == "KTS") {
- $result[5] = "KT";
- }
- $pointer["wind"] = $this->convertSpeed($result[2], $result[5], "mph");
- if ($result[1] == "VAR" || $result[1] == "VRB") {
- // Variable winds
- $pointer["windDegrees"] = "Variable";
- $pointer["windDirection"] = "Variable";
- } else {
- // Save wind degree and calc direction
- $pointer["windDegrees"] = intval($result[1]);
- $pointer["windDirection"] = $compass[round($result[1] / 22.5) % 16];
- }
- if (is_numeric($result[4])) {
- // Wind with gusts...
- $pointer["windGust"] = $this->convertSpeed($result[4], $result[5], "mph");
- }
- break;
- case "windVar":
- // Once more wind, now variability around the current wind-direction
- $pointer["windVariability"] = array("from" => intval($result[1]), "to" => intval($result[2]));
- break;
- case "visFrac":
- // Possible fractional visibility here. Check if it matches with the next METAR piece for visibility
- if (!isset($metar[$i + 1]) || !preg_match("/^".$metarCode["visibility"]."$/i", $result[1]." ".$metar[$i + 1], $resultVF)) {
- // No next METAR piece available or not matching. Match against next METAR code
- $found = false;
- break;
- } else {
- // Match. Hand over result and advance METAR
- if (SERVICES_WEATHER_DEBUG) {
- echo $key."\n";
- echo "\"".$result[1]." ".$metar[$i + 1]."\"".str_repeat("\t", 2 - floor((strlen($result[1]." ".$metar[$i + 1]) + 2) / 8))."-> ";
- }
- $key = "visibility";
- $result = $resultVF;
- $i++;
- }
- case "visibility":
- $pointer["visQualifier"] = "AT";
- if (is_numeric($result[1]) && ($result[1] == 9999)) {
- // Upper limit of visibility range
- $visibility = $this->convertDistance(10, "km", "sm");
- $pointer["visQualifier"] = "BEYOND";
- } elseif (is_numeric($result[1])) {
- // 4-digit visibility in m
- $visibility = $this->convertDistance(($result[1]/1000), "km", "sm");
- } elseif (!isset($result[11]) || $result[11] != "CAVOK") {
- if ($result[3] == "M") {
- $pointer["visQualifier"] = "BELOW";
- } elseif ($result[3] == "P") {
- $pointer["visQualifier"] = "BEYOND";
- }
- if (is_numeric($result[5])) {
- // visibility as one/two-digit number
- $visibility = $this->convertDistance($result[5], $result[10], "sm");
- } else {
- // the y/z part, add if we had a x part (see visibility1)
- if (is_numeric($result[7])) {
- $visibility = $this->convertDistance($result[7] + $result[8] / $result[9], $result[10], "sm");
- } else {
- $visibility = $this->convertDistance($result[8] / $result[9], $result[10], "sm");
- }
- }
- } else {
- $pointer["visQualifier"] = "BEYOND";
- $visibility = $this->convertDistance(10, "km", "sm");
- $pointer["clouds"] = array(array("amount" => "Clear below", "height" => 5000));
- $pointer["condition"] = "no significant weather";
- }
- $pointer["visibility"] = $visibility;
- break;
- case "condition":
- // First some basic setups
- if (!isset($pointer["condition"])) {
- $pointer["condition"] = "";
- } elseif (strlen($pointer["condition"]) > 0) {
- $pointer["condition"] .= ",";
- }
- if (in_array(strtolower($result[0]), $conditions)) {
- // First try matching the complete string
- $pointer["condition"] .= " ".$conditions[strtolower($result[0])];
- } else {
- // No luck, match part by part
- array_shift($result);
- $result = array_unique($result);
- foreach ($result as $condition) {
- if (strlen($condition) > 0) {
- $pointer["condition"] .= " ".$conditions[strtolower($condition)];
- }
- }
- }
- $pointer["condition"] = trim($pointer["condition"]);
- break;
- case "clouds":
- if (!isset($pointer["clouds"])) {
- $pointer["clouds"] = array();
- }
- if (sizeof($result) == 5) {
- // Only amount and height
- $cloud = array("amount" => $clouds[strtolower($result[3])]);
- if ($result[4] == "///") {
- $cloud["height"] = "station level or below";
- } else {
- $cloud["height"] = $result[4] * 100;
- }
- } elseif (sizeof($result) == 6) {
- // Amount, height and type
- $cloud = array("amount" => $clouds[strtolower($result[3])], "type" => $clouds[strtolower($result[5])]);
- if ($result[4] == "///") {
- $cloud["height"] = "station level or below";
- } else {
- $cloud["height"] = $result[4] * 100;
- }
- } else {
- // SKC or CLR or NSC
- $cloud = array("amount" => $clouds[strtolower($result[0])]);
- }
- $pointer["clouds"][] = $cloud;
- break;
- case "temperature":
- // normal temperature in first part
- // negative value
- if ($result[1] == "M") {
- $result[2] *= -1;
- }
- $pointer["temperature"] = $this->convertTemperature($result[2], "c", "f");
- if (sizeof($result) > 4) {
- // same for dewpoint
- if ($result[4] == "M") {
- $result[5] *= -1;
- }
- $pointer["dewPoint"] = $this->convertTemperature($result[5], "c", "f");
- $pointer["humidity"] = $this->calculateHumidity($result[2], $result[5]);
- }
- if (isset($pointer["wind"])) {
- // Now calculate windchill from temperature and windspeed
- $pointer["feltTemperature"] = $this->calculateWindChill($pointer["temperature"], $pointer["wind"]);
- }
- break;
- case "pressure":
- if ($result[1] == "A") {
- // Pressure provided in inches
- $pointer["pressure"] = $result[2] / 100;
- } elseif ($result[3] == "Q") {
- // ... in hectopascal
- $pointer["pressure"] = $this->convertPressure($result[4], "hpa", "in");
- }
- break;
- case "trend":
- // We may have a trend here... extract type and set pointer on
- // created new array
- if (!isset($weatherData["trend"])) {
- $weatherData["trend"] = array();
- $weatherData["trend"][$trendCount] = array();
- }
- $pointer =& $weatherData["trend"][$trendCount];
- $trendCount++;
- $pointer["type"] = $result[0];
- while (isset($metar[$i + 1]) && preg_match("/^(FM|TL|AT)(\d{2})(\d{2})$/i", $metar[$i + 1], $lresult)) {
- if ($lresult[1] == "FM") {
- $pointer["from"] = $lresult[2].":".$lresult[3];
- } elseif ($lresult[1] == "TL") {
- $pointer["to"] = $lresult[2].":".$lresult[3];
- } else {
- $pointer["at"] = $lresult[2].":".$lresult[3];
- }
- // As we have just extracted the time for this trend
- // from our METAR, increase field-counter
- $i++;
- }
- break;
- case "remark":
- // Remark part begins
- $metarCode = $remarks;
- $weatherData["remark"] = array();
- break;
- case "autostation":
- // Which autostation do we have here?
- if ($result[1] == 0) {
- $weatherData["remark"]["autostation"] = "Automatic weatherstation w/o precipitation discriminator";
- } else {
- $weatherData["remark"]["autostation"] = "Automatic weatherstation w/ precipitation discriminator";
- }
- unset($metarCode["autostation"]);
- break;
- case "presschg":
- // Decoding for rapid pressure changes
- if (strtolower($result[1]) == "r") {
- $weatherData["remark"]["presschg"] = "Pressure rising rapidly";
- } else {
- $weatherData["remark"]["presschg"] = "Pressure falling rapidly";
- }
- unset($metarCode["presschg"]);
- break;
- case "seapressure":
- // Pressure at sea level (delivered in hpa)
- // Decoding is a bit obscure as 982 gets 998.2
- // whereas 113 becomes 1113 -> no real rule here
- if (strtolower($result[1]) != "no") {
- if ($result[1] > 500) {
- $press = 900 + round($result[1] / 100, 1);
- } else {
- $press = 1000 + $result[1];
- }
- $weatherData["remark"]["seapressure"] = $this->convertPressure($press, "hpa", "in");
- }
- unset($metarCode["seapressure"]);
- break;
- case "precip":
- // Precipitation in inches
- static $hours;
- if (!isset($weatherData["precipitation"])) {
- $weatherData["precipitation"] = array();
- $hours = array("P" => "1", "6" => "3/6", "7" => "24");
- }
- if (!is_numeric($result[2])) {
- $precip = "indeterminable";
- } elseif ($result[2] == "0000") {
- $precip = "traceable";
- } else {
- $precip = $result[2] / 100;
- }
- $weatherData["precipitation"][] = array(
- "amount" => $precip,
- "hours" => $hours[$result[1]]
- );
- break;
- case "snowdepth":
- // Snow depth in inches
- $weatherData["remark"]["snowdepth"] = $result[1];
- unset($metarCode["snowdepth"]);
- break;
- case "snowequiv":
- // Same for equivalent in Water... (inches)
- $weatherData["remark"]["snowequiv"] = $result[1] / 10;
- unset($metarCode["snowequiv"]);
- break;
- case "cloudtypes":
- // Cloud types
- $weatherData["remark"]["cloudtypes"] = array(
- "low" => $cloudtypes["low"][$result[1]],
- "middle" => $cloudtypes["middle"][$result[2]],
- "high" => $cloudtypes["high"][$result[3]]
- );
- unset($metarCode["cloudtypes"]);
- break;
- case "sunduration":
- // Duration of sunshine (in minutes)
- $weatherData["remark"]["sunduration"] = "Total minutes of sunshine: ".$result[1];
- unset($metarCode["sunduration"]);
- break;
- case "1htempdew":
- // Temperatures in the last hour in C
- if ($result[1] == "1") {
- $result[2] *= -1;
- }
- $weatherData["remark"]["1htemp"] = $this->convertTemperature($result[2] / 10, "c", "f");
- if (sizeof($result) > 3) {
- // same for dewpoint
- if ($result[4] == "1") {
- $result[5] *= -1;
- }
- $weatherData["remark"]["1hdew"] = $this->convertTemperature($result[5] / 10, "c", "f");
- }
- unset($metarCode["1htempdew"]);
- break;
- case "6hmaxtemp":
- // Max temperature in the last 6 hours in C
- if ($result[1] == "1") {
- $result[2] *= -1;
- }
- $weatherData["remark"]["6hmaxtemp"] = $this->convertTemperature($result[2] / 10, "c", "f");
- unset($metarCode["6hmaxtemp"]);
- break;
- case "6hmintemp":
- // Min temperature in the last 6 hours in C
- if ($result[1] == "1") {
- $result[2] *= -1;
- }
- $weatherData["remark"]["6hmintemp"] = $this->convertTemperature($result[2] / 10, "c", "f");
- unset($metarCode["6hmintemp"]);
- break;
- case "24htemp":
- // Max/Min temperatures in the last 24 hours in C
- if ($result[1] == "1") {
- $result[2] *= -1;
- }
- $weatherData["remark"]["24hmaxtemp"] = $this->convertTemperature($result[2] / 10, "c", "f");
- if ($result[3] == "1") {
- $result[4] *= -1;
- }
- $weatherData["remark"]["24hmintemp"] = $this->convertTemperature($result[4] / 10, "c", "f");
- unset($metarCode["24htemp"]);
- break;
- case "3hpresstend":
- // Pressure tendency of the last 3 hours
- // no special processing, just passing the data
- $weatherData["remark"]["3hpresstend"] = array(
- "presscode" => $result[1],
- "presschng" => $this->convertPressure($result[2] / 10, "hpa", "in")
- );
- unset($metarCode["3hpresstend"]);
- break;
- case "nospeci":
- // No change during the last hour
- $weatherData["remark"]["nospeci"] = "No changes in weather conditions";
- unset($metarCode["nospeci"]);
- break;
- case "sensors":
- // We may have multiple broken sensors, so do not unset
- if (!isset($weatherData["remark"]["sensors"])) {
- $weatherData["remark"]["sensors"] = array();
- }
- $weatherData["remark"]["sensors"][strtolower($result[0])] = $sensors[strtolower($result[0])];
- break;
- case "maintain":
- $weatherData["remark"]["maintain"] = "Maintainance needed";
- unset($metarCode["maintain"]);
- break;
- default:
- // Do nothing, just prevent further matching
- unset($metarCode[$key]);
- break;
- }
- if ($found && !SERVICES_WEATHER_DEBUG) {
- break;
- } elseif ($found && SERVICES_WEATHER_DEBUG) {
- echo $key."\n";
- break;
- }
- }
- }
- if (!$found) {
- if (SERVICES_WEATHER_DEBUG) {
- echo "n/a\n";
- }
- if (!isset($weatherData["noparse"])) {
- $weatherData["noparse"] = array();
- }
- $weatherData["noparse"][] = $metar[$i];
- }
- }
- if (isset($weatherData["noparse"])) {
- $weatherData["noparse"] = implode(" ", $weatherData["noparse"]);
- }
- return $weatherData;
- }
- // }}}
- // {{{ _parseForecastData()
- /**
- * Parses the data and caches it
- *
- * TAF KLGA 271734Z 271818 11007KT P6SM -RA SCT020 BKN200
- * FM2300 14007KT P6SM SCT030 BKN150
- * FM0400 VRB03KT P6SM SCT035 OVC080 PROB30 0509 P6SM -RA BKN035
- * FM0900 VRB03KT 6SM -RA BR SCT015 OVC035
- * TEMPO 1215 5SM -RA BR SCT009 BKN015
- * BECMG 1517 16007KT P6SM NSW SCT015 BKN070
- *
- * @param array $data
- * @return PEAR_Error|array
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA
- * @throws PEAR_Error::SERVICES_WEATHER_ERROR_UNKNOWN_LOCATION
- * @access private
- */
- function _parseForecastData($data)
- {
- static $compass;
- static $clouds;
- static $conditions;
- static $sensors;
- if (!isset($compass)) {
- $compass = array(
- "N", "NNE", "NE", "ENE",
- "E", "ESE", "SE", "SSE",
- "S", "SSW", "SW", "WSW",
- "W", "WNW", "NW", "NNW"
- );
- $clouds = array(
- "skc" => "sky clear",
- "nsc" => "no significant cloud",
- "few" => "few",
- "sct" => "scattered",
- "bkn" => "broken",
- "ovc" => "overcast",
- "vv" => "vertical visibility",
- "tcu" => "Towering Cumulus",
- "cb" => "Cumulonimbus",
- "clr" => "clear below 12,000 ft"
- );
- $conditions = array(
- "+" => "heavy", "-" => "light",
- "vc" => "vicinity", "re" => "recent",
- "nsw" => "no significant weather",
- "mi" => "shallow", "bc" => "patches",
- "pr" => "partial", "ts" => "thunderstorm",
- "bl" => "blowing", "sh" => "showers",
- "dr" => "low drifting", "fz" => "freezing",
- "dz" => "drizzle", "ra" => "rain",
- "sn" => "snow", "sg" => "snow grains",
- "ic" => "ice crystals", "pe" => "ice pellets",
- "pl" => "ice pellets", "gr" => "hail",
- "gs" => "small hail/snow pellets", "up" => "unknown precipitation",
- "br" => "mist", "fg" => "fog",
- "fu" => "smoke", "va" => "volcanic ash",
- "sa" => "sand", "hz" => "haze",
- "py" => "spray", "du" => "widespread dust",
- "sq" => "squall", "ss" => "sandstorm",
- "ds" => "duststorm", "po" => "well developed dust/sand whirls",
- …
Large files files are truncated, but you can click here to view the full file