Appendix E. DataWise® Usefull Command-Line Applications in the Utils Directory
Note that all command-line applications must have the following command line argument appended:
config=\DataWise\Config\dw_config.cfg. Replace \DataWise\ with the name of the installation directory if different.
evout.exe
Function: Used for generating a text file containing readings for a sensor or list of sensors.
Usage:
evout [sensor#s...] [options...]
Where:
[sensor#s...] Sensor numbers can be specified on command line
(If none are specified, program requests user input.)
[options...]:
d=MM/DD/YY is the ending date (default is current date)
t=HHMM is the ending time (default is current time)
e=MM/DD/YY is the starting date (default is current date - 24 hours)
u=HHMM is the starting time (default is current time - 24 hours)
n=nlines is the number of display lines (default is no limit)
s=tstep[m|h|d] is the number of [minutes|hours|days] to display from ending time
(over-rides starting date/time)
-v inhibits header printing
-f inhibits form feeds
-p inhibits paged pause
+c enables continuity checking (bogus data removed)
+r displays rated values if available
+d displays raw data values if available
+w display status data in binary form
+h enables header printing in non-verbose mode
f=outfile direct the output to file "outfile"
ef=errfile direct error messages to file "errfile"
+a appends output to "outfile". (default is re-write)
in=inputfile. Inputfile contains a list of sensors to generate data for.
-no inhibits the "Sensor #" output in front of the sensor ID
+timeout enables a 15 second timeout (default is timeout only if arguments passed)
+tcl forces the user to have included at least one sensor on the command line
+commas separates fields by commas
+quotes separates fields by quotes
TZ=timezone specifies time zone to display data in
(default is timezone DataWise computer is running on)
timezone format is standard TZ variable format (i.e., PST8PDT)
signal_alaram.exe
Function: Used for initiating an alarm notification.
Usage:
signal_alarm [actions=alarmport#...] [options...]
Where:
alarmport#... is a list of alarm port numbers to alarm (default is console)
Separate the alarm port numbers with spaces.
You can use device names such as: $ext, $talk,...
[options...] are:
sensor= specifies a sensor to set an alarm condition for
default is to use type if not specified
type= specifies the alarm type (default is test alarm)
You can enter a number or a keyword.
Keywords are:
time,test,fcst,fcstmsg,netdown,rcvmsg,commsdown,
commsup,datadown,dataup,bsequence,nocontrol,rule
noacknow,nomodem,wandafail,random
cause= specifies the alarm cause (default is 0)
You can enter a number or a keyword.
Keywords are:
max,min,rrate,prate,nrate,norpt,max_reset,min_reset,rrate_reset,prate_reset,nrate_reset,norpt_reset
value= specifies the alarm value (default is 0)
bit= specifies bit number of the sensor used with status alarms only.
step= specifies the time step (in minutes) for rate of change alarms.
d=MM/DD/YY date for alarm logging (default is current date).
t=HH:MM:SS time for alarm logging (default is current time).
+r reset the alarm instead of setting it
statreport.exe
Function: Used for creating a tabular report for a group of sensors.
Usage:
statreport.exe g=group# OR sensor#/STATISTIC ... [options...]
Where:
g=group# selects the group number to display (0 for list & select)
OR
sensor#/statistic ... selects sensor(s) and the statistical parameter
[options...] are:
d=mm dd yy sets the ending date for the report (default is current date)
t=hhmm sets the ending time for the report (default is closest time multiple of time step for current date, 2400 for past dates).
step=tstep[h|m|d] selects the time step in hours, minutes, or days
(default time step is 1 hour, default units is hours)
n=#periods selects the number of periods to display (default is 24)
+even forces ending time / date on time step boundary.
+|-last + shows, date,time,value of last report on file
(default is +l for current time reports, -l otherwise)
-verbose inhibits status message display
(default is +v)
-f inhibits form feed before group display
(default is +f)
-h inhibits header display
(default is +h)
-p inhibits pausing between page fulls
(default is +p)
+t computes and prints totals at report end
(default is -t)
+p printer output (local printer if not console)
f=filename outputs to file "filename"
+tag display tagnames (default is device numbers)
+spread output is in "spreadsheet" format
tz=timezone sets the display timezone (default is computers timezone)
YearToDatePcp.exe
Function: Used for computing the year to date precipitation.
Usage:
YearToDatePcp.exe [s=smon] [outdir=output_directory]
Where:
output_directory = location to place computed values in
(Default is C:/Apache24/htdocs/datawise/MapData/)
smon is the starting month
(Default is 1 ... January)
DavisInstruments.exe
Function: Parses text files sent from a Davis Instruments Installation.
Usage:
DavisInstruments.exe in=inputfile c=configFile o=time_offset n=numHeaderLines
Where:
inputfile = file containing data
configFile = file containing sensor_ID column number pairs, one line per column
offset = offset (in minutes)
(Default is 0)
numHeaderLines = number of lines before data values
(Default is 3)
Sample input file:
Temp Hi Low Out Dew Wind Wind Wind Hi Hi Wind Heat THW Rain Heat Cool In In In In In In Air Wind Wind ISS Arc.
Date Time Out Temp Temp Hum Pt. Speed Dir Run Speed Dir Chill Index Index Bar Rain Rate D-D D-D Temp Hum Dew Heat EMC Density Samp Tx Recept Int.
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
1/18/16 12:30a 41.5 42.8 41.5 88 38.2 0.0 --- 0.00 0.0 --- 41.5 41.4 41.4 30.164 0.00 0.00 0.490 0.000 65.0 44 42.5 62.7 8.35 .0756 702 1 100.0 30
1/18/16 1:00a 40.6 41.5 40.6 89 37.6 0.0 --- 0.00 0.0 --- 40.6 40.5 40.5 30.158 0.00 0.00 0.508 0.000 64.4 44 42.0 62.1 8.37 .0756 702 1 100.0 30
1/18/16 1:30a 40.3 40.7 40.2 91 37.9 0.0 --- 0.00 0.0 --- 40.3 40.2 40.2 30.155 0.00 0.00 0.515 0.000 63.9 45 42.1 61.7 8.57 .0757 701 1 100.0 30
1/18/16 2:00a 40.3 40.3 39.9 90 37.6 0.0 --- 0.00 0.0 --- 40.3 40.2 40.2 30.157 0.00 0.00 0.515 0.000 63.5 45 41.8 61.3 8.58 .0758 703 1 100.0 30
1/18/16 2:30a 38.9 40.3 38.9 90 36.2 0.0 --- 0.00 0.0 --- 38.9 38.8 38.8 30.161 0.00 0.00 0.544 0.000 63.0 45 41.3 60.7 8.59 .0759 702 1 100.0 30