README

PHPMetarTafParser is a library written in PHP(7.2) to parse METAR and TAF messages.

The MetarParser and the TAFParser contain a method parse returning a metar object or a TAF object.

Add dependency

Using composer:

composer require mivek/php-metar-taf-parser

Model

AbstractWeatherContainer

Abstract class containing the basic elements

Wind
Visibility
Clouds (Cloud[])
WeatherConditions (WeatherCondition[])
Remark (string)
Cavok (bool)
VerticalVisibility (array)

AbstractWeatherCode

Subclass of AbstractWeatherContainer.

icao (string) ICAO of the airport
day (int) Delivery day
time (Time) Delivery time
message (string) raw message

Metar

Subclass of AbstractWeatherCode

temperature (int)
dewPoint (int)
altimeter (array) Array with keys value and unit
nosig (bool)
auto (bool)
runwaysinfo (RunwayInfo[])
trends (MetarTrend[])

TAF

Subclass of AbstractWeatherCode

validity (Validity)
minTemperature (DatedTemperature)
maxTemperature (DatedTemperature)
trends (TAFTrend[])
probTrends (ProbTafTrend[])
amendment (bool)

RunwayInfo

Represents the visibility on a runway

name (string) Name of the runway
trend (string)
minRange (int)
maxRange (int)

Cloud

Represents a cloud layer

Quantity (string)
Type of cloud (string optional)
Height of the layer (string optional)

DatedTemperature

Temperature in celsius (int)
Day (int)
Hour (int)

Time

Represents the delivery time of a Metar or a TAF

Hours (int)
Minutes (int)

Validity

Represents the validity of a TAF or of a TAFTrend

startDay (int)
startHour (int)
startMinute (int)
endDay (int)
endHour (int)

Visibility

Represents the visibility of a AbstractWeatherContainer

mainVisibility : array with keys 'visibility' and 'unit'
minVisibility : array with keys 'visibility' and 'direction'

Wind

Represents the wind element

direction (int) The direction of the wind in degrees
cardinalDirection (string) The cardinal direction or VRB token
speed (int)
unit (string) unit of the speed
gusts (int) speed of the gusts if applicable
variable_wind (array) array with keys min and max containing the direction of variable wind if applicable.

WindShear

Subclass of Wind

height (int) Height in feet of the windshear.

Trends

Both METAR and TAF can contain trends

AbstractTrend

Abstract parent class of trend classes.

type: string for the type of trend. Either TEMPO, BECMG, FM or PROB

MetarTrend

Class representing a trend of a metar, composed of

times: array of MetarTrendTime to represent the times of the trend

MetarTrendTime

type (string) AT, FM or TL
time: array of hour and minute

TafTrend

Subclass of AbstractTrend composed of

Validity

ProbTafTrend

Subclass of the TafTrend composed of

probability (int) probability of the trend

Examples:

Parsing a METAR

$code = "LFBG 081130Z AUTO 23012KT 9999 SCT022 BKN072 BKN090 22/16 Q1011 TEMPO 26015G25KT 3000 TSRA SCT025CB BKN050";
$metarParser = new \PHPMetarTafParser\Parser\MetarParser();
$metar = $metarParser->parse($code);

The result metar is:

Parsing a TAF

$code = "TAF LSZH 292025Z 2921/3103 VRB03KT 9999 FEW020 BKN080 TX20/3014Z TN06/3003Z " .
        "PROB30 TEMPO 2921/2923 SHRA " .
        "BECMG 3001/3004 4000 MIFG NSC " .
        "PROB40 3003/3007 1500 BCFG SCT004 " .
        "PROB30 3004/3007 0800 FG VV003 " .
        "BECMG 3006/3009 9999 FEW030 " .
        "PROB40 TEMPO 3012/3017 30008KT";

$tafParser = new \PHPMetarTafParser\Parser\TAFParser();
$taf = $tafParser->parse($code);

The result object is:

mivek / php-metar-taf-parser

Maintainers

Details