WX200D(5) WX200D(5) NAME wx200d - format of log files created by wx200d SYNOPSIS /usr/local/etc/wx200/data/YYYYMMDD.bin[.gz] /usr/local/etc/wx200/data/YYYYMMDD.tab[.gz] /usr/local/etc/wx200/data/YYYYMMDD.day /usr/local/etc/wx200/data/YYYYMM.mon DESCRIPTION The files in /usr/local/etc/wx200/data are WX200 weather data logs created by wx200d(8) or wxsum. The base filename is made up of the year, month and day of the data contained in the file. This is of the form YYYYMMDD which makes it easy to sort the files in time order. The extension of the file indicates the format of the content and can currently be one of the following for- mats. Of course a .gz suffix indicates the file has been compressed with gzip(1). YYYYMMDD.bin[.gz] These files contain "abbreviated" binary WX200 data. WX200 data "groups" (see wx200.txt for details) are logged directly from the device but only when they have changed. This results in the smallest possible file that can still be used by programs that understand the complete WX200 serial data stream. This abbreviation is not lossy. That is, all bits of data are recorded with no loss of information. These .bin files can therefore be used to create .tab files, via wxfilter(1) , but not vice-versa. YYYYMMDD.tab[.gz] These files contain a tab-delimited ASCII log of the WX200 sensor values. They may be conveniently plotted by wxplot(1) or gnuplot(1) or imported into spreadsheets or other systems. When any variable changes, a whole line is recorded. The columns of the line are delimited by a single tab charac- ter and record the following WX200 sensor values in order: Time The hour of the day this line of data occurred. The integer part is the hour in the range 0 to 23. The frac- tional part is the fraction of the hour. The time is wx200d Manual Sep 07, 1998 1 recorded in this way so that this field can be plotted linearly on the X axis of a graph. indoor temperature 0.0 to 50.0 degrees Celsius @ 0.1 outdoor temperature -40.0 to 60.0 degrees Celsius @ 0.1 indoor humidity 10 to 97 percent @ 1 outdoor humidity 10 to 97 percent @ 1 indoor dew point 0 to 47 degrees Celsius @ 1 outdoor dew point 0 to 56 degrees Celsius @ 1 local barometric pressure 795 to 1050 millibars @ 1 sea level pressure 795.0 to 1050.0 millibars @ 0.1 gust wind direction 0 to 359 compass degrees @ 1 gust wind speed 0.0 to 56.0 meters per second @ 0.2 average wind direction 0 to 359 compass degrees @ 1 average wind speed 0.0 to 56.0 meters per second @ 0.2 wind chill -85 to 60 degrees Celsius @ 1 rainfall rate 0 to 998 millimeters per hour @ 1 YYYYMMDD.day These daily summary files contain hourly average, low and high for each variable, one line per hour. The file for- mat is very similar to the .tab files described above. The difference is that after the hour timestamp, the group of data columns appears three times to record the average, low and high of each variable in that order. The wind direction is the only exception to this: the three most common wind directions are listed in order. YYYYMM.mon These monthly summary files contain daily average, low and high for each variable, one line per day. The file format is just like the .day files described above except that the first column is in the YYYYMMDD format to indicate the date of the data instead of the hour. FILES /usr/local/etc/wx200/data/YYYYMMDD.tab[.gz] wx200d Manual Sep 07, 1998 2 /usr/local/etc/wx200/data/YYYYMMDD.bin[.gz] /usr/local/etc/wx200/data/YYYYMMDD.day /usr/local/etc/wx200/data/YYYYMM.mon LIMITATIONS The server can currently let some of yesterday's data in today's file and vice versa as the date changes due to the difference between the WX200 clock and the computer clock. wxsum tries to strip these errors from the .day and .mon summary files but may not be successful. SEE ALSO wx200d(8), wxplot(1), gnuplot(1), wxfilter(1), wxdebug(1) AUTHOR Tim Witham COPYRIGHT Copyright (C) 1998 Tim Witham wx200d is released under the conditions of the GNU General Public License. See the files README and COPYING in the distribution for details. wx200d Manual Sep 07, 1998 3