Changes between Version 5 and Version 6 of localmag


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

--

Legend:

Unmodified
Added
Removed
Modified
  • localmag

    v5 v6  
    255255}}} 
    256256 
    257 eventXML n      Event and Trace Commands 
     257'''eventXML [n]'''[[BR]] 
     258Function: Event and Trace Commands 
     259 
    258260Optional 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. 
    259261 
    260 EWDBaccess USER PASSWORD SERVICE        Miscellaneous Commands 
     262'''EWDBaccess [USER PASSWORD SERVICE]'''[[BR]] 
     263Function: Miscellaneous Commands 
     264 
    261265Specify the three parameters needed to access and Earthworm database. Not currently implemented. 
    262 extraDelay seconds       Event and Trace Commands 
    263 When running as an Earthworm module (see RingInName) localmag will wait before processing a new event until traces have had time to propagate to the maxDist plus extraDelay seconds (which may be positive or negative.) The calculation of the maximum wait time is done at startup, assuming an event on the surface and a station at maxDist. When a new event message is received, localmag compares the origin time to the current (system) time. Localmag then sleeps until origin time is older than system time by the computed wait time. This will ensure that the waves localmag is aboutto request will have time to arrive at the station and thence at the wave_server. 
     266 
     267'''extraDelay [seconds]'''[[BR]] 
     268Function: Event and Trace Commands 
     269 
     270When running as an Earthworm module (see !RingInName) localmag will wait before processing a new event until traces have had time to propagate to the maxDist plus extraDelay seconds (which may be positive or negative.) The calculation of the maximum wait time is done at startup, assuming an event on the surface and a station at maxDist. When a new event message is received, localmag compares the origin time to the current (system) time. Localmag then sleeps until origin time is older than system time by the computed wait time. This will ensure that the waves localmag is aboutto request will have time to arrive at the station and thence at the wave_server. 
     271{{{ 
    264272Default:  0 seconds extra delay 
    265273Example:  extraDelay 10.0 
    266 getEventsFrom INST MOD   Earthworm Setup 
    267 Get event messages (TYPE_HYP2000ARC) from installation INST and module MOD. These installation and module IDs are found in earthworm.d and earthworm_global.d. Only one getEventsFrom command may be used; use the wildcard installation or module IDs if dewsired. This command is required if localmag is running as an earthworm module; see MyModId. 
     274}}} 
     275 
     276'''getEventsFrom [INST MOD]'''[[BR]] 
     277Function: Earthworm Setup 
     278 
     279Get event messages (TYPE_HYP2000ARC) from installation INST and module MOD. These installation and module IDs are found in earthworm.d and earthworm_global.d. Only one getEventsFrom command may be used; use the wildcard installation or module IDs if dewsired. This command is required if localmag is running as an earthworm module; see !MyModId. 
     280{{{ 
    268281Default:  none 
    269282Example:  getEventsFrom INST_WILDCARD MOD_EQPROC 
    270 HeartBeatInterval H      Earthworm Setup 
    271 Send TYPE_HEARTBEAT messages every H seconds to the transport ring. This command is required if localmag is running as an earthworm module; see MyModId. 
     283}}} 
     284 
     285'''!HeartBeatInterval [H]'''[[BR]] 
     286Function: Earthworm Setup 
     287 
     288Send TYPE_HEARTBEAT messages every H seconds to the transport ring. This command is required if localmag is running as an earthworm module; see !MyModId. 
     289{{{ 
    272290Default:  none 
    273291Example:  HeartbeatInterval 30 
    274 logA0 FILE      Auxilliary Data Sources 
     292}}} 
     293 
     294'''logA0 [FILE]'''[[BR]] 
     295Function: Auxilliary Data Sources 
     296 
    275297Specify the file containing the table of attenuation factors ( -log(A0) ) used in the local magnitude calculation. This file mist start with two commands: 
    276 Dist type: 
    277 Identify which distance is to used to access this table. Choices are: 
    278 epi: 
    279 station - epicenter distance 
    280 hypo: 
    281 station - hypocenter distance (uses event depth but not station depth.) 
    282 nDist N: 
    283 The number of table entries that follow is at most N. 
     298Dist type: Identify which distance is to used to access this table. Choices are: 
     299* epi: station - epicenter distance 
     300* hypo: station - hypocenter distance (uses event depth but not station depth.) 
     301* nDist N: The number of table entries that follow is at most N. 
     302 
    284303Following these two commands are up to N lines of distance and -logA0 values. The distance numbers must be integer values, in kilometers. The -logA0 values are positive decimal values. Entries MUST be in order of increasing distance. When this table is used to find the -logA0 value, the entry with distance nearest to the desired distance will be used. As of June 30, 2011, the attenuation relationship allows for vertical components to have a separate attenuation curve as an option with the allowVerticals configuration parameter. This is to allow those networks (like LCSN) who have computed attenuation on verticals to compute ML on vertical (Z) channels. The EasternUS.tab is provided with the release of localmag now as an example of 2 attenuation curves specified. If the desired distance exceeds the largest distance in this table, then the -logA0 value for the last table entry will be returned. The file Richter.tab provided with the localmag program contains the table established by Richter & Guttenberg for Southern California. Note that localmag will try to read the logA0 file from the current directory. Specify the appropriate path information if the file is located elsewhere. 
     304 
    285305David Boore reminds us: 
    286306 
    287307The proper procedure is first to determine the attenuation for the region, and second to constrain the curves at 100 km according to the formal definition of Ml. 
     308{{{ 
    288309Default:  none 
    289310Example:  logA0 Richter.tab 
    290  
     311}}} 
    291312 
    292313LogFile: -lS    Earthworm Setup