Changes between Initial Version and Version 1 of Year_2000_Compliant_Earthworm_Message_Formats


Ignore:
Timestamp:
01/19/12 16:16:20 (8 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Year_2000_Compliant_Earthworm_Message_Formats

    v1 v1  
     1Earthworm Year2000 Compliant Message Formats 
     2 
     3Updated February 7, 2001 
     4 
     5Lynn Dietz and Barbara Bogaert 
     6 
     7The following table lists Y2K-compliant message types (4-digit years) that are used in Earthworm v4.0 and higher. 
     8 
     9      Y2K-compliant  
     10      (v4.0 and higher) 
     11      -----------------   
     121.    TYPE_PICK2K 
     132.    TYPE_CODA2K 
     143.    TYPE_QUAKE2K 
     154.    TYPE_EVENT2K 
     165.    TYPE_H71SUM2K 
     176.    TYPE_HYP2000ARC (barely filled in) 
     18      TYPE_HYP2000ARC (completely filled in) 
     197.    TYPE_TRIGLIST2K 
     20 
     21*TYPE_CODA did not include any date information, but since we're changing 
     22formats, we added station code to the coda message to make it  
     23simpler to export codas along with their picks via export_scn. 
     24 
     25++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     261.  TYPE_PICK2K 
     27 
     28This message type is created by pick_ew and read by binder, eqproc, eqprelim, 
     29export_scn.   The new TYPE_PICK2K message 
     30is a fixed 72 characters long (including a newline, but excluding a  
     31null-terminator). 
     32 
     33Y2K-compliant TYPE_PICK2K: 
     34 
     35 10  4  3 2133 CMN  NCVHZ U1  19950831183134.90     953    1113     968\n 
     36 
     370123456789 123456789 123456789 123456789 123456789 123456789 123456789 12345 
     38 
     39 1st        variable 
     40 col.  len  type           description 
     41-----  ---  -------------  ---------------------------------------------- 
     42  0     3   unsigned char  Message type (1-255) 
     43  3     3   unsigned char  Module id that produced this message (1-255) 
     44  6     3   unsigned char  Installation of origin for this message (1-255) 
     45  9     1                  unused 
     46 10     4   short          Sequence # assigned by picker (0-9999), 
     47                           allows you to match a pick with its coda info. 
     48 14     1                  unused 
     49 15     5   char[]         Site code (left justified) 
     50 20     2   char[]         Network code (left justified) 
     51 22     3   char[]         Component code (left justified) 
     52 25     1                  unused  
     53 26     1   char           Polarity of first break 
     54 27     1   char           Quality of pick assigned by picker (0-4)  
     55                           with 0 being best. 
     56 28     2                  unused (space for phase, P, Pg, S...?) 
     57 30    17   char[]         Arrival time in the form of: 
     58                              ccyymmddhhmmss.ff  
     59 47     8   long           Amplitude of 1st peak after arrival time 
     60 55     8   long             "       "  2nd peak  "     "        " 
     61 63     8   long             "       "  3rd peak  "     "        " 
     62 71     1   char           newline character 
     63 
     64 
     65++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     662.  TYPE_CODA2K 
     67 
     68This message type is created by pick_ew and read by eqproc, eqprelim. 
     69TYPE_CODA2 did not include any date information and thus is Y2K-compliant as  
     70it was. However, since we're changing formats, we added station code 
     71to the coda message to make it simpler to export codas along with their  
     72picks via export_scn.  The TYPE_CODA2K message is a fixed format,  
     7379 characters long (including a newline character, but excluding a  
     74null-terminator). 
     75 
     76 
     77TYPE_CODA2K message: 
     78 
     79 11  4  3 2165 CMN  NCVHZ      23     201     276     289       0       0   7 \n 
     80 
     810123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 
     82 
     83 1st        variable 
     84 col.  len  type           description 
     85-----  ---  -------------  ---------------------------------------------- 
     86  0     3   unsigned char  Message type (1-255) 
     87  3     3   unsigned char  Module id that produced this message (1-255) 
     88  6     3   unsigned char  Installation of origin for this message (1-255) 
     89  9     1                  unused 
     90 10     4   short          Sequence # assigned by picker (0-9999), 
     91                           allows you to match a pick with its coda info. 
     92 14     1                  unused 
     93 15     5   char[]         Site code (left justified) 
     94 20     2   char[]         Network code (left justified) 
     95 22     3   char[]         Component code (left justified) 
     96 25     8   long           Coda window 1 average absolute amplitude 
     97 33     8   long             "    "    2    "       "         "    
     98 41     8   long             "    "    3    "       "         "    
     99 49     8   long             "    "    4    "       "         "    
     100 57     8   long             "    "    5    "       "         "    
     101 65     8   long             "    "    6    "       "         "    
     102 73     4   short          Coda duration (seconds) 
     103 77     1   char           Coda weight (quality) 
     104 78     1   char           newline character 
     105 
     106 
     107++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     1083. TYPE_QUAKE2K 
     109 
     110This message type is created by binder_ew, and read by eqproc, eqprelim.  
     111It's a space-delimited format.  The  TYPE_QUAKE2K message is space-delimited and 
     112variable length. 
     113 
     114Y2K-compliant TYPE_QUAKE2K: 
     115 
     116  3 10 51056672 19960516112157.06  37.6249 -118.8623   9.52  0.08   2.0   9.7 130 10\n 
     117 
     1180123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123 
     119 
     120       max  variable 
     121field  len  type           description 
     122-----  ---  -------------  ----------------------------------------------- 
     123  1     3   unsigned char  Installation of origin for this message (1-255) 
     124  2     3   unsigned char  Module id that produced this message (1-255) 
     125  3         long           Event id assigned by binder_ew 
     126  4    17   char[]         Event origin time in the form of: 
     127                             ccyymmddhhmmss.ff  
     128  5     8   float          Latitude (decimal degrees) 
     129  6     9   float          Longitude (decimal degrees) 
     130  7         float          Depth (km) 
     131  8         float          RMS traveltime residual 
     132  9         float          Distance of nearest station (km) 
     133 10         float          Average epicentral distance of associated  
     134                           arrivals (otherwise known as ravg) 
     135 11         int            Maximum azimuthal gap 
     136 12         int            Number of associated phases; 
     137                           followed by a newline character 
     138 
     139 
     140++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     1414. TYPE_EVENT2K 
     142 
     143This message type is created by eqproc, eqprelim and read by eqcoda.  
     144This message is internal to the "sausage" mega-module; it is piped between 
     145eqproc or eqprelim and eqcoda and never ends up on a public transport ring. 
     146 
     147The TYPE_EVENT2K message is a fixed-format message,  
     148the hypocenter line is 96 characters long and  
     149each phase line is 111 characters long. 
     150 
     151Y2K-compliant TYPE_EVENT2K, hypocenter & phase line: 
     152 
     15319950828 1212 13.57 37 34.47 118 50.12   6.42        12  80  2.0 0.25                   53821 1\n 
     154CMN  NCVHZ U1P 19950831183134.90     953    1113     968      23     201     276     289       0       0   7 W\n 
     1550123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 12 
     156 
     157Hypocenter line format: 
     158  see section 5.  TYPE_H71SUM2K. 
     159 
     160Phase line format: 
     161 
     162 1st        variable 
     163 col.  len  type           description 
     164-----  ---  -------------  ---------------------------------------------- 
     165  0     5   char[]         Site code (left justified) 
     166  5     2   char[]         Network code (left justified) 
     167  7     3   char[]         Component code (left justified) 
     168 10     1                  unused 
     169 11     1   char           Polarity of arrival (U, D, ' ') 
     170 12     1   char           Quality of pick assigned by picker (0-4) 
     171 13     2   char[]         Phase assigned to arrival by binder 
     172                             (P, Pn, Pg, S, Sn, Sg) 
     173 15    17   char[]         Arrival time in the form of: 
     174                             ccyymmddhhmmss.ff 
     175 32     8   long           Amplitude of 1st peak after arrival time 
     176 40     8   long               "     "  2nd  "     "     "      " 
     177 48     8   long               "     "  3rd  "     "     "      " 
     178 56     8   long           Coda window 1 average absolute amplitude 
     179 64     8   long             "    "    2    "       "         "  
     180 72     8   long             "    "    3    "       "         "  
     181 80     8   long             "    "    4    "       "         "  
     182 88     8   long             "    "    5    "       "         "  
     183 96     8   long             "    "    6    "       "         "  
     184104     4   int            Coda duration (seconds) 
     185108     1   char           Coda weight 
     186109     1   char           Data source of pick (W=earthworm) 
     187110     2   char           newline character  
     188 
     189 
     190++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     1915. TYPE_H71SUM2K 
     192 
     193This message type is created by hypo_mgr, and is read by eqalarm_ew, cubic_msg, 
     194and menlo_report.  
     195 
     196The TYPE_H71SUM2K message is fixed-format, 96 characters. 
     197 
     198Y2K-compliant TYPE_H71SUM2K: 
     199 
     20019960508 2005 44.83 38 47.53 122 45.28   2.56 D 0.86 30  43  4.  0.07  0.2  0.5 AW   51056678 1\n 
     2010123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 123456789 12345 
     202 
     203 1st        variable 
     204 col.  len  type           description 
     205-----  ---  -------------  ---------------------------------------------- 
     206  0     4   int   %4d      Origin time: year 
     207  4     2   int   %2d      Origin time: month (1-12) 
     208  6     2   int   %2d      Origin time: day of month (1-31) 
     209  8     1                  unused 
     210  9     2   int   %2d      Origin time: hour of day (0-23) 
     211 11     2   int   %2d      Origin time: minute (0-59) 
     212 13     6   float %6.2f    Origin time: seconds  
     213 19     3   int   %3d      Latitude: degrees 
     214 22     1   char  %c       S for south, blank otherwise 
     215 23     5   float %5.2f    Latitude: decimal minutes 
     216 28     4   int   %4d      Longitude: degrees 
     217 32     1   char  %c       E for east, blank otherwise 
     218 33     5   float %5.2f    Longitude: decimal minutes 
     219 38     7   float %7.2f    Depth (km). 
     220 45     1                  unused 
     221 46     1   char  %c       Magnitude type code 
     222                             D=duration, Z=low-gain duration 
     223 47     5   float %5.2f    Magnitude 
     224 52     3   int   %3d      Number of P & S times with weights greater than 0.1. 
     225 55     4   int   %4d      Maximum azimuthal gap. 
     226 59     5   float %5.1f    Distance to nearest station (km). 
     227 64     5   float %5.2f    RMS travel time residual. 
     228 69     5   float %5.1f    Horizontal error (km). 
     229 74     5   float %5.1f    Vertical error (km). 
     230 79     1   char  %c       Remark: Q if Quarry blast. 
     231 80     1   char  %c       Remark: Quality flag A-D. 
     232 81     1   char  %c       Remark: Data source code.  
     233 82     1                  unused 
     234 83    10   long  %10ld    Event identification number 
     235 93     1                  unused 
     236 94     1   char  %c       Version number of information: 
     237                             0=Preliminary EW; 1=Final EW with MD; 
     238                             2=ML added, etc. 0-9, then A-Z. 
     239 95     1   char  %c       newline character 
     240 
     241 
     242++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     2436.  TYPE_HYP2000ARC (barely filled in) 
     244    TYPE_HYP2000ARC (completely filled in) 
     245 
     246The TYPE_HYP2000ARC messages is output by eqcoda,   
     247read and output by eqverify, hyp2000_mgr (hyp2000), and read by menlo_report,  
     248rsec*, arc2trig, earlybird. 
     249 
     250A TYPE_HYP2000ARC message is a fixed-format message and is built of 6  
     251different types of lines in the following sequence: 
     252 
     253  hypocenter         (1. Summary Header Format) 
     254  hypocenter shadow  (2. Summary Shadow Format) 
     255  phase 1            (3. Station Archive Format Year 2000) 
     256  phase shadow 1     (4. Station Shadow Format, RTP portion) 
     257  ... 
     258  phase N  
     259  phase shadow N 
     260  terminator line    (5. Event Terminator Format) 
     261  terminator shadow  (6. Event Terminator Shadow) 
     262 
     263For Hyp2000, the "Summary Header Format" and "Station Archive Format" in the 
     264archive message have changed.  All other lines in the TYPE_HYP2000ARC message  
     265have the same format as the original TYPE_HINVARC message.  A complete  
     266description of the new Hyp2000 formats can be found in Fred Klein's Hypoinverse Manual. 
     267 
     268Sample Y2K-compliant TYPE_HYP2000ARC message (as output by eqcoda): 
     269 
     270199912312359492936 2810120 2596  851    27 78 19  15                                                                                         10154                1 \n 
     271$1                                                                                            \n 
     272PWM  NC  VHZ  PD0199912312359 5341                                                0      77                 W  \n 
     273$   6 5.49 1.80 7.91 3.30 0.10 PSN0   77 PHP3 1853 39 340 47 245 55 230 63  86 71  70 77  48           \n 
     274PHB  NC  VHZ  PU0199912312359 5672                                                0     103                 W  \n 
     275$   6 5.37 1.80 6.76 2.53 0.12 PSN0  103 PHP2 1098 63 203 71  75 79  90 87  99 95  54103  46           \n 
     276PKE  NC  VHZ  PU0199912312359 5903                                                0      69                 W  \n 
     277$   6 5.34 1.80 5.97 2.24 0.11 PSN0   69 PHP0  644 31 430 39 221 47 212 55 120 63  88 69  37           \n 
     278PHP  NC  VHZ  PU0199912312359 5941                                                0      61                 W  \n 
     279$   6 5.01 1.80 5.92 2.38 0.08 PSN0   61 PHP0  384 23 294 31 235 39 139 47  95 55  60 61  41           \n 
     280PPC  NC  VHZ  PU0199912312359 5981                                                0      41                 W  \n 
     281$   6 4.71 1.80 4.54 1.68 0.09 PSN0   41 PHP0  356 15 305 19 306 23 180 31 109 39  79 41  49           \n 
     282PMM  NC  VHZ  PU2200001010000 0000                                                0      47                 W  \n 
     283$   6 4.81 1.80 5.44 2.26 0.06 PSN0   47 PHP0   67 15 382 19 364 23 231 31 114 39  71 47  46           \n 
     284PHF  NC  VHZ  P 2200001010000 0103                                                0      45                 W  \n 
     285$   6 4.78 1.80 4.79 1.83 0.08 PSN0   45 PHP2 1093 15 427 19 190 23 202 31 125 39  74 45  47           \n 
     286PHO  NC  VHZ  PU0200001010000 0134                                                0      59                 W  \n 
     287$   6 5.05 1.80 6.17 2.51 0.05 PSN0   59 PHP1  632 23 564 31 232 39 154 47 108 55  63 59  47           \n 
     288PPG  NC  VHZ  PU0200001010000 0312                                                0      77                 W  \n 
     289$   6 5.31 1.80 5.84 2.16 0.10 PSN0   77 PHP0  382 39 251 47 144 55 149 63  89 71  80 77  38           \n 
     290POP  NC  VHZ  PD0200001010000 0377                                                0      25                 W  \n 
     291$   5 4.25 1.80 4.83 2.25 0.05 PSN0   25 PHP0  377 11  82 13 209 15 157 19  89 23  75 25  47           \n 
     292                                                                   10154\n 
     293$                                                                  10154\n 
     294 
     295 
     296Sample Y2K-compliant TYPE_HYP2000ARC message (as output by hyp2000): 
     297 
     298199204290117039536 2577120 2407  475  0 18 98 17  16 5975 128175 6  58343COA  38    0  57 124 21   0 218  0  8COA WW D 24X   0  0L  0  0     10123D343 218Z  0   0  \n 
     299$1                                                                                0343   0   0\n 
     300PWM  NC VVHZ  PD0199204290117  877  -8136    0   0   0      0 0  0  61   0 169 8400  0   77 88325  0 932   0WD \n 
     301$   6 5.49 1.80 7.91 3.30 0.10 PSN0   77 PHP3 1853 39 340 47 245 55 230 63  86 71  70 77  48           \n 
     302PHB  NC VVHZ  PU4199204290117 1208 -31  0    0   0   0      0 0  0  56   0 348 6300  0  103125355  0   0   0WD \n 
     303$   6 5.37 1.80 6.76 2.53 0.12 PSN0  103 PHP2 1098 63 203 71  75 79  90 87  99 95  54103  46           \n 
     304PKE  NC VVHZ  PU0199204290117 1439  11136    0   0   0      0 0  0  -1   0 486 5200  0   69147348  0 175   0WD \n 
     305$   6 5.34 1.80 5.97 2.24 0.11 PSN0   69 PHP0  644 31 430 39 221 47 212 55 120 63  88 69  37           \n 
     306PHP  NC VVHZ  PU0199204290117 1477  -4136    0   0   0      0 0  0 -22   0 531 4900  0   61201348  0 217   0WD \n 
     307$   6 5.01 1.80 5.92 2.38 0.08 PSN0   61 PHP0  384 23 294 31 235 39 139 47  95 55  60 61  41           \n 
     308PMM  NC VVHZ  PU2199204290117 1536  20 27    0   0   0      0 0  0  11   0 532 4900  0   47190339  0   7   0WD \n 
     309$   6 4.81 1.80 5.44 2.26 0.06 PSN0   47 PHP0   67 15 382 19 364 23 231 31 114 39  71 47  46           \n 
     310PPC  NC VVHZ  PU0199204290117 1517   3136    0   0   0      0 0  0 -36   0 560 4900  0   41199325  0 204   0WD \n 
     311$   6 4.71 1.80 4.54 1.68 0.09 PSN0   41 PHP0  356 15 305 19 306 23 180 31 109 39  79 41  49           \n 
     312PHF  NC VVHZ  P 2199204290117 1639  23 27    0   0   0      0 0  0 -10   0 608 4800  0   45181350  0   6   0WD \n 
     313$   6 4.78 1.80 4.79 1.83 0.08 PSN0   45 PHP2 1093 15 427 19 190 23 202 31 125 39  74 45  47           \n 
     314PHO  NC VVHZ  PU0199204290117 1670  24136    0   0   0      0 0  0 -13   0 628 4800  0   59187324  0 185   0WD \n 
     315$   6 5.05 1.80 6.17 2.51 0.05 PSN0   59 PHP1  632 23 564 31 232 39 154 47 108 55  63 59  47           \n 
     316PPG  NC VVHZ  PU0199204290117 1848  -4136    0   0   0      0 0  0   7   0 745 4800  0   77147343  0 160   0WD \n 
     317$   6 5.31 1.80 5.84 2.16 0.10 PSN0   77 PHP0  382 39 251 47 144 55 149 63  89 71  80 77  38           \n 
     318POP  NC VVHZ  PD0199204290117 1913  -5136    0   0   0      0 0  0 -19   0 803 4800  0   25162281  0 155   0WD \n 
     319$   5 4.25 1.80 4.83 2.25 0.05 PSN0   25 PHP0  377 11  82 13 209 15 157 19  89 23  75 25  47           \n 
     320                                                                   10123\n 
     321$                                                                  10123\n 
     322 
     323 
     324++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     3257.  TYPE_TRIGLIST2K 
     326 
     327This message type is created by trg_assoc, carlsubtrig, arc2trig, and is  
     328read  by surf.exe (WaveViewer), trig2disk, ora_trace_save, and maybe some  
     329others. TYPE_TRIGLIST2K is a space-delimited message, where the time fields  
     330have a fixed format.  It is composed of an event header line, 3 silly  
     331comment lines, and any number of individual station trigger lines.  
     332Here's an example: 
     333 
     334Y2K-compliant TYPE_TRIGLIST2K: 
     335 
     336EVENT DETECTED   19960508 20:05:44.83 UTC EVENT ID: 51056678 AUTHOR: 017024003:024045003\n 
     337\n 
     338Sta/Cmp/Net   Date   Time                       start save       duration in sec.\n 
     339-----------   ------ ---------------    ------------------------------------------\n 
     340 GCR VHZ NC P 19960508 20:05:45.58 UTC    save: 19960508 20:05:40.58       17\n 
     341 GDX VHZ NC P 19960508 20:05:45.56 UTC    save: 19960508 20:05:40.56       17\n 
     342 GBG VHZ NC P 19960508 20:05:46.45 UTC    save: 19960508 20:05:41.45       17\n 
     343 GPM VHZ NC P 19960508 20:05:48.34 UTC    save: 19960508 20:05:43.34       17\n 
     344 
     345Event head line format: 
     346 
     347       max  variable 
     348field  len  type           description 
     349-----  ---  -------------  ----------------------------------------------- 
     350 1,2   15   char[]         Keywords:  "EVENT DETECTED" 
     351 3      8   char[]         Date of event in the form of:  yyyymmdd 
     352 4     11   char[]         Time of event in the form of:  hh:mm:ss.ff    
     353 5      3   char[]         Time zone label 
     354 6,7    9   char[]         Keywords:  "EVENT ID:" 
     355 8          long           Event id, assigned by author of the event 
     356 9      7   char[]         Keyword:   "AUTHOR:" 
     357 10         char[]         String describing author of the event; 
     358                           may be a series authors, seperated by colons. 
     359                           An author might be a user's login name or 
     360                           a 9-digit ascii logo: 
     361                             tttmmmiii, where ttt = message type 
     362                                              mmm = module id 
     363                                              iii = installation id 
     364 
     365Format of Silly Comment lines 1-3:  
     366 
     367The comment lines can be printed with the following strings: 
     368"\n" 
     369" Sta/Cmp/Net   Date   Time                       start save       duration in sec.\n" 
     370" -----------   ------ ---------------    ------------------------------------------\n" 
     371 
     372Station Trigger Line Format: 
     373 
     374       max  variable 
     375field  len  type           description 
     376-----  ---  -------------  ----------------------------------------------- 
     377 1      5   char[]         Station site code 
     378 2      3   char[]         Station component code 
     379 3      2   char[]         Station network code 
     380 4      1   char           Description of the type of trigger 
     381 5      8   char[]         Date of trigger in the form of:  yyyymmdd 
     382 6     11   char[]         Time of trigger in the form of:  hh:mm:ss.ff    
     383 7      3   char[]         Time zone label 
     384 8      5   char[]         Keyword:  "save:"   
     385                             Denotes that the on-time and duration of 
     386                             an "interesting seismogram" will follow. 
     387 9      8   char[]         On-date of "interesting seismogram" in the 
     388                             form:  yyyymmdd 
     389 10    11   char[]         On-time of "interesting seismogram" in the 
     390                             form:  hh:mm:ss.ff    
     391 11         int            Duration (seconds) of "interesting seismogram" 
     392 
     393++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 
     394 
     395The End