Examples

Distance range

a)
There is an event at 33.6N 24.0E at depth 10km with on July 16, 2002, at 06-56-23.6
The mailing host through which you send your e-mails is 'yourMailHost' (+host),
You want to receive wave forms at the e-mail address 'MyMailAddress' (+send) with a reference ID 'Test1' (+m_id) for all available stations up to a distance of 30 degrees (this is the default!). The wave form time window is (by default) 30 seconds before P-wave arrival with a total duration of 120 seconds:

java CollectWaves +epiz 33.6/24.0/10 +orig 2002-07-16-06-56-23.6 +m_id Test1 +host yourMailHost +send MyMailAddress

Best azimuthal coverage

or putting these values into a configure file:

java CollectWaves +rc configfile

Azimuth range

where configfile contains:
+epiz 33.6/24.0/10
+orig 2002-07-16-06-56-23.6
+m_id Test1
+host yourMailHost
+send MyMailAdress

b)

Same as in a, but you want to receive only wave forms of stations in the distance range from 10 to 20 degrees: (see image distance range)

java CollectWaves +rc configfile +dist 10,20

c)

For the event in a) select the closest stations around the epicenter for 12 sectors (one sector will be 30 degrees wide). Only one station per sector will be selected with a distance less than 20 degrees: (see image azimuthal coverage)

java CollectWaves +rc configfile +dist 0,20 +sect 12

d)

For the event in a) request all stations with an azimuth between 210 to 240 degrees: (see image azimuth range)

java CollectWaves +rc configfile +aseg 210,240 

e)

For the event in a) request all stations up to 30 degrees distance with preference on LH channels, accept BH channels if  LH is not available or HH if BH are not available. No SH or EH signals are requested. The time window is set such that surface waves with group velocities between 2.3 and 3.8 km/s are contained. The time window is extended to 50 seconds before and 100 seconds after the slower velocity. Note: the phase naming is defined by the TauP class.

java CollectWaves +rc configfile +phwi 3.8kmps, -50, +120:2.3kmps,-50,100 +prco,LH,BH,HH

File Formats:

+afil, +afmt: Data file with stations, channels, coordinates, AutoDRM e-mail address and availability code:

Assume the following format of the file containing the stations available through AutoDRM:

SLE   HHE av=0.0   47.766    8.4933 autodrm@seismo.ifg.ethz.ch
SLE   HHN av=0.0   47.766    8.4933 autodrm@seismo.ifg.ethz.ch
SLE   HHZ av=0.0   47.766    8.4933 autodrm@seismo.ifg.ethz.ch
ZUR   HHE av=0.0   47.369    8.5810 autodrm@seismo.ifg.ethz.ch
ZUR   HHN av=0.0   47.369    8.5810 autodrm@seismo.ifg.ethz.ch
ZUR   HHZ av=0.0   47.369    8.5810 autodrm@seismo.ifg.ethz.ch

Then the corresponding format description (+afmt) looks like:

StName StComp StAvail StLat StLon

%s %s %*c%*c%*c%f %f %f %s\n

The first line defines the sequence of the variables (their name corresponds to the ones in the class CollecWaves ). The second line is the corresponting C format description to read the data file.  The 3 characters 'av=' in the data file are skipped with %*c.

If your input file looks like:

SLE autodrm@seismo.ifg.ethz.ch HHE  47.766    8.4933 0.0
SLE autodrm@seismo.ifg.ethz.ch HHN  47.766    8.4933 0.0
SLE autodrm@seismo.ifg.ethz.ch HHZ  47.766    8.4933 0.0
ZUR autodrm@seismo.ifg.ethz.ch HHE  47.369    8.5810 0.0
ZUR autodrm@seismo.ifg.ethz.ch HHN  47.369    8.5810 0.0

The format description is:

StName AutoDRM StComp StLat StLon StAvail
%s %s %s %f %f %f %f\n 

+efil, +efmt: File containing station names for which wave forms are allready on your system:

The first string in this example is the name of the data file containing the wave forms, the trailing date-time. Both informations are not needed in this context, only station name and channel name are needed .

./KP200207160700 SLE    HHE 2002-07-16-07-00-2.005
./KP200207160700 SLE    HHN 2002-07-16-07-00-2.005
./KP200207160700 SLE    HHZ 2002-07-16-07-00-2.005
./KP200207160700 ZUR    HHE 2002-07-16-07-00-2.005
./KP200207160700 ZUR    HHN 2002-07-16-07-00-2.005
./KP200207160700 ZUR    HHZ 2002-07-16-07-00-2.005

The format description is:

StName StComp
%*s %s %s

+dfil, +dfmt: Delay times for AutoDRM's due to the data acquisition and processing system

This file contains names of AutoDRM addresses and delay times [sec]: e.g.

autodrm@seismo.ifg.ethz.ch 480

The format description is:

AutoDRM delayAutoDRM
%s %s

+tfil, +tfmt:

+bfil: AutoDRM addresses (or parts of them) or station names, one pattern per input line, which shoud be deleted from the AutoDRM list (+afil). No casefolding is performed on the patterns. e.g.:

ctbto
ZUR