GPSCSV(1)                     GPSD Documentation                     GPSCSV(1)

<?><?><?> (NAME)
       gpscsv - <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?> JSON
       <?><?> gpsd <?><?> <?><?><?><?> CSV

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gpscsv [OPTIONS] [host[:port[:device]]]

       gpscsv -h

       gpscsv -V

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> gpscsv <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> JSON <?><?> gpsd <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> (CSV) <?><?><?>. <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> gpsd
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> gpsd <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <<-n COUNT>> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <<-x SECONDS>> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?> ^C <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> gpscsv <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?> gpsd <?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> JSON <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> gpspipe <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> gpscsv<?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> CSV <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> gnuplot <?><?><?>.

       <?><?><?><?><?> gpscsv <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> (root) <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?><?>:

       -?, -h, --help
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
           <?><?><?><?>.

       -c MCLASS, --class MCLASS
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> JSON
           <?><?> <?><?><?> MCLASS. <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> TPV <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> CLASSES <?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?>.

       --cvt-isotime
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <<time>>
           <?><?> <?><?><?><?> <?><?><?><?><?> ISO <?><?> <?><?><?><?> UNIX.

       -D LVL, --debug LVL
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?> LVL. <?><?><?><?><?> <?><?><?><?><?><?><?> 0 <?><?><?>.
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> 0
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       --device DEVICE
           <?><?><?><?> <?><?><?><?> DEVICE <?><?><?><?> <?><?> gpsd
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>. <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>.

       -f FIELDS, -fields FIELDS
           <?><?><?><?><?><?><?> (FIELDS) <?><?><?><?> JSON <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> FIELDS <?><?> <?><?><?><?> ('')
           <?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> CLASS <?><?><?><?><?> <?><?><?>.

       --file FILE
           <?><?><?><?><?><?> JSON <?><?> FILE <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?> gpsd.

       --header HEADER
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> HEADER.
           <?><?><?><?><?> 0 <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> 1
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?> 2 <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> ('#').
           <?><?><?><?><?> <?><?><?><?><?><?><?> 1 <?><?><?>.

       --host HOST
           <?><?><?><?><?> <?><?> gpsd <?><?><?> <?><?><?><?><?><?> HOST.
           <?><?><?><?><?> <?><?><?><?><?><?><?> localhost <?><?><?>.

       -n COUNT, --count COUNT
           <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> COUNT <?><?><?><?><?>
           <?><?> <?><?><?><?><?>. <?><?><?><?><?> COUNT <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> 0
           <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?> 0 <?><?><?>.

       --port PORT
           <?><?><?><?><?><?><?> <?><?> PORT <?><?><?><?> <?><?><?><?><?>
           <?><?> gpsd. <?><?><?><?><?><?><?> 2947 <?><?><?>.

       --separator SEPARATOR
           <?><?><?><?><?><?><?> <?><?> SEPARATOR <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?> (',') <?><?><?>.

       -V, --version
           <?><?><?><?><?> <?><?><?><?> gpscsv <?> <?><?><?><?>.

       -x SECONDS, --seconds SECONDS
           <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?> SECONDS
           <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> SECONDS <?><?> <?><?><?> 0 <?><?><?><?>
           <?><?><?><?>.  <?><?><?><?><?><?><?> 0 <?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>..SH
       "<?><?><?><?><?><?><?> (CLASSES)"

       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> JSON <?><?>
       gpsd <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.
       gpscsv <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> (MCLASS) <?><?><?><?><?> <?><?><?><?><?><?>.

       +----------+--------------+-----------------------------------+
       |MCLASS    | <?><?><?><?> | <?><?><?><?><?><?><?>             |
       +----------+--------------+-----------------------------------+
       |ALMANAC   | SUBFRAME     | ALMANAC <?><?> SUBFRAME JSON      |
       +----------+--------------+-----------------------------------+
       |HEALTH    | SUBFRAME     | HEALTH <?><?> SUBFRAME JSON       |
       +----------+--------------+-----------------------------------+
       |HEALTH2   | SUBFRAME     | HEALTH2 <?><?> SUBFRAME JSON      |
       +----------+--------------+-----------------------------------+
       |IONO      | SUBFRAME     | IONO <?><?> SUBFRAME JSON         |
       +----------+--------------+-----------------------------------+
       |NMCT      | SUBFRAME     | NMCT <?><?> SUBFRAME JSON         |
       +----------+--------------+-----------------------------------+
       |SUBFRAME1 | SUBFRAME     | SUBFRAME1 (Ephemeris 1) <?><?>    |
       |          |              | SUBFRAME JSON                     |
       +----------+--------------+-----------------------------------+
       |SUBFRAME2 | SUBFRAME     | SUBFRAME2 (Ephemeris 2) <?><?>    |
       |          |              | SUBFRAME JSON                     |
       +----------+--------------+-----------------------------------+
       |SUBFRAME3 | SUBFRAME     | SUBFRAME3 (Ephemeris 3) <?><?>    |
       |          |              | SUBFRAME JSON                     |
       +----------+--------------+-----------------------------------+
       |SAT       | SKY          | <?><?><?><?><?><?><?><?><?><?><?> |
       |          |              | <?><?><?><?> <?><?> SKY           |
       +----------+--------------+-----------------------------------+
       |SKY       | SKY          | <?><?><?><?><?><?><?>             |
       |          |              | <?><?><?><?> SKY JSON             |
       +----------+--------------+-----------------------------------+
       |TPV       | TPV          | <?><?><?><?><?><?><?>             |
       |          |              | <?><?><?><?> TPV JSON             |
       +----------+--------------+-----------------------------------+
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> gpsd
       <?><?> <?><?><?> <?><?><?><?> <?><?><?> localhost <?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> GPSD <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>:
       [server[:port[:device]]]

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?> ARGUMENTS <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> gps(1) <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?>:

       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       TPV:

           $ gpscsv -c TPV -n 3
           time,lat,lon,altHAE
           2021-07-28T22:38:37.000Z,44.0688638,-121.3140643,1108.223
           2021-07-26T22:38:37.000Z,44.068863833,-121.314064333,1108.3
           2021-07-28T22:38:38.000Z,44.0688637,-121.314065,1108.363

       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>:

           $ gpscsv -c SAT -n 1
           time,gnssid,svid,PRN,az,el,ss,used,health
           2021-07-28T22:37:46.000Z,0,8,8,311.0,28.0,33.0,True,1
           2021-07-28T22:37:46.000Z,0,10,10,290.0,74.0,50.0,True,1
           2021-07-28T22:37:46.000Z,0,15,15,45.0,18.0,31.0,False,1
           2021-07-28T22:37:46.000Z,0,16,16,244.0,7.0,23.0,True,1
           2021-07-28T22:37:46.000Z,0,18,18,109.0,43.0,37.0,True,1
           2021-07-28T22:37:46.000Z,0,23,23,49.0,62.0,38.0,True,1
           2021-07-28T22:37:46.000Z,0,24,24,87.0,16.0,28.0,True,1
           2021-07-28T22:37:46.000Z,0,27,27,280.0,52.0,42.0,True,1
           2021-07-28T22:37:46.000Z,0,32,32,188.0,32.0,42.0,True,1
           2021-07-28T22:37:46.000Z,5,3,195,305.0,6.0,13.0,False,1
           2021-07-28T22:37:46.000Z,6,2,66,38.0,8.0,21.0,False,1
           2021-07-28T22:37:46.000Z,6,3,67,34.0,60.0,32.0,True,1
           2021-07-28T22:37:46.000Z,6,4,68,226.0,63.0,34.0,True,1
           2021-07-28T22:37:46.000Z,6,5,69,220.0,12.0,32.0,True,1
           2021-07-28T22:37:46.000Z,6,11,75,-999,4.0,0.0,False,2
           2021-07-28T22:37:46.000Z,6,12,76,47.0,0.0,0.0,False,1
           2021-07-28T22:37:46.000Z,6,17,81,142.0,8.0,31.0,True,1
           2021-07-28T22:37:46.000Z,6,18,82,138.0,57.0,40.0,True,1
           2021-07-28T22:37:46.000Z,6,19,83,333.0,70.0,29.0,True,1
           2021-07-28T22:37:46.000Z,6,20,84,323.0,10.0,0.0,False,1

   <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> (Plot Examples)
       <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>:

       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       time,lat,lon,altHAE:

             $ gpscsv -n 100 --cvt-isotime  > tpv.dat

       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       time,epx,epy,epv,eph,sep

             $ gpscsv -n 100 --cvt-isotime -f time,epx,epy,epv,eph,sep > ep.dat

       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       time,xdop,ydop,vdop,tdop,hdop,gdop,pdop

             $ gpscsv -n 100 --cvt-isotime -c SKY  > sky.dat

       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> time,nSat,uSat

             $ gpscsv -n 100 --cvt-isotime -c SKY -f time,nSat,uSat  > sat.dat

           <?><?><?><?><?> gnuplot <?><?> <?><?><?><?> <?><?><?><?><?><?>:

                 $ gnuplot

           <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> gnuplot:

                 # this are csv files
                 gnuplot> set datafile separator ','
                 # use the first line as title
                 gnuplot> set key autotitle columnhead
                 # X axis is UNIT time in seconds.
                 gnuplot> set xdata time
                 gnuplot> set timefmt "%s"

           <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> tpv.dat <?><?><?><?>:

                 gnuplot> plot 'tpv.dat' using 1:2

           <?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?> altHAE <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?>:

                 gnuplot> plot 'tpv.dat' using 1:3
                 gnuplot> plot 'tpv.dat' using 1:4

           <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>:

                 gnuplot> set y2tics
                 gnuplot> plot 'tpv.dat' using 1:2, '' using 1:3 axes x1y2

           <?><?><?> epx<?> epy<?> epv<?> eph <?> sep <?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> ep.dat
           <?><?><?><?>:

                 gnuplot> plot 'ep.dat' using 1:2, '' using 1:3, \
                          '' using 1:4, '' using 1:5, '' using 1:6

           <?><?><?> <?><?><?><?><?> DOP<?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> sky.dat <?><?><?><?>:

                 gnuplot> plot 'sky.dat' using 1:2, '' using 1:3, '' using 1:4, \
                          '' using 1:5, '' using 1:6, '' using 1:7, '' using 1:8

           <?><?><?> <?><?><?><?><?><?><?> nSat <?> uSat <?><?>
           <?><?><?><?><?><?>:

                 gnuplot> plot 'sat.dat' using 1:2, '' using 1:3

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> Lat/lon:

                 # x is no longer time
                 gnuplot> set xdata
                 gnuplot> plot 'tpv.dat' using 3:2 title 'fix'

               0
                   <?><?> <?><?><?><?> <?><?><?><?><?><?>.

               1
                   <?><?> <?><?><?><?> <?><?><?><?>

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gpspipe(1), gpsd_json(5), gpsd(8), gnuplot(1)

<?><?><?><?><?> (RESOURCES)
       <?><?><?><?><?><?><?> <?><?><?><?><?>:  <https://gpsd.io>

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYING)
       <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> GPSD <?><?> <?><?><?> 2020 <?><?><?>
       SPDX-License-Identifier: BSD-2-clause

<?><?><?><?><?><?><?> (AUTHOR)
       Gary E. Miller

GPSD, Version 3.27.5              2025-11-04                         GPSCSV(1)