18.2 AUTOREG, automatic registering of events

When a large number of waveform files are available and it is known that they are real events, it might be an advantage to automatically register them into a database. Remember, the database must be made beforehand with MAKEREA. If the filename follows the SEISAN filename convention, the date and time used to generate the S-file are taken from the filename. Otherwise, the file is read to get the date and time from waveform headers. Obviously, the first option is faster. It is possible to register events both to the default database, any other database or the local directory. To run the program, make a filenr.lis of the waveform files and run AUTOREG. It is possible to put blank lines into the filenr.lis to separate into events, in case there is more than one waveform file from the same event. All waveform files before a blank line are put together into one S-file. Alternatively, one waveform file can be given on the prompt line and then no filenr.lis is needed. Optionally, the waveform files can also be moved or copied to WAV or a WAV database subdirectory (including year and month). This can either be the default parameter COPY_WAV_DIR (in SEISAN.DEF) if different from blank. COPY_WAV_DIR should be the same as the data base used by the S-files. However an optionally data base directory entered interactively if COPY_WAV_DIR is set to blank. AUTOREG can also be operated entirely or partly with flags on the prompt line. The flags are:

-file : file name of a single file to register, can be filenr.lis for many

-op : operator

-copy: flag to indicate if copy or move wav files: b for blank, no move or copy, c is copy and m is move

-base: data base for s-files, b for blank for default

-wbase: base for waveform files b for default WAV. If blank, the data base given in SEISAN.DEF will be used.

-model : x model flag for STATIOx.HYP

You can run AUTOREG with any number of flags, parameters not given with the flags will be asked for.

c:\seismo\WOR>autoreg
  Event type for all events: Local:    L (default)
                             Regional: R
                             Distant:  D
r
  Move (m) or copy (c) waveform files to WAV (enter=n) ?
c
  Enter wav base to copy/move to, enter for WAV main folder
TEST
 Files will be copied to default WAV base: TEST_
  Operator, max 3 chars
jh
 2004-05-11-0050-42S.NSN___013
  sfile: c:\seismo\REA\TEST_\2004\05\11-0050-42R.S200405

 File already registered, options are:
 Ignore (leave old event):             Return
 Ignore all                            I
 Overwrite duplicate:                  O
 Overwite all duplicates:              A
 Create a new event, different ID:     N
 Create new events for ALL duplicates: *o

  Sure you want to overwrite(y/n)
y
 c:\seismo\REA\TEST_\2004\05\11-0050-42R.S200405

 copy 2004-05-11-0050-42S.NSN___013 c:\seismo\WAV\TEST_\2004\05\                                                                                                                      
        1 file(s) copied.
  File transferred to WAV base TEST_ **********
 2004-07-05-1809-44S.NNN___010
  sfile: c:\seismo\REA\TEST_\2004\07\05-1809-44R.S200407

 c:\seismo\REA\TEST_\2004\07\05-1809-44R.S200407

 copy 2004-07-05-1809-44S.NNN___010 c:\seismo\WAV\TEST_\2004\07\                                                                                                                      
        1 file(s) copied.
  File transferred to WAV base TEST_ **********

Now comes a listing of waveform file names and S-file names. The program will check if the event is already registered and the same options are available as in program SPLIT (section 13). Since AUTOREG automatically creates S-files for all events in filenr.lis, they will all be given an event type.