NAME
dbarrparams - Make arrival parameter measurements (amp-per, azimuth, etc.)
SYNOPSIS
dbarrparams
dbname
[
-pol
tlead_pol
tlag_pol
] [
-ap
tmin_ap
tmax_ap
] [
-fm
tmin_fm
tmax_fm
] [
-snr
tlead_snr
tlag_snr
] [
-filter
type
lco
hco
lord
hord
tpad
]
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
dbarrparams
will compute specified arrival parameters and save these parameters in
the arrival table of the CSS relational database.
The parameters that can be computed are polarization parameters (azimuth,
incidence angle and rectilinearity), amplitude and period, first motion
and signal to noise ratio. A filter can be specified that will be applied
to the waveforms before the measurements are made.
This program will only work with v. 3.0 of the CSS schema.
COMMAND LINE ARGUMENTS
-
dbname
The name of the subject database. The database name is defined as the
file name of one of the flat relation files without the .relname suffix.
For example, if the .wfdisc relation file name is ./foo.wfdisc then ./foo
is the database name.
This argument is required.
-
-pol tlead_pol tlag_pol
If these arguments are specified, then 3-component polarization analysis
is performed to determine azimuth, incidence angle and rectilinearity
using the covariance matrix method. The arguments tlead_pol and
tlag_pol specify the time window around the arrival to be used
for computing the polarization parameters where tlead_pol is
the number of seconds before the arrival for the start of the window
and tlag_pol is the number of seconds after the arrival for the
end of the window. NOTE: 3-component clusters are determined automatically
by matching station codes and everything but the last character of the
channel codes. The last character of the channel codes must be 'Z', 'N', or 'E'
(or 'z', 'n', 'e') and these are assumed to be correct
(i.e. the program does not look into the sitechan table to check the
actual sensor orientation but assumes that Z is up, N is north and
E is east). Thus numerical channel codes such as '01', '02', '03'
WILL NOT WORK with this program as it is currently written.
-
-ap tmin_ap tmax_ap
If these arguments are specified, then amplitude-period measurements
are made. The arguments tmin_ap and tmax_ap specify the
time window around the arrival to be used for determining the
amplitude and period where tmin_ap is the number of seconds
after the arrival for the start of the window and tmax_ap is the
number of seconds after the arrival for the end of the window.
-
-fm tmin_fm tmax_fm
If these arguments are specified, then first motion measurements
are made. The arguments tmin_fm and tmax_fm specify the
time window around the arrival to be used for determining the
first motion where tmin_fm is the number of seconds
after the arrival for the start of the window and tmax_fm is the
number of seconds after the arrival for the end of the window.
-
-snr tlead_snr tlag_snr
If these arguments are specified, then signal to noise measurements
are made. The arguments tlead_snr and
tlag_snr specify the time window around the arrival to be used
for computing the signal and noise windows where tlead_snr is
the number of seconds before the arrival for the noise window
and tlag_snr is the number of seconds after the arrival for the
signal window.
-
-filter type lco hco lord hord tpad
If these arguments are specified, then all waveforms are filtered
prior to any of the other measurements. The type of filter is
specified by an integer argument, type, which is 1 for a
minimum phase Butterworth filter and 2 for a zero phase Butterworth
filter. The arguments lco hco lord hord tpad are, respectively,
the low corner frequency in Hz, the high corner frequency in Hz,
the order of the highpass stage, the order of the lowpass stage,
and the time pad in seconds for minimizing the filter transient.
Values of 0 for corner frequencies or orders will eliminate the
appropriate stages.
BUGS AND CAVEATS
I offer this program in source code form, as is, with no guarantee
that it works properly. I am doing this because many folks have
asked for this old program.
This is a very old program that I wrote in
my University research days, now many years ago. Any memory I may have
had about this code has since recycled many times. In other words, the
source code is my ONLY contribution. I will provide no support for this program,
other than the source code. That's what open source is supposed to be all
about, isn't it? So please don't e-mail me questions. Also, please feel
free to make any modifications, especially bug fixes, and check them back
into the contributed repository. D. Harvey
AUTHOR
Danny Harvey
Antelope User Group Contributed Software