DATA RETRIEVAL SYSTEMS BREQ_FAST(5) NAME BREQ_FAST, breq_fast - Batch REQuests, FAST SYNOPSIS BREQ_FAST DESCRIPTION Batch access to the NCEDC broadband archive can be obtained by electronically mailing a specially formatted file to the Northern California Earthquake Data Center (NCEDC) at UC Berkeley. These are BREQ_FAST files and provide a base level access to the NCEDC needed by any user. These requests are not interactive in that you simply send the file to the NCEDC and the NCEDC will return all data match- ing the request. The BREQ_FAST file format was defined by the IRIS DMC. The only difference in the NCEDC implementation is that the NCEDC does not currently have the facilities to create tapes for automated data requests. Therefore, the available by FTP access only. FILE FORMAT The format of the file is as follows: .NAME .INST .MAIL .EMAIL .PHONE .FAX .LABEL .MEDIA: .ALTERNATE MEDIA: .ALTERNATE MEDIA: .END line 1 line 2 . . . line n The format of each line is as follows: STARTING TIME ENDING TIME STA NET YYYY MM DD HH MM SS.T YY MM DD HH MM SS.T #_CH CH1 CH2 CHn NCEDC Last change: May, 1992 1 DATA RETRIEVAL SYSTEMS BREQ_FAST(5) where STA is the station NN is the network code YYYY is the year of the start or end of the time window 1900 is added to a year less than 100. MM is the month DD is the day HH is the hour MM is the minute SS.T is the second and tenths of seconds #_CH is the number of channel designators in the immedi- ately following list CHn is a channel designator that can contain wildcards Individual lines in the request can not exceed 100 charac- ters. The .LABEL entry is used to identify the output SEED volume. In SEED version 2.3, it will be used in blockette 10 as the Volume Label. The NCEDC also will name output SEED volumes with this label. Valid selections for media at the present time, in the order of preference are: Electronic (FTP) FTP SAMPLE BREQ_FAST FILE An example of a valid short BREQ_FAST file .NAME Joe Seismologist .INST Podunk University .MAIL 101 Fast Lane, Middletown, KS 89432 .EMAIL joe@podunk.edu .PHONE 555 555-1212 .FAX 555 555-1213 .LABEL Joe's FIRST Request .MEDIA FTP .ALTERNATE MEDIA FTP .ALTERNATE MEDIA FTP .END ARC BK 1994 1 2 0 18 26.99 1994 1 2 0 20 26.99 1 HH? BKS BK 1994 1 2 0 18 10.48 1994 1 2 0 20 10.48 1 HHZ CMB BK 1994 1 2 0 18 25.40 1994 1 2 0 20 25.40 2 B?? HHZ MHC BK 1994 1 2 2 10 36.67 1994 1 2 2 12 36.67 1 HH? ORV BK 1994 1 2 2 10 37.12 1994 1 2 2 12 37.12 1 HH? SAO BK 1994 1 2 2 10 49.78 1994 1 2 2 12 49.78 3 BH? HHZ L?? STAN BK 1994 1 2 14 45 8.94 1994 1 2 14 47 8.94 1 HHZ NCEDC Last change: May, 1992 2 DATA RETRIEVAL SYSTEMS BREQ_FAST(5) WDC BK 1994 1 2 14 45 22.62 1994 1 2 14 47 22.62 1 HHZ WILDCARDING The Channel list in the batch file supports limited wild carding. It is similar to but not the equivalent of UNIX filename wild carding. Only the "?" wild card character is supported. It means match any single character. For insta nce "BH?" means match any Broad band High Gain Channel when entered into the Channel field. The Channel list can contain multiple entries such as 3 LHZ BH? S??. As an example a #_ch of 1 and a channel list of L?? (1 L??) would result in three characters in each of the channel names in the NCEDC archive being compared to L??. Since the "?" means match any character it should be clear that "L??" is the same as entering "L". The channel names are matched for the same number of characters as the number in the input channel designator field. The NCEDC archive stores data for channels using the SEED channel naming convention documented in the SEED Reference Manual, appendix A. Briefly the channel names are three characters in length. The first character is the Band Code, the second the Source code and the third the Orientation Code. Refer to the SEED reference manual for a more complete description of the SEED channel naming convention. The primary SEED channels that are used for broadband data at the NCEDC are listed in the table below. Data from 3- component instruments with non-standard orientation will have Orientation codes of 1, 2, and 3. SEED Channel Data Stream in samples-per-second _____________________________________________________________ HHZ, HHN, HHE 80 sps channels from Broadband instrument BHZ, BHN, BHE 20 sps channels from broadband instrument LHZ, LHN, LHE 1 sps channels from broadband instrument VHZ, LHN, LHE 1/10 channel sps from broadband instrument UHZ, LHN, LHE 1/100 channels sps from broadband instrument HLZ, LHN, LHE 80 sps channels from broadband instrument One of the major benefits of the BREQ_FAST method is that you can specify time windows for various stations that have travel time corrections applied to t he windows. NCEDC Last change: May, 1992 3 DATA RETRIEVAL SYSTEMS BREQ_FAST(5) SUBMITTING YOUR REQUESTS Once you have generated your BREQ_FAST file you can simply mail it via email to BREQ_FAST@quake.geo.berkeley.edu When the NCEDC receives your request, programs will be run that will compare what you requested with what data are actually in the NCEDC archive, recover the data from the mass storage system, generate the output SEED volume, and send you email informing you where and how to retrieve the data. NCEDC Last change: May, 1992 4