Changes between Initial Version and Version 1 of scnl2scn

03/19/12 17:02:41 (10 years ago)



  • scnl2scn

    v1 v1  
     3= [wiki:Earthworm Earthworm] Module: scnl2scn = 
     4'''Contributed by: Written by Will Kohler, modified by Pete Lombard to do SCN->SCNL lookups.''' 
     6== Function == 
     7SCNL 2 SCN converter for waveform packets (new in EW v7.0). scnl2scn is a module to convert TRACEBUF2 into TRACEBUF messages by removing the location code.  
     9== Details == 
     10[wiki:scn2scnl scn2scnl] and scnl2scn are a pair of conversion modules (code resides in data_exchange/scn_convert) to change trace data, picks and codas from the original Earthworm formats with site, component, network codes to the new Earthworm formats using site, component, network, location codes and visa versa.   
     12BE VERY CAREFUL with this module as this could cause DUPLICATE WAVEFORM messages if 2 components have the same channel name but different location codes. 
     14=== Example Configuration File === 
     17#                     Configuration file for scnl2scn 
     19MyModuleId     MOD_SCNL2SCN  # Module id for this instance of scnl2scn, 
     20InRing         WAVE_RING     # Where to find input messages, 
     21OutRing        WAVE_RING2    # Where to put output messages, 
     22                             #  InRing and OutRing may be the same ring. 
     23HeartbeatInt   15            # Heartbeat interval in secs 
     24                             #   if 0, send no heartbeats 
     25Debug                        # Optional command, no parameters 
     27                             # logs every SCNL is sees! 
     28# List SCNL's that are to be converted and the SCN to which they are to be 
     29# renamed. Format is: 
     30# SCNL  sta chan net loc   sta chan net 
     31# You can list SCNL's explicitly or with wildcards. The only supported wildcard 
     32# for station and network names is "*"; no other characters should be included 
     33# in a station, network or location name if the wildcard is used. 
     34# For channel names, you can use "*" or two letters followed by `?', as in  
     35# "HH?". The `?' wildcard is supported only as the third character of the 
     36# channel name. 
     38# The output SCN must be given explicitly if the input SCNL is given 
     39# explicitly. 
     40# If a wildcard is used in the input SCNL, you can use wildcards in the output. 
     41# In the output SCN, the wildcard means "use whatever was in the  
     42# input S, C or N". 
     44# The explicit SCNL's will be sorted with scnl2scn starts up so that a binary 
     45# search can be used to quickly find a match. 
     46# Incoming packets will be matched against this explicit list first.  
     47# Any packets that don't match an explicit SCNL will then be matched against 
     48# the wildcarded SCNLs in the order they appear in this file. 
     49# Any packets that do not match the wildcard list WILL NOT BE CONVERTED. 
     50# To ensure that all packets are converted, you could end the SCNL list 
     51# with "SCNL * * * *  * * *". This will simply delete the location code from 
     52# any packets not otherwise matched. 
     53# Be careful with this, however. It may cause multiple SCNLs to be converted 
     54# into a single SCN, producing utter garbage! 
     55SCNL  * * * *  * * * 
     58== Helpful Hints ==