NAME
q330_calibration - runs q330 calibations on network
SYNOPSIS
q330_calibration [-v] [-V] [-n] [-2] [-3]
[-i] [-N [-d no_calib_days]]
[-o duration_offset_fraction] [-t start_time]
[-p pf] [-m mail_to_operator]
cmdorb db sta_regex [sta_regex1 [sta_regex2 [...]]]
SUPPORT
Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.
FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.
DESCRIPTION
q330_calibration runs calibrations on sensors connected to Q330 dataloggers.
q330_calibration first checks to see if the
cmdorb is accessible and verifies that the
dlcalwf, dlsensor, and staq330 tables exist in
db.
One or more
sta_regex (station regular expressions) are required to run
q330_calibration
unless the -i or the -N option is specified.
q330_calibration sends calibrations to q330s by using
dlcmd. The specific parameters
for the calibration are found in
q330_calibration.pf. Only one type of calibration is allowed
for each sensor listed in the
q330_calibration.pf.
In the
q330_calibration default operation, a calibration sweep of all stations defined by
command line argument station regular expressions is conducted first using channel 3 as the monitor
channel, followed by a sweep using channel 2 as the monitor channel. This guarantees that all
channels are calibrated while simultaneously recording the original calibration signal. Each station
calibration is offset by 0.5 of the duration of the calibration to minimize the number of stations
in calibration mode at one time.
q330_calibration runs are reported in the
db.dlcalwf table.
OPTIONS
-
-v
verbose
-
-V
Extremely verbose. Used for debugging purposes only.
-
-n
Test mode. No operations executed.
-
-2
Restrict calibration of stations to using channel 2 as the monitor channel.
-
-3
Restrict calibration of stations to using channel 3 as the monitor channel.
-
-i
Calibrate dataloggers and sensors on stations (limited by sta_regex) in the staq330 and dlsensor
tables that have not been calibrated
using white noise. q330_calibration will check to make sure that both channel 2 and channel
3 have been used as monitor channels. Missing channels will be calibrated.
The default offset in this case is 0.25.
-
-N
Calibrate stations (limited by sta_regex) in the staq330 table. To allow network operations
to continue, only 10% of the stations are calibrated simultaneously, leaving 90% operational.
The default offset in this case is 0.
-
-d no_calib_days
This option is only valid when used with the -N full network calibration.
Instead of calibrating the whole network, the -d option will only calibration stations which
have not been calibrated in the last no_calib_days. This option is useful if a network calibration
is interupted for some reason and you want to complete the missing stations at a later time.
It is recommended that the -n noop option is used to test what stations need to be calibrated
before actual execution.
-
-o duration_offset_fraction
Offset in time between calibration commands measured as a multiplier of the duration.
The default duration_offset_fraction is 0.5.
-
-p parameter_file
Name of parameter file to use. $PFPATH is searched to find parameter file.
The default parameter file is q330_calibration.
-
-t start_time
Only calibrate stations which have been deployed after start_time
-
-m mail_to
Email address list to send results. Multiple email addresses should be comma delimited without
white space.
ENVIRONMENT
needs to have sourced $ANTELOPE/setup.csh.
PARAMETER FILE
q330_calibration parameter file element is:
-
sensors
array of sensor specific parameters for cailbration. Allowed calibration parameters are found in the
Commands section of q3302orb(1).
DEFAULT PARAMETER FILE
sensors &Arr{
sts2_g3 &Arr{
duration 7200 # duration <= 16380; q330 limitation
settling_time 900
trailer_time 900
waveform white
amplitude 1 # V = 2.5 amplitude in volts is equal to 5 V / 2 ** amplitude
}
cmg3t &Arr{
duration 7200 # duration <= 16380; q330 limitation
settling_time 900
trailer_time 900
waveform white
amplitude 1 # V = 2.5 - amplitude in volts is equal to 5 V / 2 ** amplitude
}
trillium_240 &Arr{
duration 7200 # duration <= 16380; q330 limitation
settling_time 900
trailer_time 900
waveform white
amplitude 4 # V = 0.3125 - amplitude in volts is equal to 5 V / 2 ** amplitude
}
}
RETURN VALUES
0 if successful, 1 if not.
SEE ALSO
q330_baler(1)
dlcmd(1)
q3302orb(1)
dbcalibrate(1)
displayscal(1)
BUGS AND CAVEATS
This program is fundamentally dependent on the staq330 table which is written to by the program
q330_baler.
If you find strange behaviour in the operation of
q330_calibration, be sure to check that the
staq330
table is correct and up to date. You may need to rerun
q330_baler to get things to work as expected.
AUTHOR
Frank Vernon
Antelope User Group Contributed Software