Changes between Version 3 and Version 4 of eqproc


Ignore:
Timestamp:
05/22/12 05:34:43 (8 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • eqproc

    v3 v4  
    150150command [argument here] 
    151151 
    152 GetAssocFrom inst mod_id                eqp_config              Earthworm setup   
     152'''!GetAssocFrom [inst mod_id]'''[[BR]] 
     153Processed by: eqp_config[[BR]] 
     154Function: Earthworm setup 
     155 
    153156Controls the association messages input to eqproc. Eqproc 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 eqproc to process all quakes & links, regardless of their place of origin. 
    154  
     157{{{ 
    155158Default:  none 
    156159Calnet:   GetAssocFrom  INST_MENLO  MOD_BINDER 
    157  GetPicksFrom inst mod_id               eqp_config              Earthworm setup   
     160}}} 
     161 
     162'''!GetPicksFrom [inst mod_id]'''[[BR]] 
     163Processed by: eqp_config[[BR]] 
     164Function: Earthworm setup 
     165 
    158166Controls the pick and coda message input to eqproc. Eqproc 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 eqproc to process all picks & codas, regardless of their place of origin. 
     167 
    159168Note: both binder and eqproc should be set to listen to the same pick source(s)! 
    160  
     169{{{ 
    161170Default:  none 
    162171Calnet:   GetPicksFrom  INST_WILDCARD  MOD_WILDCARD 
    163  graph                                          eqp_config              output    
     172}}} 
     173 
     174'''graph'''[[BR]] 
     175Processed by: eqp_config[[BR]] 
     176Function: output 
     177 
    164178Requests that a graphical representation of all phases and their residuals be written to a file named GRyyyymmddhhnn## (see "print" command for naming convention). The plot displays the time-residual horizontally and the epicentral distance vertically. See Johnson (1994) for a more complete description of this graph. This file is useful for tuning and debugging. 
    165  
     179{{{ 
    166180Default:  don't write the GR* file 
    167  lay depth velocity                    t_com                   model      
     181}}} 
     182 
     183'''lay [depth velocity]'''[[BR]] 
     184Processed by: t_com[[BR]] 
     185Function: model 
     186 
    168187Defines 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. 
     188 
    169189Note: binder and eqproc calculate travel times independently. Be sure that both programs are using the same velocity model! 
    170  
     190{{{ 
    171191Default:  none                          Calnet:  lay   0.0  4.0 
    172192                                                 lay   3.5  5.9 
    173193                                                 lay  15.0  6.85 
    174194                                                 lay  25.0  7.85 
    175  LogFile switch                         eqp_config              output    
    176 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, eqproc will write a daily log file(s) called eqprocxx.log_yyyymmdd where xx is eqproc's module id (set with "MyModuleId" command) and yyyymmdd is the current UTC date (ex: 19960123) on the system clock. The file(s) will be written in the EW_LOG directory (environment variable). 
    177  
     195}}} 
     196 
     197'''!LogFile [switch]'''[[BR]] 
     198Processed by: eqp_config[[BR]] 
     199Function: output 
     200 
     201Sets 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, eqproc will write a daily log file(s) called eqprocxx.log_yyyymmdd where xx is eqproc's module id (set with "!MyModuleId" command) and yyyymmdd is the current UTC date (ex: 19960123) on the system clock. The file(s) will be written in the EW_LOG directory (environment variable). 
     202{{{ 
    178203Default:  none 
    179  maxsite nsite                           site_com                model    
     204}}} 
     205 
     206'''maxsite [nsite]'''[[BR]] 
     207Processed by: site_com[[BR]] 
     208Function: model 
     209 
    180210Allocates memory to store nsite station locations in the site table. 
    181          
     211{{{ 
    182212Default:  maxsite 1000                  Calnet:  maxsite 1000 
    183  MyModuleId mod_id                      eqp_config              Earthworm setup   
     213}}} 
     214 
     215'''!MyModuleId [mod_id]'''[[BR]] 
     216Processed by: eqp_config[[BR]] 
     217Function: Earthworm setup 
     218 
    184219Sets 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. 
    185  
     220{{{ 
    186221Default:  none                          Calnet:  MyModuleId MOD_EQPROC 
    187  pick_fifo_length npickfifo                              eqp_config                model          
     222}}} 
     223 
     224'''pick_fifo_length [npickfifo]'''[[BR]] 
     225Processed by: eqp_config[[BR]] 
     226Function: model 
     227 
    188228Allocates memory to store npickfifo picks and codas while binder chews on them. Must be set to a value greater than or equal to npickfifo used by binder. 
    189          
     229{{{ 
    190230Default:  pick_fifo_length 1000         Calnet:  pick_fifo_length 4000 
    191  PipeTo cmdstring                       eqp_config              Earthworm setup   
     231}}} 
     232 
     233'''!PipeTo [cmdstring]'''[[BR]] 
     234Processed by: eqp_config[[BR]] 
     235Function: Earthworm setup 
     236 
    192237Sets the command to which eqproc will pipe a "binder-finalized" 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. 
    193  
     238{{{ 
    194239Default:  none 
    195240Calnet:   PipeTo "eqbuf eqbuf.d" 
    196  print                                  eqp_config              output    
     241}}} 
     242 
     243'''print'''[[BR]] 
     244Processed by: eqp_config[[BR]] 
     245Function: output 
     246 
    197247Requests that the final hypocenter and phase summary data for each event be written to a file. The file's name combines the earthquake's origin-time and the last 2 digits of its event id# (assigned by binder) in the form PRyyyymmddhhnn## where yyyy is the year, mm is the month, dd is the day of the month, hh is the hour (0-23), nn is the minutes past the hour, and ## is the last 2 digits of the event id. For example, picks from event id# 1399 on July 12, 1995 at 0123 GMT would be found in PR19950712012399. All phases with a residual less than maxres ("rpt_grab" command) are included in this file regardless of how the picks are associated. Picks are tagged with the phase that is being considered. If a pick is associated with a different event, it is labeled with that event's id#. If a pick is not associated with any event, it is labeled as WAIF. This file is useful for tuning and debugging. 
    198  
     248{{{ 
    199249Default:  don't write the PR* file 
    200  psratio value                           t_com                   model    
     250}}} 
     251 
     252'''psratio [value]'''[[BR]] 
     253Processed by: t_com[[BR]] 
     254Function: model 
     255 
    201256Sets the value of the P/S seismic velocity ratio. 
    202  
     257{{{ 
    203258Default:  psratio  1.72                 Calnet:  psratio  1.72 
    204  quake_fifo_length nquakefifo                         eqp_config                model     
     259}}} 
     260 
     261'''quake_fifo_length [nquakefifo]'''[[BR]] 
     262Processed by: eqp_config[[BR]] 
     263Function: model 
     264 
    205265Allocates memory to store nquakefifo quake messages while binder chews on them. Must be set to a value greater than or equal to nquakefifo used by binder. 
    206          
     266{{{ 
    207267Default:  quake_fifo_length 100         Calnet:  quake_fifo_length 100 
    208  ReportS switch                         eqp_config              notification      
     268}}} 
     269 
     270'''!ReportS [switch]'''[[BR]] 
     271Processed by: eqp_config[[BR]] 
     272Function: notification 
     273 
    209274Sets 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. 
    210  
     275{{{ 
    211276Default:  none                          Calnet:  ReportS  0 
    212  RingName ring                          eqp_config              Earthworm setup   
     277}}} 
     278 
     279'''!RingName [ring]'''[[BR]] 
     280Processed by: eqp_config[[BR]] 
     281Function: Earthworm setup 
     282 
    213283Tells eqproc 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. 
    214  
     284{{{ 
    215285Default:  none                          Calnet:  RingName PICK_RING 
    216  rpt_dwell treport                      eqp_config              notification      
     286}}} 
     287 
     288'''rpt_dwell [treport]'''[[BR]] 
     289Processed by: eqp_config[[BR]] 
     290Function: notification 
     291 
    217292Sets the length of time (seconds) to wait after the last modification to a hypocenter before reporting the event. 
    218  
     293{{{ 
    219294Default:  rpt_dwell 30.0                Calnet:  rpt_dwell 60.0 
    220  rpt_grab maxres                                eqp_config              notification      
     295}}} 
     296 
     297'''rpt_grab [maxres]'''[[BR]] 
     298Processed by: eqp_config[[BR]] 
     299Function: notification 
     300 
    221301Defines the maximum residual (seconds) for reporting a given phase with respect to an event. maxres should span binder's allowed residual range for associating picks (see binder's "taper" and "taper_OT" commands); otherwise, eqproc may not list all picks that binder associated with the event. All phases with a residual less than maxres are included in an event's PR* file ("print" command) and GR* file ("graph" command), regardless of how the picks are associated. 
    222  
     302{{{ 
    223303Default:  rpt_grab 4.0                  Calnet:  rpt_grab 4.0 
    224  site name latitude longitude           site_com                model     
     304}}} 
     305 
     306'''site [name latitude longitude]'''[[BR]] 
     307Processed by: site_com[[BR]] 
     308Function: model 
     309 
    225310Enters 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 eqproc. 
    226  site_file filename                     site_com                model     
     311 
     312'''site_file [filename]'''[[BR]] 
     313Processed by: site_com[[BR]] 
     314Function: model 
     315 
    227316Enters 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, a 3-letter component code, and a 2-letter location code. The picker must also be using this station-naming convention. The format of the file is described under "HYPOINVERSE STATION FILE FOR FULL 12-LETTER S-N-C-L STATION NAMES". Use either one "site_file" command or multiple "site" commands to load the station list into eqproc. 
    228317 
     
    318407 
    319408=== THE "MEGA-MODULE" WHICH BEGINS WITH EQPROC === 
    320 The eqproc "mega-module" is a chain of processes that produces final earthquake locations for the Earthworm system. Only eqproc, the first link in the mega-module, is listed in startstop's configuration file to be started by startstop. Eqproc then starts the next process, specified in its "PipeTo" command, and communicates with it via a pipe. Each newly created process starts the next link in the same way. From startstop's point of view, the whole mega-module inherits the name of the first link (eqproc) and that's the only name it displays. From statmgr's point of view, all processes within the mega-module share one module id, one heartbeat, and one descriptor file. However, each process has its own configuration file and its own log file. 
     409The eqproc "mega-module" is a chain of processes that produces final earthquake locations for the Earthworm system. Only eqproc, the first link in the mega-module, is listed in startstop's configuration file to be started by startstop. Eqproc then starts the next process, specified in its "!PipeTo" command, and communicates with it via a pipe. Each newly created process starts the next link in the same way. From startstop's point of view, the whole mega-module inherits the name of the first link (eqproc) and that's the only name it displays. From statmgr's point of view, all processes within the mega-module share one module id, one heartbeat, and one descriptor file. However, each process has its own configuration file and its own log file. 
    321410 
    322411As of 8 September 1999, the eqproc mega-module consists of the following "links":