Initial import
[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
17 # Downloading
18
19 METAR parser home page is at
20 <http://solitudo.net/software/lua/metar/> and it can be downloaded
21 from the public Git repository at `git://scm.solitudo.net/metar.git`.
22 Gitweb interface is available at
23 <http://scm.solitudo.net/gitweb/public/metar.git>.
24
25 Remember to download the submodules after cloning `metar.git`.
26
27 1. $ `git submodule init`
28 1. $ `git submodule update`
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 [libgweather](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: © 2010 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`.