gpsplot - tool to dynamically dump plot data from gpsd

       By default, clients collect data from the local gpsd daemon running on localhost, using the default GPSD
       port 2947. The optional argument to any client may override this behavior: [server[:port[:device]]]

       For further explanation, and examples, see the ARGUMENTS section in the gps(1) man page

       Gary E. Miller

GPSD 3.25                                          2025-02-12                                         GPSPLOT(1)

       This file is Copyright 2020 by the GPSD project
       SPDX-License-Identifier: BSD-2-clause

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 Matplotlib module, and its many dependencies be installed on the display
       host. If the display host is not the gpsd host, then Matplotlib is not required to be on the gpsd host.

       gpslot does not require root privileges, but can be run as root. Running under sudo will cause some loss
       of functionality. It can be run concurrently with other tools connecting to the local gpsd without
       causing problems.

       You can set the environment variable MPLBACKEND to your desired Matplotlib backend. This save you from
       using -bBACKEND every time you run gpsplot.

       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

       Use the WXAgg backend to repeat the last experiment to see if it is faster or looks better to you.

           export MPLBACKEND=WX
           gpsplot --count 60 --plottype stripchart

       Generate a scatterplot locally of Latitude, Longitude and altMSL from a remote gpsd instance at host
       "example.com" and the remote device "/dev/ttyS0". Collect 60 fixes, Stop, save the plot as "save.jpg, and
       exit:

           gpsplot --count 60 --exit --fields llm --image save.jpg example.com::/dev/ttyS0

       gpsplot - tool to dynamically dump plot data from gpsd

-?, -h, --help
           Print a usage message and exit.

       -bBACKEND, --backendBACKEND
           Set the Matplotlib interactive backend to BACKEND.

       -B, --backends
           Print available Matplotlib interactive backends, then exit. The Matplotlib backends vary wildly in
           how fst they run and how good they look. Try them all to see for yourself.

       -dLVL, --debugLVL
           Set debug level to LVL.

       --deviceDEVICE
           The DEVICE on the gpsd to connect to. Defaults to all.

       --exit
           Exit after --count, --file, or --file completes.

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

       --fileFILE
           Read JSON from FILE instead of from gpsd..

       --hostHOST
           Connect to the gpsd on HOST (server). Defaults to localhost.

       --imageIMAGE.EXT
           Save plot as IMAGE.EXT. EXT determines image type (.jpg, .png, etc.). Which EXT are supported is
           installation dependent.

       -nCOUNT, --countCOUNT
           Stop after COUNT plot messages. 0 to disable. Default 0',

       --plottypePLOTTYPE
           The type of plot to make. PLOTTYPE is one of 'scatterplot' or 'stripchart'.

       -pPORT, --portPORT
           Use PORT to connect to gpsd. Defaults to 2947.

       -V, --version
           Print the program version and exit.

       -xSECONDS, --secondsSECONDS
           Stop after SECONDS. 0 to disable. Default 0',

Projectwebsite: https://gpsd.io/

0
           on success.

       1
           on failure

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

gpsplot [OPTIONS] [server[:port[:device]]]

       gpsplot -h

       gpsplot -V