Name

gpsplot — tool to dynamically dump plot data from gpsd

Synopsis

gpsplot [-?] [--count COUNT] [-D DEBUG-LEVEL] [--device DEVICE] [--fields FIELDS] [-h] [--help] [--host HOST] [-n COUNT] [--plottype PLOTTYPE] [--port PORT] [--seconds SECONDS] [-u UNITS] [--units UNITS] [-V] [-x SECONDS] [server [:port [:device]]]

DESCRIPTION

gpsplot is a tool to connect to gpsd and dynamically plot data to the users screen. Plot types include scatterplots and stripcharts.

Plotting requires the Python Matplot lib module, and its many dependencies be installed on the display host, but not on the host that is running the gpsd instance.

OPTIONS

--count [COUNT] Exit after [COUNT] plot messages.

--device [DEVICE] Connect to device [DEVICE].

--fields [FIELDS] The code for the fields to plot. FIELDS is one of: llh (lat/lon/altHAE) or llm (lat/lon/altMSL).

--help Print a usage message and exit.

--plottype [PLOTTYPE] The type of plot to make. PLOTTYPE is one of 'scatterplot' or'stripchart'.

--port [PORT] Connect on port [PORT].

--seconds [seconds] Exit after delay of [seconds].

-? Print a usage message and exit.

-D [debug-level] Set debug level..

-h print a usage message and exit.

-n [COUNT] Exit after [COUNT] plot messages.

-p [PORT] Connect on port [PORT].

-V prints the program version, then exits.

-x [seconds] Exit after delay of [seconds].

EXAMPLES

Generate a scatterplot of Latitude, Longitude and the Altitude above Mean Sea Level (altMSL). Stop after 60 seconds:

gpsplot --seconds 60 --fields llm
   

Generate a scatterplot of Latitude, Longitude and the Height Above Ellipsoid (altHAE). Stop after 60 fixes:

gpsplot --count 60 --plottype stripchart
   

Generate a scatterplot locally of Latitude, Longitude and altMSL from a remote gpsd instannce at host "example.com" and the remote device "/dev/ttyS0". Stop after 60 fixes:

gpsplot --count 60 --fields llm example.com::/dev/ttyS0
   

SEE ALSO

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

AUTHOR

Gary E. Miller .