Information on statistics file formats

The xntp3 daemon can produce a variety of statistics files which are
useful for maintenance, evaluation and retrospective calibration
purposes. See the xntpd.8 man page for instructions on how to configure
this feature. Since these files can become rather large and cumbersome,
they are ordinarily reduced to summary form by running the summary.sh
shell script once per day, week or month, as appropriate. There are
three file collections presently defined: peerstats, loopstats and
clockstats, each of which is described in this note.

peerstats

The following data are collected in the peerstats files. The files are
reduced to summary data using the peer.sh shell script. See the peer.awk
script for further information. A line in the file is produced upon
reception of each valid update from a configured peer.

  49236 30.756 140.173.96.1 9474 0.000603 0.37532

  49236         modified Julian day number
  30.756        time of day (s) past midnight UTC
  140.173.96.1  peer identifier (IP address or receiver identifier)
  9474          peer status word (hex) (see NTP specification)
  0.000603      offset (s)
  0.08929       delay (s)
  0.37532       dispersion (s)

loopstats

The following data are collected in the loopstats files. The files
arereduced to summary data using the loop.sh shell script. See the
loop.awk script for further information. A line in the file is produced
at each valid update of the local clock.

  49236 11.897 -0.000004 -35.9384 0

  49236         modified Julian day number
  11.897                time of day (s) past midnight UTC
  -0.000004     time offset (s)
  -35.9384      frequency offset (ppm)
  0             phase-lock loop time constant

clockstats

The following data are collected in the clockstats files. The files are
reduced to summary data using the clock.sh shell script, which also
updates the ensemble, etf, itf and tdata data files as well. See the
clock.awk, ensemble.awk, etr.awk, itf.awk and tdta.awk scripts for
further information. A line in the file is produced at each valid update
received from a configured radio clock. Data are at present recorded for
several radios. The first part of each data line is similar for all
radios, e.g.:

  49234 60517.826 127.127.4.1   93 247 16:48:21.814

  49234         modified Julian day number
  60517.826     time of day (s) past midnight UTC
  127.127.4.1   receiver identifier (Spectracom 8170/Netclock-2)
  93 247 16:48:21.814  timecode (format varies)

In the case of the Austron GPS receivers, a good deal of additional
information is extracted from the radio, as described below. The formats
shown consist of one line with all the fields shown in order. The
timecode formats specific to each radio follow:
Spectracom 8170/Netclock-2 WWVB receiver

  49234 60517.826 127.127.4.1 ?A93 247 16:48:21.814

  The '?' and 'A' characters are present only when the receiver is
  unsynchronized; otherwise, they are replaced by space ' ' characters.

IRIG audio decoder

  49234 60517.826 127.127.6.0 247 16:48:21?

  The '?' character is present only when the receiver is unsynchronized.

Austron 2200A/2201A GPS receiver

  49234 60580.843 127.127.10.1 93:247:16:49:24.814?

  The '?' character is present only when the receiver is unsynchronized.

Depending on the installed options, the Austron 2200A/2201A recognizes a
number of special commands that report various data items. See the
refclock_as2201.c source module for a list of the commands used. These
data are collected only if the following line is included in the
configuration file ntp.conf:

  fudge 127.127.10.1 flag4 1    # enable extended statistics collection

The format of each data line returned is summarized in the following
list.

External time/frequency data (requires input buffer option IN)

  These data determine the deviations of external time/frequency inputs
  relative to receiver oscillator time. The following data are typical
  using an external cesium oscillator 1-pps and 5-MHz outputs.

  49234 60580.843 127.127.10.1 93:247:16:49:24.814 ETF
  -85.9         time interval (ns)
  -89.0         average time interval (ns)
  4.0           time interval sigma (ns)
  +1.510E-11    time interval rate
  -4.500E-11    deltaf/f
  +1.592E-11    average deltaf/f
  5.297E-13     sigma deltaf/f
  500           number of samples

Model and option identifiers

  These data show the receiver model number and option configuration.

  49234 60708.848 127.127.10.1 93:247:16:51:32.817 ID;OPT;VER
  GPS 2201A     model identifier (must be "GPS 2200A" or "GPS 2201A")
  TTY1          rs232 option present (required)
  TC1           irig option present (optional)
  LORAN         LORAN assist option present (optional)
  IN            input buffer option present (optional)
  OUT1          output buffer option present (required)
  B.00          data processor software version ("B.00" or later)
  B.00          signal processor software version ("B.00" or later)
  28-Apr-93     software version date ("28-Apr-93" or later)

