ao-tools/ao-test-gps: Improve output formatting
[fw/altos] / ao-tools / ao-telem / ao-telem.1
1 .\"
2 .\" Copyright © 2009 Keith Packard <keithp@keithp.com>
3 .\"
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" This program is distributed in the hope that it will be useful, but
10 .\" WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 .\" General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License along
15 .\" with this program; if not, write to the Free Software Foundation, Inc.,
16 .\" 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
17 .\"
18 .\"
19 .TH AO-TELEM 1 "ao-telem" ""
20 .SH NAME
21 ao-telem \- Analyse a flight log (either telemetry or eeprom)
22 .SH SYNOPSIS
23 .B "ao-telem"
24 [\-s <summary-file>]
25 [\--summary=<summary-file>]
26 [\-d <detail-file>]
27 [\--detail=<detail-file>]
28 [\-r <raw-file>]
29 [\--raw=<raw-file>]
30 [\-p <plot-file>]
31 [\--plot=<plot-file>]
32 [\-g <gps-file]
33 [\--gps=<gps-file]
34 [\-k <kml-file]
35 [\--kml=<kml-file]
36 {flight.eeprom|flight.telem}
37 .SH DESCRIPTION
38 .I ao-telem
39 reads the specified flight log and produces several different kinds of
40 output.
41 .IP Summary
42 By default, summary information is shown on stdout. With the --summary
43 option, it can be redirected to a file.
44 .IP Detail
45 When requested with the --detail option, a filtered version of the
46 flight position, speed and acceleration are written to the specified
47 file.
48 .IP Raw
49 The --raw option writes the unfiltered, but converted acceleration
50 and height data to the specified file.
51 .IP Plot
52 The --plot option writes plots of height, speed and acceleration to
53 the specified file in .svg format
54 .IP GPS
55 The --gps option writes the recorded GPS data to the specified file in
56 three columns.
57 .IP KML
58 The --kml option writes the recorded GPS data to the specified file in
59 Keyhole Markup Language format, which can be displayed in Googleearth.
60 .SH AUTHOR
61 Keith Packard