1GPSPLOT(1)                    GPSD Documentation                    GPSPLOT(1)
2
3
4

NAME

6       gpsplot - tool to dynamically dump plot data from gpsd
7

SYNOPSIS

9       gpsplot [-?] [--count COUNT] [--debug LVL] [--device DEVICE]
10               [--fields FIELDS] [--file FILE] [--help] [--host HOST]
11               [--plottype PLOTTYPE] [--port PORT] [--seconds SECONDS]
12               [--units UNITS] [--version] [-D LVL] [-h] [-n COUNT] [-u UNITS]
13               [-V] [-x SECONDS] [server [:port [:device]]]
14

DESCRIPTION

16       gpsplot is a tool to connect to gpsd and dynamically plot data to the
17       users screen. Plot types include scatterplots and stripcharts.
18
19       Plotting requires the Python Matplot lib module, and its many
20       dependencies be installed on the display host, but not on the host that
21       is running the gpsd instance.
22

OPTIONS

24       -?, -h, --help
25           Print a usage message and exit.
26
27       -d LVL, --debug LVL
28           Set debug level to LVL.
29
30       --device DEVICE
31           The DEVICE on the gpsd to connect to. Defaults to all.
32
33       --fields FIELDS
34           The code for the fields to plot. FIELDS is one of: llh
35           (lat/lon/altHAE) or llm (lat/lon/altMSL).
36
37       --file FILE
38           Read JSON from FILE instead of from gpsd..
39
40       --host HOST
41           Connect to the gpsd on HOST (server). Defaults to localhost.
42
43       --plottype PLOTTYPE
44           The type of plot to make. PLOTTYPE is one of 'scatterplot'
45           or'stripchart'.
46
47       -n COUNT, --count COUNT
48           Exit after COUNT plot messages.
49
50       -p PORT, --port PORT
51           Use PORT to connect to gpsd. Defaults to 2947.
52
53       -V, --version
54           Print the program version and exit.
55
56       -x SECONDS, --seconds SECONDS
57           Wait for SECONDS seconds before exiting. Set to zero to diable.
58           Default 0.
59

EXAMPLES

61       Generate a scatterplot of Latitude, Longitude and the Altitude above
62       Mean Sea Level (altMSL). Stop after 60 seconds:
63
64           gpsplot --seconds 60 --fields llm
65
66
67       Generate a scatterplot of Latitude, Longitude and the Height Above
68       Ellipsoid (altHAE). Stop after 60 fixes:
69
70           gpsplot --count 60 --plottype stripchart
71
72
73       Generate a scatterplot locally of Latitude, Longitude and altMSL from a
74       remote gpsd instannce at host "example.com" and the remote device
75       "/dev/ttyS0". Stop after 60 fixes:
76
77           gpsplot --count 60 --fields llm example.com::/dev/ttyS0
78
79
80

SEE ALSO

82       gpsd(8), gps(1), gpscat(1).  gpsfake(1), gpsprof(1),
83

AUTHOR

85       Gary E. Miller <gem@rellim.com>.
86
87
88
89The GPSD Project                7 December 2020                     GPSPLOT(1)
Impressum