Changes between Version 5 and Version 6 of eqprelim


Ignore:
Timestamp:
05/29/12 10:59:14 (8 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • eqprelim

    v5 v6  
    120120command [argument here] 
    121121 
    122 GetAssocFrom inst mod_id                eqp_config              Earthworm setup   
     122'''!GetAssocFrom [inst mod_id]'''[[BR]] 
     123Processed by: eqp_config[[BR]] 
     124Fucntion: Earthworm setup 
     125 
    123126Controls the association messages input to eqprelim. Eqprelim will only process quakes and links that come from module mod_id at installation inst. inst and mod_id are character strings (valid strings are listed in earthworm.h/earthworm.d) which are related to single- byte numbers that uniquely identify each installation and module. Only 2 "Get*From" commands may be issued; wildcards (INST_WILDCARD and MOD_WILDCARD) will force eqprelim to process all quakes & links, regardless of their place of origin. 
    124  
     127{{{ 
    125128Default:  none 
    126129Calnet:   GetAssocFrom  INST_MENLO  MOD_BINDER 
    127  GetPicksFrom inst mod_id               eqp_config              Earthworm setup   
     130}}} 
     131 
     132'''!GetPicksFrom [inst mod_id]'''[[BR]] 
     133Processed by: eqp_config[[BR]] 
     134Function: Earthworm setup 
     135 
    128136Controls the pick and coda message input to eqprelim. Eqprelim will only process picks and codas that come from module mod_id at installation inst. inst and mod_id are character strings (valid strings are listed in earthworm.h/earthworm.d) which are related to single- byte numbers that uniquely identify each installation and module. Only 2 "Get*From" commands may be issued; wildcards (INST_WILDCARD and MOD_WILDCARD) will force eqprelim to process all picks & codas, regardless of their place of origin. 
    129137Note: both binder and eqprelim should be set to listen to the same pick source(s)! 
    130  
     138{{{ 
    131139Default:  none 
    132140Calnet:   GetPicksFrom  INST_WILDCARD  MOD_WILDCARD 
    133  lay depth velocity                    t_com                   model      
     141}}} 
     142 
     143'''lay [depth velocity]'''[[BR]] 
     144Processed by: t_com[[BR]] 
     145Function: model 
     146 
    134147Defines the layered velocity structure to be used for calculating travel times. depth is the distance (km) to the top of the layer, and velocity is the seismic P-wave velocity (km/sec) within that layer. No default velocity structure is defined; therefore, the user must always supply one in the control file. Up to 20 layers can be specified, and they should be listed in order of increasing depth. 
     148 
    135149Note: binder and eqprelim calculate travel times independently. Be sure that both programs are using the same velocity model! 
    136  
     150{{{ 
    137151Default:  none                          Calnet:  lay   0.0  4.0 
    138152                                                 lay   3.5  5.9 
    139153                                                 lay  15.0  6.85 
    140154                                                 lay  25.0  7.85 
    141  LocalCode x                            eqprelim_config         notification 
     155}}} 
     156 
     157'''!LocalCode [x]'''[[BR]] 
     158Processed by: eqprelim_config[[BR]] 
     159Function: notification 
     160 
    142161Sets the single-character label, x, to identify local picks with in the message sent to the next process. Any picks which were imported from other sources will be labeled with an I. Ultimately, this character ends up in the Hypoinverse archive message in column 92 of the phase line. x must not be surrounded by quotes and it must not be I! 
    143  
     162{{{ 
    144163Default:  none                          Calnet:  LocalCode W 
    145  LogFile switch                         eqp_config              output    
    146 Sets the on-off switch for writing a log file to disk. If switch is 0, no log file will be written. If switch is 1, eqprelim will write a daily log file(s) called eqprelimxx.log_yymmdd where xx is eqprelim's module id (set with "MyModuleId" command) and yymmdd is the current UTC date (ex: 960123) on the system clock. The file(s) will be written in the EW_LOG directory (environment variable). 
    147  
    148 Default:  none 
    149  maxsite nsite                           site_com                model    
     164}}} 
     165 
     166'''!LogFile [switch]'''[[BR]] 
     167Processed by: eqp_config[[BR]] 
     168Function: output 
     169 
     170Sets the on-off switch for writing a log file to disk. If switch is 0, no log file will be written. If switch is 1, eqprelim will write a daily log file(s) called eqprelimxx.log_yymmdd where xx is eqprelim's module id (set with "!MyModuleId" command) and yymmdd is the current UTC date (ex: 960123) on the system clock. The file(s) will be written in the EW_LOG directory (environment variable). 
     171{{{ 
     172Default:  none 
     173}}} 
     174 
     175'''maxsite [nsite]'''[[BR]] 
     176Processed by: site_com[[BR]] 
     177Function: model 
     178 
    150179Allocates memory to store nsite station locations in the site table. 
    151          
     180{{{ 
    152181Default:  maxsite 1000                  Calnet:  maxsite 1000 
    153  MyModuleId mod_id                      eqp_config              Earthworm setup   
     182}}} 
     183 
     184'''!MyModuleId [mod_id]'''[[BR]] 
     185Processed by: eqp_config[[BR]] 
     186Function: Earthworm setup 
     187 
    154188Sets the module id for labeling all outgoing messages. mod_id is a character string (valid strings are listed in earthworm.d) that relates (in earthworm.d) to a unique single-byte number. 
    155  
     189{{{ 
    156190Default:  none                          Calnet:  MyModuleId MOD_EQPRELIM 
    157  NumPickNotify npck                     eqprelim_config         notification 
    158 Sets the threshold for initiating preliminary event processing. When an event has at least npck P-arrivals associated with it, eqprelim will pipe that event to the process specified in the "PipeTo" command. Eqprelim will initiate only one preliminary location per binder eventid, so npck should be set at the number of phases where most event locations become stable (where additional picks won't change the location). 
     191}}} 
     192 
     193'''!NumPickNotify [npck]'''[[BR]] 
     194Processed by: eqprelim_config[[BR]] 
     195Function: notification 
     196 
     197Sets the threshold for initiating preliminary event processing. When an event has at least npck P-arrivals associated with it, eqprelim will pipe that event to the process specified in the "!PipeTo" command. Eqprelim will initiate only one preliminary location per binder eventid, so npck should be set at the number of phases where most event locations become stable (where additional picks won't change the location). 
     198 
    159199Note: it is possible that binder may kill an event after eqprelim has reported it, and eqprelim does not send out any kind of "event killed" message. 
    160  
     200{{{ 
    161201Default:  none                          Calnet:  NumPickNotify 25 
    162  PipeTo cmdstring                       eqp_config              Earthworm setup   
     202}}} 
     203 
     204'''!PipeTo [cmdstring]'''[[BR]] 
     205Processed by: eqp_config[[BR]] 
     206Function: Earthworm setup 
     207 
    163208Sets the command to which eqprelim will pipe a preliminary event for the next step in earthquake processing. Blank spaces are allowed in cmdstring as long as the entire command is enclosed in double-quotes. 
    164  
     209{{{ 
    165210Default:  none 
    166211Calnet:   PipeTo "eqbuf eqbuf.d" 
    167  psratio value                           t_com                   model    
     212}}} 
     213 
     214'''psratio [value]'''[[BR]] 
     215Processed by: t_com[[BR]] 
     216Function: model 
     217 
    168218Sets the value of the P/S seismic velocity ratio. 
    169  
     219{{{ 
    170220Default:  psratio  1.72                 Calnet:  psratio  1.72 
    171  ReportS switch                         eqp_config              notification      
     221}}} 
     222 
     223'''ReportS [switch]'''[[BR]] 
     224Processed by: eqp_config[[BR]] 
     225Function: notification 
     226 
    172227Sets the switch for reporting picks that binder has associated as S-phases. If switch is 0, S-phases are not sent along to the next process; if switch is non-zero, S-phases are included in the event message (hypocenter plus associated picks) that is sent to the next process. 
    173  
     228{{{ 
    174229Default:  none                          Calnet:  ReportS  0 
    175  RingName ring                          eqp_config              Earthworm setup   
     230}}} 
     231 
     232'''!RingName [ring]'''[[BR]] 
     233Processed by: eqp_config[[BR]] 
     234Function: Earthworm setup 
     235 
    176236Tells eqprelim which shared memory region to use for input. ring is a character string (valid strings are listed in earthworm.d) that relates (in earthworm.d) to a unique number for the key to the shared memory region. 
    177  
     237{{{ 
    178238Default:  none                          Calnet:  RingName PICK_RING 
    179  site name latitude longitude           site_com                model     
     239}}} 
     240 
     241'''site [name latitude longitude]'''[[BR]] 
     242Processed by: site_com[[BR]] 
     243Fucntion: model 
     244 
    180245Enters a station location into the station site table, where name is the station code used by the picker, and latitude and longitude are expressed in decimal degrees (positive to the north and east). Use either multiple "site" commands or one "site_file" command to load the station list into eqprelim. 
    181  site_file filename                     site_com                model     
     246 
     247'''site_file [filename]'''[[BR]] 
     248Processed by: site_com[[BR]] 
     249Function: model 
     250 
    182251Enters site codes and station locations into the site table by reading a HYPOINVERSE format station file called filename. In this file, stations are described by a 5-letter site name, a 2-letter network code and a 3-letter component code. The picker must also be using this station-naming convention. The format of the file is described under [wiki:hypo_file_format HYPOINVERSE STATION FILE FOR FULL 12-LETTER (S-N-C-L) CHANNEL NAMES]. Use either one "site_file" command or multiple "site" commands to load the station list into eqprelim. 
    183252