Changes between Version 5 and Version 6 of carlsubtrig


Ignore:
Timestamp:
05/22/12 13:22:21 (8 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • carlsubtrig

    v5 v6  
    5050 
    5151== Configuration File Commands == 
    52 On startup, carlstatrig reads the configuration file named on the command line. Commands in this file set all the parameters used for computing Carl Johnson triggers for individual stations. In the control file, lines may begin with a valid carlstatrig command (listed below) or with one of 2 special characters: 
    53 {{{ 
     52On startup, CarlSubTrig reads the configuration file named on the command line. Commands in this file set all the parameters used for performing the subnet logic for the Carl Johnson trigger system. In the control file, lines may begin with a valid carlsubtrig command (listed below) or with one of 2 special characters: 
     53 
    5454#  marks the line as a comment (example: # This is a comment). 
    55     
    56 @  allows control files to be nested; one control file can be  
    57    accessed from another with the command "@" followed by  
    58    a string representing the path name of the next control file  
     55 
     56@  allows control files to be nested; one control file can be 
     57   accessed from another with the command "@" followed by 
     58   a string representing the path name of the next control file 
    5959   (example: @model.d). 
    60 }}} 
    6160Command names must be typed in the control file exactly as shown in this document (upper/lower case matters!). 
    6261 
     62=== IMPORTANT NOTE === 
     63 
     64Carlsubtrig supports the ability to use late arriving station triggers in the subnet trigger logic. It maintains an internal clock which is set a fixed number of seconds (the latency period) behind wall-clock (real, system) time. This latency period allows for delayed delivery of station trigger messages. Carlsubtrig uses this internal clock to compare to station trigger times. Once the station trigger-on or -off time is later than the internal clock time, this trigger status change is noticed by carlsubtrig. In order for times to be compared between machines, all machines should be synchronized within a few seconds or better. Xntp (available with Solaris2.6 and also public domain) is a good choice for time synchronization. 
     65 
     66'''Because Carlsubtrig uses both system and data time to perform the subnet trigger logic, the system time must be set to UTC. If this is not done, no triggers will occur.''' 
     67 
     68 
    6369=== FUNCTIONAL COMMAND LISTING === 
    6470 
    65 Below are the commands recognized by carlstatrig, grouped by the function they influence. Most of the commands are required; they may be specified in any order in the control file. 
     71Below are the commands recognized by carlsubtrig, grouped by the function they influence. All of the commands are required except Debug; they may be specified in any order in the control file. 
    6672{{{ 
    6773        Earthworm system setup: 
     
    6975                RingNameIn              required 
    7076                RingNameOut             required 
    71                 HeartBeatInterval       required 
     77                HeartBeartInterval      required 
    7278                Debug 
    73  
    74         Station file and trigger parameters: 
     79                GetEventsFrom           required 
     80                TrigIdFilename          optional 
     81 
     82        Station parameters: 
    7583                StationFile             required 
    76                 MaxGap 
    77                 Startup                 required 
    78                 STAtime  
    79                 LTAtime          
    80                 Ratio                   required 
    81                 Quiet                   required 
    82                 Decimation 
    83                 GetWavesFrom            optional  
     84                Latency                 required 
     85                DefStationDur           required 
     86 
     87        Subnet trigger parameters: 
     88                NetTriggerDur           required 
     89                SubnetContrib           required 
     90                PreEventTime            required 
     91                MaxDuration             required 
     92                Subnet                  required 
     93 
     94        Trigger message parameters: 
     95                ListSubnets             optional 
     96                AllSubnets              optional 
     97                CompAsWild              optional 
     98                Channels                optional 
     99                MaxTrigMsgLen           optional 
     100                CoincidentStaTriggers           optional 
     101                IgnoreCoincident                optional 
    84102}}} 
    85103 
    86104=== ALPHABETIC COMMAND LISTING & DESCRIPTION === 
    87105 
    88 In the following section, all configuration file commands are listed in alphabetical order. Listed along with the command (bold-type) are its arguments (in red), the name of the subroutine that processes the command, and the function within the module that the command influences. A detailed description of the command and is also given. Default values and example commands are listed after each command description. 
    89  
    90 The following list is organized by: 
    91  
    92 command [argument here] 
    93  
    94 '''Debug [level]'''[[BR]] 
    95 Processed by: !ReadConfig[[BR]] 
    96 Function: Earthworm setup 
    97  
    98 Sets the debug logging level for !CarlStaTrig. With level set to zero minimal logging is done. Very verbose logging is obtained with level set to 4. 
    99 {{{ 
     106In the following section, all configuration file commands are listed in alphabetical order. Listed along with the command (bold-type) are its arguments (in red), the name of the subroutine that processes the command, and the function within the module that the command influences. A detailed description of the command and is also given. Default values and the values used by PNSN are listed after each command description. 
     107 
     108 
     109command arg1                    processed by            function 
     110 AllSubnets nsubnets            ReadConfig              Earthworm setup 
     111 
     112If nsubnets trigger for an event, then the trigger message will include the SCNL wildcard. A process reading the trigger message could understand this wildcard to mean "retrieve data for All stations". 
     113 
     114Default:  0 
     115Example:  AllSubnets  10 
     116 Channel SCNL                   ReadConfig              Earthworm setup 
     117 
     118Specify a single SCNL that should be listed in all trigger messages. For example, this can be used to list time channels that never trigger but should always be present in waveform data filesets. This command can be used as many times as necessary. 
     119 
     120Default:  0 
     121Example:  Channel WWVB.TIM.UW 
     122 CoincidentStaTriggers                  ReadConfig              Earthworm setup 
     123 
     124The number of station triggers that match exactly to the second that must be met for a trigger message to be rejected. The idea here is to eliminate telemetry glitches by mapping exactly coincident in time trigger on times. The carlstatrigger messages only have on time to the whole second. 
     125 
     126Default:  0  (not set) 
     127Example:  CoincidentStaTriggers 9 
     128 CompAsWild                     ReadConfig              Earthworm setup 
     129 
     130Flag with no value. If present, carlsubtrig will put the wildcard `*' in the trigger message in place of component names. This can be used if you have multi-component stations but only want to listen for station triggers from the vertical component. 
     131 
     132Default:  0  (flag not set) 
     133Example:  CompAsWild 
     134 Debug level                    ReadConfig              Earthworm setup 
     135 
     136Sets the debug logging level for CarlSubTrig. With level set to zero minimal logging is done. Very verbose logging is obtained with level set to 4. 
     137 
    100138Default:  0 
    101139Example:  Debug  3 
    102 }}} 
    103  
    104 '''Decimation [count]'''[[BR]] 
    105 Processed by: !ReadConfig[[BR]] 
    106 Function: Trigger parameter 
    107  
    108 Sets the decimation count for !CarlStaTrig. Normally, every sample is used for computing averages; this is the default decimation of 1. To reduce CPU load, the decimation may be set to 2 or 3 without significantly affecting the trigger results. Then !CarlStaTrig will use every second or third sample for averaging. 
    109 {{{ 
    110 Default:  1 
    111 Example:  Decimation  3 
    112 }}} 
    113  
    114 '''!GetWavesFrom [Inst Mod]'''[[BR]] 
    115 Processed by: !ReadConfig[[BR]] 
    116 Function: Earthworm Setup 
    117  
    118 Defines the waveform logos to retrieve, Inst and Mod module for processing.  
    119 {{{ 
    120 Example: GetWavesFrom INST_WILDCARD MOD_WILDCARD 
    121 }}} 
    122  
    123 '''!HeartBeatInterval [nsec]'''[[BR]] 
    124 Processed by: !ReadConfig[[BR]] 
    125 Function: Earthworm Setup 
    126  
    127 Defines the number of seconds, nsec between TYPE_HEARTBEAT messages issued by carlstatrig.  
    128 {{{ 
    129 Example: HeartBeatInterval 30 
    130 }}} 
    131  
    132 '''!MaxGap [nlevel]'''[[BR]] 
    133 Processed by: !ReadConfig[[BR]] 
    134 Function: Trigger parameter 
    135  
    136 Sets the gap size, in sample periods, above which the station averages are restarted. For smaller gaps, data is interpolated to the sample period for that station. The sample period is specified in TRACE_BUF messages from the source module for that station. The default is 1; that is, reset the station averages for any gap larger than the sample period. 
    137 {{{ 
    138 Default:  1 
    139 Example:  MaxGap  15 
    140 }}} 
    141  
    142 '''!MyModuleId [mod_id]'''[[BR]] 
    143 Processed by: !ReadConfig[[BR]] 
    144 Function: Earthworm setup 
     140 DefStationDur nsecs            ReadConfig              Station parameters 
     141  
     142Sets the default station trigger duration to nsecs seconds. This value is used to terminate a station trigger only if no trigger-off message matching a trigger-on message is received from CarlStaTrig. 
     143 
     144Default:  none 
     145Example:  DefStationDur  120 
     146 GetEventsFrom inst mod_id      ReadConfig              Earthworm setup 
     147  
     148Contrls the TYPE_CARLSTATRIG messages input to carlsubtrig. CarlSubTrig will only process TYPE_CARLSTATRIG messages 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 one "GetSumFrom" command may be issued; wildcards (INST_WILDCARD and MOD_WILDCARD) will force carlsubtrig to process all station trigger messages, regardless of their place of origin. 
     149 
     150Default:  none 
     151Example   GetEventsFrom  INST_WILDCARD  MOD_WILDCARD 
     152 HeartBeatInterval nsec         ReadConfig              Earthworm setup 
     153 
     154Defines the number of seconds, nsec between TYPE_HEARTBEAT messages issued by carlsubtrig. 
     155 
     156Default:  none 
     157Example:  HeartBeatInterval 30 
     158 IgnoreCoincident                       ReadConfig              Earthworm setup 
     159IgnoreCoincident nsubs 
     160If more than the specified number of subnets nsubs are coincidentally triggered, then the coincident check for 
     161triggers is not performed. The reason for this option is because the coincident check should only be 
     162performed for a small number of subnets triggering since telemetry glitches would not cross more than 
     163a few subnetworks. 
     164 
     165Default:  3 
     166Example:  IgnoreCoincident 4 
     167 Latency        nsec                    ReadConfig              Station parameters 
     168  
     169Specifies the number of seconds that carlsubtrig will wait for delivery of station trigger messages. This allows for slow telemetry paths and other delays. 
     170 
     171Default:  none 
     172Example:  Latency   15 
     173 ListSubnets ls         ReadConfig              Earthworm setup 
     174 
     175Flag for determining how which SCNLs will be listed in the trigger message. When ListSubnets is absent or ls is 0, the trigger message will include all triggered SCNLs. If ls is 1, the trigger list will include the untriggered SCNLs as well as the triggered SCNLs from the triggered subnets (but will omit triggered SCNLs that are NOT in the triggered subnets). When ListSubnets is 2, the trigger message will list all SCNLs from the triggered subnets, as well as all other triggered SCNLs (union of options 0 and 1). When ListSubnets is 3, the trigger message will list all SCNLs in any subnets that have at least one triggered SCNL. However, if more than AllSubnets have triggered, then the SCN wildcard will be listed instead of a long list of non-triggered stations. If this flag is absent, then carlsubtrig lists only stations that actually triggered during the event. 
     176The idea here is to adjust the number of SCNLs in the trigger message for a small event. With ListSubnets at 1, we include untriggered SCNLs from triggered subnets. If the subnets are layed out in small geographic areas, then we might expect to have some seismic signal from all SCNLs in triggered subnets. By including those SCNLs in the trigger message, we allow downstream analysis to have the opportunity to look at the data from those SCNLs. If we increase ls to 3, then we are being more conservative in that we save data for anything in subnets that had any SCNLs trigger. In practice, we find that this high value results in almost every SCNL being listed. This is particularly true when there is a lot of weather or telemetry noise present on the network. 
     177 
     178 
     179Default:  0  (flag not set) 
     180Example:  ListSubnets  1 
     181 MaxDuration nsec               ReadConfig              Subnet parameters 
     182  
     183Specifies the maximum duration of a network trigger as nsec seconds. This could be used to limit the size of datafiles retrieved from a wave server. 
     184 
     185Default:  none 
     186Example:  MaxDuration  1800 
     187 MaxTrigMsgLen nsec             ReadConfig              Subnet parameters 
     188  
     189Specifies the maximum length (bytes) of a triglist message; up to MAX_BYTES_PER_EQ (earthworm.h). 
     190 
     191Default:  MAX_BYTES_PER_EQ 
     192Example:  MaxTrigMsgLen  30000 
     193 MyModuleId mod_id              ReadConfig              Earthworm setup 
    145194 
    146195Sets the module id for labeling all outgoing trigger, heartbeat, and error messages. mod_id is a character string (valid strings are listed in earthworm.d) that relates to a unique single-byte number. 
    147 {{{ 
    148 Default:  none 
    149 Example:  MyModuleId MOD_CARLSTATRIG 
    150 }}} 
    151  
    152 '''Quiet [equiet]'''[[BR]] 
    153 Processed by: !ReadConfig[[BR]] 
    154 Function: Trigger parameter 
    155  
    156 Sets the value of Carl Johnson's equiet parameter for the station trigger calculation. This parameter is a trigger level adjustment. 
    157 {{{ 
    158 Default:  none 
    159 Example:  Quiet 4.0 
    160 }}} 
    161  
    162 '''Ratio [ratio]'''[[BR]] 
    163 Processed by: !ReadConfig[[BR]] 
    164 Function: Trigger parameter 
    165  
    166 Sets the value of the trigger ratio. In Carl Johnson's original formulation, this was enumer / edenom. 
    167 {{{ 
    168 Default:  none 
    169 Example:  Ratio 2.3 
    170 }}} 
    171  
    172 '''!RingNameIn [ring]'''[[BR]] 
    173 Processed by: !ReadConfig[[BR]] 
    174 Function: Earthworm setup 
    175  
    176 Tells carlstatrig 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 {{{ 
    178 Default:  none 
    179 Example:  RingNameIn  WAVE_RING 
    180 }}} 
    181  
    182 '''!RingNameOut [ring]'''[[BR]] 
    183 Processed by: !ReadConfig[[BR]] 
    184 Function: Earthworm setup 
    185  
    186 Tells carlstatrig which shared memory region to use for output. 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. 
    187 {{{ 
    188 Default:  none 
    189 Example:  RingNameOut PICK_RING 
    190 }}} 
    191  
    192 '''!StartUp [nsec]'''[[BR]] 
    193 Processed by: !ReadConfig[[BR]] 
    194 Function: Trigger parameter 
    195  
    196 Sets the startup time for stations averages to nsec seconds. Carlstatrig waits this number of seconds after startup and reset before it calculates station triggers. This allows long-term averages to stabilize; otherwise false triggers would be sent on startup. 
    197 {{{ 
    198 Default:  none 
    199 Example:  StartUp  7 
    200 }}} 
    201  
    202 '''STAtime [nsec]'''[[BR]] 
    203 Processed by: !ReadConfig[[BR]] 
    204 Function: Trigger parameter 
    205  
    206 Sets the time for the short-term average (STA) to nsec seconds. 
    207 {{{ 
    208 Default:  1 
    209 Example:  STAtime  3 
    210 }}} 
    211  
    212 '''LTAtime [nsta]'''[[BR]] 
    213 Processed by: !ReadConfig[[BR]] 
    214 Function: Trigger parameter 
    215  
    216 Sets the nominal time for the long-term average (LTA) time to nsta STAtimes. This is the time over which the time-dependent weighting factor used in the averaging decreases by a factor of approximately 1/e. 
    217 {{{ 
    218 Default:  8 
    219 Example:  LTAtime  20 
    220 }}} 
    221  
    222 '''!StationFile [sta_file]'''[[BR]] 
    223 Processed by: !ReadConfig[[BR]] 
    224 Function: Station File 
    225  
    226 Specifes sta_file as the file of stations to be monitored by carlstatrig. This file can be the same station file as the one for !CarlSubTrig. !CarlStaTrig uses all TRACEBUF messages it gets from its input ring which are listed in the station file. Any other TRACEBUF messages, and stations in the file for which there are no TRACEBUF messages, are ignored. In the following sample station file, the Trigger Time To Live value is not used by carlstaTrig. 
    227 {{{ 
     196 
     197Default:  none 
     198Example:  MyModuleId MOD_CARLSUBTRIG 
     199 NetTriggerDur nsecs            ReadConfig              Subnet parameters 
     200  
     201Sets the base network trigger duration to nsecs seconds. The minimum trigger duration is the sum of PreEventTime, NetTriggerDur and SubnetContrib times the number of subnets that triggered. 
     202 
     203Default:  none 
     204Example:  NetTriggerDur  10 
     205 PreEventTime nsecs             ReadConfig              Subnet parameters 
     206 
     207Specifies the number of seconds nsecs before the initial station trigger to start the network trigger. This can be used to start saving waveform data prior to the first phase arrivals. The minimum trigger duration is the sum of PreEventTime, NetTriggerDur and SubnetContrib times the number of subnets that triggered. 
     208 
     209Default:  none 
     210Example:  PreEventTime  10 
     211 RingNameIn ring                        ReadConfig              Earthworm setup 
     212 
     213Tells carlsubtrig 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 
     215Default:  none 
     216Example:  RingNameIn  PICK_RING 
     217 RingNameOut ring               ReadConfig              Earthworm setup 
     218 
     219Tells carlsubtrig which shared memory region to use for output. 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. 
     220 
     221Default:  none 
     222Example:  RingNameOut HYPO_RING 
     223 StationFile sta_file           ReadConfig              Station parameters 
     224 
     225Specifies sta_file as the file of stations to be monitored by carlsubtrig. This file can be the same station file as the one for CarlStaTrig. This file must list all the stations that make up the Subnets. This file lists each station by station name, component and network. It also specifies the Trigger Time To Live. This is the number of seconds that each station trigger will be help active in CarlSubTrig after CarlStaTrig reports the station trigger off. This Trigger Time To Live allows for the seismic signal propagation time from each station to the other stations in the subnet. 
     226 
    228227Default:  none 
    229228Example:  StationFile  pnsn_trig.sta 
    230 }}} 
    231  
    232 === Sample Configuration File === 
    233 {{{ 
    234 # $Id: carlstatrig_cmd.html 4571 2011-08-18 20:28:39Z stefan $ 
    235 # 
    236 # CarlStaTrig's Parameter File 
     229 
     230'''Sample Station File:''' 
     231{{{ 
     232# 
     233#   carlsta/subtrig.sta  FOR PNSN 
     234# 
     235#   PNSN station list 
     236# 
     237# Arbitrary Station Component Network Location Trigger 
     238#           Code    Code      Code    Code     Time To Live 
     239# --------- ------- ------- --------- -------- ------------ 
     240  station   GMW     EHZ     UW        --        10 
     241  station   GSM     EHZ     UW        00        10 
     242  station   BLN     EHZ     UW        00        15 
     243  station   CPW     EHZ     UW        01        10 
     244  station   JCW     EHZ     UW        --        10 
     245}}} 
     246 
     247 Subnet code ntrig sta.comp.net ...     ReadSubnet      Subnet parameters 
     248 
     249This command lists the subnet code, number of stations ntrig required to trigger the subnet, and the list of stations making up the subnet. Code is a string (up to 3 characters) that is used to identify the subnet in logged messages. There may be any number of Subnet commands, and there may be up to 20 stations in one subnet. 
     250This command supports a "|" symbol in the list of stations. It differenitates those stations to be used in the trigger count (stations to the left of "|") and those stations that are not. All stations in a subnet are recorded if sufficient stations to the left of the "|" are triggered. 
     251 
     252The "subnet" command supports non-numeric subnet names of a maximum of 9 characters. These non-numeric names are now stored and passed through to later routines through the triglist2k message. If the subnet name is numeric, no subnet name is passed through to later routines. Currently, the subnet names are used only in filenames written by sudsputaway. 
     253 
     254 
     255Default:  none 
     256Examples: Subnet 2   4   LO2.EHZ.UW FMW.EHZ.UW RER.EHZ.UW RCM.EHZ.UW RCS.EHZ.UW 
     257          Subnet RG  3   MLK.VHZ.NC MEM.VHZ.NC MSL.VHZ.NC MCS.VHZ.NC MCM.VHZ.NC  
     258 SubnetContrib nsecs            ReadConfig              Subnet parameters 
     259  
     260Specifies the number of seconds nsecs that each triggered subnet contributes to the total duration of the network trigger. The minimum trigger duration is the sum of PreEventTime, NetTriggerDur and SubnetContrib times the number of subnets that triggered. 
     261 
     262Default:  none 
     263Example:  SubnetContrib   15 
     264 TrigIdFilename filename                ReadConfig              Earthworm setup 
     265 
     266Tells carlsubtrig which filename to find the next_id for the trigger id's. If this is used, then the hard coded command @trig_id.d should not be used. 
     267 
     268Default:  none 
     269Example:  TrigIdFilename trig/trig_id.d 
     270 
     271=== SAMPLE CONFIGURATION FILE === 
     272{{{ 
     273 # 
     274# CarlSubTrig's Parameter File 
    237275# 
    238276 
     
    240278#  Basic Earthworm Setup 
    241279# 
    242 MyModuleId      MOD_CARLSTATRIG # Module id for this instance of CarlStaTrig 
    243                                 # - REQUIRED 
    244 RingNameIn      WAVE_RING       # Name of ring from which trace data will be 
    245                                 #   read - REQUIRED. 
    246 RingNameOut     PICK_RING       # Name of ring to which triggers will be 
    247                                 #   written - REQUIRED. 
    248 HeartBeatInterval       0       # Heartbeat Interval (seconds). REQUIRED 
    249  
    250 # Set debug log message level: OPTIONAL (default: 0) 
    251 #   0  log transport errors, changes in datatype, samplerate, failure to flush 
    252 #   1  above plus large gaps and overlaps  
    253 #   2  above plus small gaps and overlaps, station trigger changes -  
    254 #      best for beginning installations 
    255 #   3  above plus station trigger values and messages  
    256 #   4  above plus "unable to find station..."  
    257 #   5  above plus many details of message handling - very verbose.  
    258  
    259 Debug 1 
    260  
    261 # 
    262 # CarlTrig Specific Setup 
    263 # 
    264 StationFile     "pnsn_trig.sta" # Name of file containing station information - 
     280MyModuleId      MOD_CSU_TEST    # Module id for this instance of CarlSubTrig - 
     281                                # 
     282Debug           2               # Write out debug messages? (0 = No, 
     283                                #   1 = Minimal, 3 = Chatterbox ) 
     284RingNameIn      PICK_RING       # Name of ring from which station triggers 
     285                                #   will be read - REQUIRED. 
     286RingNameOut     HYPO_RING       # Name of ring to which triggers will be 
     287                                #   written - REQUIRED. 
     288HeartBeatInterval       30      # Heartbeat Interval (seconds). 
     289 
     290# 
     291# CarlSubTrig Specific Setup 
     292# 
     293StationFile     "pnsn_trig.sta" # Name of file containing station information - 
     294                                #   REQUIRED. 
     295Latency         15              # Number of seconds that the Network clock 
     296                                #   is behind wall clock REQUIRED. 
     297NetTriggerDur   10              # Number of seconds for the base network 
     298                                #   trigger duration REQUIRED. 
     299SubnetContrib   15              # Addition contribution to network trigger 
     300                                #   duration for each subnet that triggered 
    265301                                #   REQUIRED. 
    266 MaxGap          1.5             # Maximum gap between trace data points that 
    267                                 #   can be interpolated (otherwise restart the 
    268                                 #   station). OPTIONAL (default MaxGap = 1) 
    269 StartUp         60              # Minimum seconds of trace data needed to 
    270                                 #   before using LTAs REQUIRED. Recommended 
    271                                 #   value is 2.5 * LTAtime * STAtime. 
    272 STAtime         3               # Number of seconds for short term average 
    273                                 # OPTIONAL (integer; default STAtime = 1) 
    274 LTAtime         8               # Long-term average time (time to 1/e weight) 
    275                                 #   in units of STAtime. 
    276                                 # OPTIONAL (default LTAtime = 8) 
    277 Decimation      1               # Decimation factor used in averages 
    278                                 # OPTIONAL (default Decimation = 1) 
    279 Ratio           2.3             # Carl Trigger parameter: enumer / edenom 
    280                                 # REQUIRED 
    281 Quiet           4.0             # Carl Trigger equiet parameter - REQUIRED 
    282  
    283 GetWavesFrom INST_WILDCARD MOD_WILDCARD # optional way to specify which trace logos to get 
    284 }}} 
    285  
    286 === Sample Station File === 
    287 {{{ 
    288 # 
     302PreEventTime    10              # Number of seconds added to beginning of 
     303                                #   network trigger REQUIRED. 
     304MaxDuration     500             # Maximum duration allowed for network trigger 
     305DefStationDur   120             # Default number of seconds for station 
     306                                #   trigger duration if the trigger-off 
     307                                #   message is not received. REQUIRED. 
     308ListSubnets     1               # Flag to list untriggered stations 
     309                                #   =0 or command not present: list all 
     310                                #        triggered stations 
     311                                #   =1 list all stations in triggered subnets 
     312                                #   =2 list all stations in triggered subnets 
     313                                #        plus any other triggered stations. 
     314                                #   =3 list all stations in subnets that had 
     315                                #        any stations triggered 
     316AllSubnets      10              # If this many subnets trigger, put wildcard 
     317                                #   SCNL in event message 
     318CompAsWild                      # Flag (no value) to list component names in 
     319                                #   trigger messages as `*' (wildcard). 
     320MaxTrigMsgLen   30000           # maximum length (bytes) of a triglist message; 
     321                                #   up to MAX_BYTES_PER_EW (earthworm.h). 
     322 
     323# Load the next valid trigger sequence number 
     324# this is one way to specify where the next id comes from: 
     325@trig_id.d            # this name is hard-coded; do not change 
     326 
     327# or you can use this now so you can place it somewhere else: 
     328 
     329TrigIdFilename  trig/trig_id.d   # a new way to specify where the trig_id.d command 
     330 
     331# List the message logos to grab from transport ring 
     332#              Installation       Module          Message Types (hard-wired) 
     333GetEventsFrom  INST_WILDCARD    MOD_WILDCARD    # TYPE_CARLSTATRIG # REQUIRED. 
     334 
     335# Non-seismic or other channels that should be included in all event messages 
     336# List one SCNL per line, as many as you need 
     337Channel  *.TIM.UW 
     338Channel  LON.LHZ.UW.-- 
     339 
     340# Subnet definitions for the CarlSubTrig Earthworm module 
     341# Each Subnet must be on a single line 
     342# Subnet  Minimum to      List of Station.Component.Network 
     343# Number  Trigger         Codes (space delimited) 
     344# ------- ---  ------------------------------------------- 
     345Subnet 0   3   CRF.EHZ.UW.-- EPH.EHZ.UW.-- GBL.EHZ.UW.-- MDW.EHZ.UW.-- OT3.EHZ.UW.-- RC1.EHZ.UW.-- VT2.EHZ.UW.-- WA2.EHZ.UW.-- WRD.EHZ.UW.-- 
     346Subnet 1   4   BRV.EHZ.UW.-- ET3.EHZ.UW.00 GBL.EHZ.UW.00 MDW.EHZ.UW.00 OT3.EHZ.UW.-- PRO.EHZ.UW.-- RSW.EHZ.UW.-- WA2.EHZ.UW.-- 
     347}}} 
     348 
     349=== SAMPLE STATION FILE === 
     350{{{ 
     351 # 
    289352#   carlsta/subtrig.sta  FOR PNSN 
    290353# 
    291354#   PNSN station list 
    292355# 
    293 # Arbitrary Station Component Network Location  Trigger 
    294 #           Code    Code      Code    Code      Time To Live 
    295 # --------- ------- ------- --------- --------- ------------ 
    296   station   GMW       EHZ       UW        --            10 
    297   station   GSM       EHZ       UW        --            10 
    298   station   BLN       EHZ       UW        --            10 
    299   station   CPW       EHZ       UW        --            10 
    300   station   JCW       EHZ       UW        --            10 
     356# Arbitrary Station Component Network Location Trigger 
     357#           Code    Code      Code    Code     Time To Live 
     358# --------- ------- ------- --------- ------- ----- 
     359  station   GMW       EHZ           UW --     10 
     360  station   GSM       EHZ           UW --     10 
     361  station   BLN       EHZ           UW --     10 
     362  station   CPW       EHZ           UW --     10 
     363  station   JCW       EHZ           UW --     10 
    301364}}} 
    302365 
    303366== Helpful Hints == 
     367 
     368