1c0b746e5SOllivier RobertStatistics processing scripts (README) 2c0b746e5SOllivier Robert 3c0b746e5SOllivier RobertThis directory contains a number of scripts for use with the filegen 4c0b746e5SOllivier Robertfacility. Those files ending in .awk are for the Unix awk utility, while 5c0b746e5SOllivier Robertthose ending in .sh are for the csh utility. Normally, the summary.sh 6c0b746e5SOllivier Robertscript is called from a cron job once per day. This script processes the 7c0b746e5SOllivier Robertdaily loopstats, peerstats and clockstats files produced by the daemon, 8c0b746e5SOllivier Robertupdates the loop_summary, peer_summary and clock_summary archive files, 9c0b746e5SOllivier Robertand deletes the daily files. 10c0b746e5SOllivier Robert 11c0b746e5SOllivier RobertIn the case of the Austron 2201A GPS receiver, the clockstats file 12c0b746e5SOllivier Robertcontains a wealth of additional monitoring data. These data are summarized 13c0b746e5SOllivier Robertand writted to the clock_summary file, then a series of special files are 14c0b746e5SOllivier Robertconstructed for later processing by the S utility. 15c0b746e5SOllivier Robert 16c0b746e5SOllivier RobertThe summary.sh script invokes a number of awk scripts to actually produce 17c0b746e5SOllivier Robertthe data. This may result in multiple scans of the same input file. 18c0b746e5SOllivier RobertThe input file is deleted after processing. In fact, the shell scripts will 19c0b746e5SOllivier Robertprocess all input files found of the correct type in chronological order, 20c0b746e5SOllivier Robertdeleting each one as it is scanned, except the current day file. 21c0b746e5SOllivier Robert 22c0b746e5SOllivier RobertThe summary.sh script can produce input files for the S utility, if it 23c0b746e5SOllivier Robertis found on the search path. This utility makes PostScript graphs of the 24c0b746e5SOllivier Robertloopstats data for each day, as well as various statistics produced by 25c0b746e5SOllivier Robertthe Austorn 220aA GPS receiver. The S utility is automatically run 26c0b746e5SOllivier Robertas a background job. Its control files have the .S extension. 27c0b746e5SOllivier Robert 28c0b746e5SOllivier RobertThe psummary.awk script can be used to scan the peer_summary file and 29c0b746e5SOllivier Robertconstruct an historical reprise of the daily summaries. 30c0b746e5SOllivier Robert 31c0b746e5SOllivier RobertThe file formats are documented in the README.stats file and in the 32c0b746e5SOllivier Robertscripts themselves. Further detail on the radio clock ASCII timecode 33c0b746e5SOllivier Robertformats and related data are in the README.timecode file. 34c0b746e5SOllivier Robert 35c0b746e5SOllivier RobertDavid L. Mills 36c0b746e5SOllivier RobertUniversity of Delaware 37c0b746e5SOllivier Robertmills@udel.edu 38c0b746e5SOllivier Robert1 November 1993 39c0b746e5SOllivier RobertRevised 12 April 1994 40