dump1090/tools
2016-08-27 16:13:10 +01:00
..
csv-to-json.py Rearrange json DB stuff so it can work with CSV input. 2016-08-27 16:13:10 +01:00
debug.html A few bugs fixed in debug.html. 2013-01-27 21:42:40 +01:00
extract-icao-ranges.py Regenerate the ICAO ranges table based on data extracted from Annex 10. 2015-09-01 14:21:25 +01:00
README.aircraft-db Rearrange json DB stuff so it can work with CSV input. 2016-08-27 16:13:10 +01:00
vrs-to-csv.py Rearrange json DB stuff so it can work with CSV input. 2016-08-27 16:13:10 +01:00
vrs.csv Rearrange json DB stuff so it can work with CSV input. 2016-08-27 16:13:10 +01:00

The dump1090 webmap uses a static database of json files to provide aircraft
information.

This directory has some tools to turn a CSV file with aircraft data into
the json format that the dump1090 map expects.

The default data comes from a database kindly provided by VRS (unfortunately
no longer updated). This data is in vrs.csv. It was extracted by:

  $ wget http://www.virtualradarserver.co.uk/Files/BasicAircraftLookup.sqb.gz
  $ gunzip BasicAircraftLookup.sqb.gz
  $ tools/vrs-to-csv.py BasicAircraftLookup.sqb >tools/vrs.csv

You can modify vrs.csv (or build a new CSV entirely) and update the database
via:

  $ tools/csv-to-json.py tools/vrs.csv public_html/db

The contents of public_html/db should be installed where the webmap can find
them; the Debian packaging puts these in
/usr/share/dump1090-mutability/html/db

The CSV format is very simple. The first line must be a header line that names
the columns. These columns are understood:

 icao24: the 6-digit hex address of the aircraft
 r: the registration / tail number of the aircraft
 t: the ICAO aircraft type of the aircraft, e.g. B773

Any other columns are put into the json DB under the name you give them, but
the standard map code won't do anything special with them. You can pick these
columns up in the PlaneObject constructor (see planeObject.js where it calls
getAircraftData()) for later use.