Internal time/frequency data

  These data determine the deviations of the receiver oscillator with
  respect to satellite time.
  49234 60564.846 127.127.10.1 93:247:16:49:08.816 ITF
  COCO          current mode (must be "COCO")
  0             code coast mode (must be zero)
  +6.6152E-08   code sigma (s)
  -3.5053E-08   code delta t (s)
  -4.0361E-11   deltat/t
  -6.4746E-11   oscillator ageing rate
  500.00        loop time constant
  4.984072      electrical tuning (V)

GPS/LORAN ensemble data (requires LORAN assist option LORAN)

  These data determine the deviations and weights to calculate ensemble
  time from GPS and LORAN data.

  49234 60596.852 127.127.10.1 93:247:16:49:40.812 LORAN ENSEMBLE
  +9.06E-08     GPS t (s)
  +3.53E-08     GPS sigma (s)
  .532          GPS weight
  +3.71E-08     LORAN t (s)
  +3.76E-08     LORAN sigma (s)
  .468          LORAN weight
  +6.56E-08     ensemble t
  +6.94E-08     emsemble sigma (s)

LORAN stationkeeping data (requires LORAN assist option LORAN)

  These data determine which stations of the LORAN chain are being
  tracked, together with individual signal/noise ratios, deviations and
  weights

  49234 60532.850 127.127.10.1 93:247:16:48:36.820 LORAN TDATA
  M             station identifier; data follows
  OK            status (must be "OK" for tracking)
  0             cw flag
  0             sw flag
  1162.17       time of arrival
  -4.6          snr (-30.0 if not "OK" status)
  1.67E-07      2-sample phase-time deviation
  .507          weight (included only if "OK" status)
  W AQ 0 0 3387.80 -31.0  station identifier and data
  X OK 0 0 1740.27 -11.2 2.20E-07 .294  station identifier and data
  Y OK 0 0 2180.71 -4.6 2.68E-07 .198  station identifier and data
  Z CV 0 0 3392.94 -30.0  station identifier and data

Oscillator status and envirionment

  These data determine the receiver oscillator type, mode, status and
  environment. Nominal operating conditions are shown below.

  49234 60628.847 127.127.10.1 93:247:16:50:12.817 OSC;ET;TEMP
  1121 Software Control  oscillator model and mode (must be "Software
                Control")
  Locked        status (must be "Locked")
  4.979905      electrical tuning (V)
  44.81         oscillator cavity temperature

Receiver position, status and offsets

  These data determine the receiver position and elevation, together
  with programmable delay corrections for the antenna cable and
  receiver.

  49234 60788.847 127.127.10.1 93:247:16:52:52.817 POS;PPS;PPSOFF
  +39:40:48.425 receiver latitude (N)
  -075:45:02.392  receiver longitude (E)
  +74.09        receiver elevation (m)
  Stored        position status (must be "Stored")
  UTC           1pps/1ppm alignment (must be "UTC")
  0             receiver delay (ns) (should be zero for calibrated
                receiver)
  200           cable delay (ns)
  0             user time bias (ns) (must be zero)

Satellite tracking status

  These data determine how many satellites are being tracked. At the
  present state of constellation development, there should be at least
  three visible satellites in view. Much of the time the maximum of
  seven are being tracked; rarely this number drops to two.

  49234 60612.850 127.127.10.1 93:247:16:49:56.820 TRSTAT
  24 T          satellite prn and status (T = track, A = acquire)
  16 A 13 T 20 T 18 T 07 T 12 T  list continued

UTC leap-second information

  These data determine when the next leap second is to occur. The exact
  method to use is obscure.

  49234 60548.847 127.127.10.1 93:247:16:48:52.818 UTC
  -1.2107E-08   A0 term (s)
  -1.2790E-13   A1 term (s)
  +9.0000E+00   current leap seconds (s)
  +2.0480E+05   time for leap seconds (s)
  +2.0100E+02   week number for delta leap (weeks)
  +1.9100E+02   week number for future leap (weeks)
  +4.0000E+00   day number for future leap (days)
  +9.0000E+00   future leap seconds (s)

David L. Mills
University of Delaware
mills@udel.edu
6 September 1993
