11.1 SELECT

Whenever selective search and extraction is wanted SELECT is used. The program can run on the CAT database, single CAT files (Nordic or Nordic compact) or the S-file data base. The output file, select.out, will also be in Nordic format. Since the input CAT database can contain both normal and compact files, the output will always be a normal file with blank lines between events. If however the input is one compact file, the output will also be a compact file. Note: If SELECT is used on the CAT database (normal operation), you need to UPDATE your S-file database in order to transfer changes from the S-files to the CAT database. Select can work with input in 3 different ways:

  1. The user is asked for selections
  2. The selection parameters are in a file
  3. Parameters are given on the prompt line
The program is started by typing SELECT (parameters from screen), SELECT `input file' (parameters from input file) or SELECT -options. A typical user interactive run is shown below. Comments following !


POSSIBLE INPUT IS: 
     STANDARD CAT DATABASE: RETURN
     ALTERNATIVE DATABASE, GIVE 1-5 LETTER CODE:
     FILENAME FOR ONE FILE, MUST BE 6 OR MORE CHARACTERS:
     Type of base: CAT (c) or Sfiles (s) (enter):
c
 Updating database TEST_              ! standard base
 The database TEST_ has  10 files
 The first file starts: 199309
 The  last file starts: 199909
 
  Start time (blank is 1980), yyyymmddhhmmss: 199309! time range
  End time, enter for 2025                  : 199607

             PARAMETERS
  
      1   - Fault Plane Solution
      2   - Earthquake Felt
      3   - Magnitude Type(s)                            
      4   - Distance ID(s)                               
      5   - Event ID(s)                                  
      6   - Magnitude Limits
      7   - Latitude Limits
      8   - Longitude Limits
      9   - Depth Limits
      10  - RMS Limits
      11  - Number of Stations Limits
      12  - Hypocenter Errors Latitude Limits
      13  - Hypocenter Errors Longitude Limits
      14  - Hypocenter Errors Depth Limits
      15  - Minimum Number of Polarities
      16  - Hypocenter Agencies
      17  - Magnitude Agencies
      18  - Station Codes, components and distance range
      19  - Polygon
      20  - Use all header lines
      21  - Search for text string in S-file
      22  - Gap range          
      23  - Phases    
      24  - Volcanic subclasses
      25  - Moment tensor solution
         
  
  SELECT NUMBER TO CHANGE PARAMETER, RETURN TO SEARCH: 6   
  Minimum Magnitude, return for default:   5
  Maximum Magnitude, return for default:   7

             PARAMETERS
  
      1   - Fault Plane Solution
      2   - Earthquake Felt
      3   - Magnitude Type(s)                            
      4   - Distance ID(s)                               
      5   - Event ID(s)                                  
      6   - Magnitude Limits                          5.0        7.0
      7   - Latitude Limits
      8   - Longitude Limits
      9   - Depth Limits
      10  - RMS Limits
      11  - Number of Stations Limits
      12  - Hypocenter Errors Latitude Limits
      13  - Hypocenter Errors Longitude Limits
      14  - Hypocenter Errors Depth Limits
      15  - Minimum Number of Polarities
      16  - Hypocenter Agencies
      17  - Magnitude Agencies
      18  - Station Codes, components and distance range
      19  - Polygon
      20  - Use all header lines
      21  - Look for wave form file names
      22  - Gap range
      23  - Phases                   
      24  - Volcanic subclasses
      25  - Moment tnesor solution

  Ok. Input realized successfully.
  SELECT NUMBER TO CHANGE PARAMETER, RETURN TO SEARCH:   
 199309.CAT  No of events:     1  Selected:     1  Selected total:     1
 199406.CAT  No of events:     1  Selected:     1  Selected total:     2
 199410.CAT  No of events:     1  Selected:     0  Selected total:     2
 199508.CAT  No of events:     1  Selected:     0  Selected total:     2
 199511.CAT  No of events:     1  Selected:     0  Selected total:     2
 199606.CAT  No of events:     6  Selected:     3  Selected total:     5
 199607.CAT  No of events:     5  Selected:     1  Selected total:     6
  
  TOTAL NUMBER OF EVENTS IN TIME INTERVAL   16
  NUMBER OF DISTANT EVENTS   - - - - -      7
  NUMBER OF REGIONAL EVENTS  - - - - -      0
  NUMBER OF LOCAL EVENTS     - - - - -      9
  ---------------------------------------------------
  NUMBER OF EVENTS SELECTED *************   6
  NUMBER OF WAVEFORM FILES SELECTED         9
  NUMBER OF INDEXES SELECTED                6
  SELECTED EARTHQUAKES ARE IN FILE: select.out 
  LOCAL INDEX FILE IN:              index.out
  NAMES FOR WAVEFORM FILES IN FILE: waveform_names.out
  SELECT COMMANDS IN FILE:          select.inp


Note above, that the second time the menu is shown, the choice of magnitude limits is shown. For each CAT file in the catalog, the number of events in file, number of events selected from that file and the accumulated number are listed. The last file might not show the correct number of events in file since SELECT might stop before reading the whole file if the end time is in the middle of the file. If start time is blank, 1980 is used. The end time can also be blank, and 2025 is used. This option is useful when selection on whole data base or whole file.

NOTE on time interval: If selecting from S-files or the CAT data base, selection will stop when one event reach the time limit so a wrong time in S-file could stop search. When selection from a file, all events in file will be checked so there is no requirement for correct time order.

Index.out file: It contains the indexes of files selected and can be used to access theses file only like eev index.out. NOTE that the index file will only contain events which have an ID line since ID line is used to create the reference.



Subsections
Peter Voss : Tue Jun 8 13:38:42 UTC 2021