Changes between Initial Version and Version 1 of scn2scnl

03/19/12 17:00:19 (10 years ago)



  • scn2scnl

    v1 v1  
     3= [wiki:Earthworm Earthworm] Module: scn2scnl = 
     4'''Contributed by: Written by Will Kohler, modified by Pete Lombard to do SCN->SCNL lookups.''' 
     6== Function == 
     7SCN 2 SCNL converter for waveform packets (new in EW v7.0). scn2scnl is a module to convert TRACEBUF into TRACEBUF2 messages by tacking on a location code.  
     9== Details == 
     10scn2scnl and [wiki:scnl2scn 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.   
     12=== Example Configuration File === 
     15#                     Configuration file for scn2scnl 
     17MyModuleId     MOD_SCN2SCNL  # Module id for this instance of scn2scnl, 
     18InRing         WAVE_RING     # Where to find input messages, 
     19OutRing        WAVE_RING2    # Where to put output messages, 
     20                             #  InRing and OutRing may be the same ring. 
     21HeartbeatInt   15            # Heartbeat interval in secs 
     22                             #   if 0, send no heartbeats 
     24# List SCN's that are to be converted and the SCNL to which they are to be 
     25# renamed. Format is: 
     26# SCN  sta chan net   sta chan net loc 
     27# You can list SCN's explicitly or with wildcards. The only supported wildcard 
     28# for station and network names is "*"; no other characters should be included 
     29# in a station or network name if the wildcard is used. 
     30# For channel names, you can use "*" or two letters followed by `?', as in  
     31# "HH?". The `?' wildcard is supported only as the third character of the 
     32# channel name. 
     34# The output SCNL must be given explicitly if the input SCNl is given 
     35# explicitly. 
     36# If a wildcard is used in the input SCN, you can use wildcards in the output  
     37# SCNL except in the location code. In the output SCNL, the wildcard means 
     38# "use whatever was in the input S, C or N". 
     40# The explicit SCN's will be sorted with scn2scnl starts up so that a binary 
     41# search can be used to quickly find a match. 
     42# Incoming packets will be matched against this explicit list first.  
     43# Any packets that don't match an explicit SCN will then be matched against 
     44# the wildcarded SCNs in the order they appear in this file. 
     45# Any packets that do not match the wildcard list WILL NOT BE CONVERTED. 
     46# To ensure that all packets are converted, you should end the SCN list 
     47# with "SCN * * *  * * * --". This will assign the location code "--" to 
     48# any packets not otherwise matched. 
     49SCN  * * *  * * * -- 
     52== Helpful Hints ==