Changes between Version 4 and Version 5 of localmag


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

--

Legend:

Unmodified
Added
Removed
Modified
  • localmag

    v4 v5  
    185185command [argument here] 
    186186 
    187 Add STA COMP NET LOC    Event and Trace Commands 
     187'''Add [STA COMP NET LOC]'''[[BR]] 
     188Function: Event and Trace Commands 
     189 
    188190Add the trace(s) with station name STA, component name COMP and network name NET and location code LOC to the selection list. Any of STA, COMP and NET may be the wildcard character `*'. COMP may be given as the first two letters of the component name, to select all direction desgnators (North and East) are accepted for that component. Vertical `Z' components are never selected by localmag. Zero, one or many Add commands may be listed in the configuration file. If no Add commands are given, all SCNLs from the trace source will be selected. The Del command may be used to narrow the selection implied by wildcard values in an Add command or by the absence of any Add commands. 
     191{{{ 
    189192Default: all traces are selected from a trace source 
    190193Example: Add * BH * 
    191194         Add SEA EH UW 
    192 allowVerticals     Flag 
    193 Amplitude Controls 
     195}}} 
     196 
     197'''allowVerticals [Flag]'''[[BR]] 
     198Function: Amplitude Controls 
     199 
    194200allowVerticals is an optional configuration parameter. If the Flag is set to any non-zero integer, then Z components (vertical channels) are used in the ML computation. If an separte attenuation relationship is provided for them (see logA0 command), then it will be used otherwise the attenuation of the horizontals will be used. Verticals are NOT ALLOWED by default (if this command is missing).  
     201{{{ 
    195202Default: 0, this command is optional 
    196203Example: allowVerticals 1 
    197 Debug D Miscellaneous Commands 
    198 Set the debug level to D. There are many different debug options; one or more of them may be activated using the Debug command. More than one Debug command may be used, or the different values (from the table) may be added together into one Debug command. Except as noted, the debug information is printed to STDERR and the log file (depending on the setting of LogFile.) Select from these debug options: 
    199 1: 
    200 trace and search times and P and S arrival estimates (relative to event origin time) 
    201 2: 
    202 SCNL selection tests 
    203 4: 
    204 distance and LogA0 values 
    205 8: 
    206 SAC file selection (only if traceSource is SAC) 
    207 16: 
    208 ws_client debugging 
    209 32: 
    210 poles. zeros and gain values 
    211 64: 
    212 trial frequency response functions to STDOUT. Produces about 1500 lines for each SCNL, which should be saved to a file. 
    213 128: 
    214 full frequency response function to STDOUT. Produces several thousand lines for each SCNL, which should be saved to a file. 
    215 256: 
    216 Input and output trace data including in padded arear to STDOUT. Produces several thousand lines for each SCNL, which should be saved to a file. 
     204}}} 
     205 
     206'''Debug [D]'''[[BR]] 
     207Function: Miscellaneous Commands 
     208 
     209Set the debug level to D. There are many different debug options; one or more of them may be activated using the Debug command. More than one Debug command may be used, or the different values (from the table) may be added together into one Debug command. Except as noted, the debug information is printed to STDERR and the log file (depending on the setting of !LogFile.) Select from these debug options: 
     210 
     2111: trace and search times and P and S arrival estimates (relative to event origin time)[[BR]] 
     2122: SCNL selection tests[[BR]] 
     2134: distance and LogA0 values[[BR]] 
     2148: SAC file selection (only if traceSource is SAC)[[BR]] 
     21516: ws_client debugging[[BR]] 
     21632: poles. zeros and gain values[[BR]] 
     21764: trial frequency response functions to STDOUT. Produces about 1500 lines for each SCNL, which should be saved to a file.[[BR]] 
     218128: full frequency response function to STDOUT. Produces several thousand lines for each SCNL, which should be saved to a file.[[BR]] 
     219256: Input and output trace data including in padded arear to STDOUT. Produces several thousand lines for each SCNL, which should be saved to a file. 
     220{{{ 
    217221Default: 0; no debug output 
    218222Example: Debug 7 # turns on options 1, 2 and 4 
    219 ChannelNumberMap ENZ    Event and Trace Commands 
     223}}} 
     224 
     225'''!ChannelNumberMap [ENZ]'''[[BR]] 
     226Function: Event and Trace Commands 
     227 
    220228Convert channels with Number orientations to letter orientations using the mapping string ENZ provided. The Map string maps 1 to the first letter, 2 to the second letter, and 3 to the last letter of the three char string provided. For example, a map of ENZ that means channels named EH1 would be seen as a East component horizontal and channel EH2 would be seen as a north component horizontal. Note that localmag does not recognize numbers, so this conversion is needed, otherwise the channel is rejected. 
     229{{{ 
    221230Default: Not used, numbered channels are ignored. 
    222 Del STA COMP NET LOC    Event and Trace Commands 
     231}}} 
     232 
     233'''Del [STA COMP NET LOC]'''[[BR]] 
     234Function: Event and Trace Commands 
     235 
    223236Delete the trace(s) with station name STA, component name COMP, network name NET, and location code LOC from the selection list. Any of STA, COMP and NET may be the wildcard character `*'. COMP may be given as the first two letters of the component name, to select all direction desgnators (North and East) are accepted for that component. Zero, one or many Del commands may be listed in the configuration file. 
     237{{{ 
    224238Default: all traces are selected from a trace source 
    225239Example: Del SEA BH UW 01 
    226 eventSource SOURCE [params]     Event and Trace Commands 
    227 Tells localmag where to find information about the event it is to process. The event information that localmag needs is: origin time, origin latitude, longitude and depth. If any of these values are missing, localmag will not process the event. EventSource may be specified on the command line (especially when run as a stand-alone program) instead of in the configuration file. The choices available for SOURCE are: 
    228 ARCH: 
    229 Command line: -eh Read event information from a hyp2000 archive message. This message is read from standard input except when localmag is running as an earthwrom module (see MyModId). In that case, the archive message is read from the transport ring. 
    230 SAC: 
    231 Command line: -es Read event information from the headers of one or more SAC files. If this option is used, then traceSource must be SAC and SACsource must be given. See also the command-line option for traceSource for naming the SAC directory on the command line. 
    232 EWDB eventID: 
    233 Command line: -ee eventID Obtain event information from an Earthworm database. Not currently implemented. 
     240}}} 
     241 
     242'''eventSource [SOURCE [params]]'''[[BR]] 
     243Function: Event and Trace Commands 
     244 
     245Tells localmag where to find information about the event it is to process. The event information that localmag needs is: origin time, origin latitude, longitude and depth. If any of these values are missing, localmag will not process the event. !EventSource may be specified on the command line (especially when run as a stand-alone program) instead of in the configuration file. The choices available for SOURCE are: 
     246 
     247ARCH: Command line: -eh Read event information from a hyp2000 archive message. This message is read from standard input except when localmag is running as an earthwrom module (see !MyModId). In that case, the archive message is read from the transport ring. 
     248 
     249SAC: Command line: -es Read event information from the headers of one or more SAC files. If this option is used, then traceSource must be SAC and SACsource must be given. See also the command-line option for traceSource for naming the SAC directory on the command line. 
     250 
     251EWDB eventID: Command line: -ee eventID Obtain event information from an Earthworm database. Not currently implemented. 
     252{{{ 
    234253Default: ARCH (read hyp2000 archive messages) 
    235254Examples for the command-line: -es 00010101095 
     255}}} 
     256 
    236257eventXML n      Event and Trace Commands 
    237258Optional setting to force writing of the SHAKEMAP EVENT XML format file to the SAC output directory. MUST BE USED with saveTrace option and SAC output at the time of this writing. Defaults to being off. Set n to 1 to activate this feature.