Updated submodules mdwn2text and luadoc-ikiwiki
[metar.git] / README.mdwn
1 # Lua METAR parser
2
3 This library can be used to parse METAR coded weather reports
4 and fetch current METAR reports from [NOAA](http://www.noaa.gov)
5 [Internet Weather Service](http://weather.noaa.gov) in Lua.
6
7 The parser is pretty simple and by no means claims to support every feature one
8 might find in METAR coded weather reports. For example, weather forecasts and
9 automatic weather reports are not detected. Unsupported features in
10 the weather reports are silently dropped.
11
12 # Dependencies
13
14 [LuaSocket](http://www.cs.princeton.edu/~diego/professional/luasocket/) is
15 required for fetching weather reports from the [Internet Weather Service](http://weather.noaa.gov).
16 On Debian/Ubuntu systems you can install the package `liblua5.1-socket2`
17 in order to get LuaSocket installed.
18
19 My [Lua weather library](http://solitudo.net/software/lua/weatherlib/) is
20 required for doing some unit conversions.
21
22 # Downloading
23
24 METAR parser home page is at
25 <http://solitudo.net/software/lua/metar/> and it can be downloaded
26 by cloning the public Git repository at `git://scm.solitudo.net/metar.git`.
27 Gitweb interface is available at
28 <http://scm.solitudo.net/gitweb/public/metar.git>.
29
30 # Installation
31
32 Install the `src/metar.lua` under some of the directories included in the
33 default `LUA_PATH` for your Lua distribution, or install under desired location
34 and set `LUA_PATH` accordingly. More info about `LUA_PATH` at
35 <http://www.lua.org/pil/8.1.html>.
36
37 # API Documentation
38
39 API documentation for `metar` is available under the `api/` directory of
40 the distribution.
41
42 # References
43
44 The following material was used when researching METAR
45
46 * [Federal Meteorological Handbook No. 1 - Surface Weather Observations and Reports](http://www.ofcm.gov/fmh-1/fmh1.htm)
47 * [Metar codes by Richard Ogley](http://www.astro.keele.ac.uk/oldusers/rno/Aviation/metar_codes.html)
48 * [Meteorology @ West Moors - Metar decode](http://booty.org.uk/booty.weather/metinfo/codes/METAR_decode.htm)
49 * Source code of [GWeather](http://ftp.gnome.org/pub/GNOME/sources/libgweather/)
50 * Source code of [Metar](http://www.leune.org/metar/)
51
52 # Copyright and licensing
53
54 Copyright: © 2011 Tuomas Jormola <tj@solitudo.net> <http://solitudo.net>
55
56 Licensed under the terms of the [GNU General Public License Version 2.0](http://www.gnu.org/licenses/gpl-2.0.html).
57 License terms are included in the file `COPYING`.