NCEDC EVENT WAVEFORM RETRIEVAL SYSTEM EVT_FAST(5) NAME EVT_FAST, evt_fast - EVenT waveform requests, FAST SYNOPSIS EVT_FAST DESCRIPTION EVT_FAST is a processing system at the NCEDC which receives email requests for (primarily NCSN) event waveforms archived at the NCEDC, and provides access to these waveforms for FTP retrieval over the Internet. An EVT_FAST request file is similar in concept to BREQ_FAST or NetDC request files, but instead of requesting data by network, station, channel, location, and time, you request data by the NCEDC event id. All waveforms at the NCEDC that are associated with the specified event will be made avail- able to you. You can request that the data is made avail- able on one of several standard formats: SEED, MSEED (Min- iSEED), SAC BINARY, SAC ASCII, or AH (XDR) format. The NCEDC does not currently have the facilities to create tapes for automated data requests. Therefore, the .MEDIA and .ALTERNATE MEDIA lines are ignored, and all EVT_FAST data will be made available via the Internet through FTP. FILE FORMAT The format of an EVT_FAST request file is as follows: .EVT_FAST_REQUEST .NAME Your Name .INST Your Institution .MAIL Your mailing address .EMAIL you@yourhost .PHONE yourphone# .FAX yourfaxnumber .LABEL name_for_output_file .MEDIA ftp .FORMAT_WAVEFORM SEED | MSEED | SACBINARY | SACASCII | AH .END .SEEDSNCL station.network.channel.location .SEEDNSCL network.station.channel.location .SEEDNSLC network.station.location.channel .EVENTID eventid1. . .EVENTID eventidN. The format of each line is as follows: NCEDC Last change: October 18, 2004 1 NCEDC EVENT WAVEFORM RETRIEVAL SYSTEM EVT_FAST(5) .EVT_FAST_REQUEST must be the first line of the request, and identifies this as an EVT_FAST data request. NAME _Y_o_u_r _N_a_m_e specifies your name. Your output will be filed under your name in the NCEDC anonymous FTP directory. .INST _Y_o_u_r _I_n_s_t_i_t_u_t_i_o_n specifies the name of your institution. .MAIL _Y_o_u_r _M_a_i_l_i_n_g _a_d_d_r_e_s_s specifies your postal mail address. .PHONE _y_o_u_r_p_h_o_n_e# specifies your phone number. .FAX _y_o_u_r_f_a_x# specifies your fax number. .LABEL name_for_output_file is the name that will be used for your output tar file. .MEDIA ftp specifies how your data will be delivered to you. The NCEDC only supports FTP (no tape). FORMAT_WAVEFORM SEED | MSEED | SACBINARY | SACASCCII | AH specifies which format in which you want want the waveform data. The default format is SEED. All other formats except for MSEED will be formed by creating a SEED volume and using RDSEED to extract the data in the specified format. MSEED (MiniSEED) data will be created directly. You must specify only one of the data formats. specify.B .END specifies that the header values are done, and that the remaining lines specify the events and optional channel selections. .SEEDSNCL _s_t_a_t_i_o_n._n_e_t_w_o_r_k._c_h_a_n_n_e_l._l_o_c_a_t_i_o_n .SEEDNSCL _n_e_t_w_o_r_k._s_t_a_t_i_o_n._c_h_a_n_n_e_l._l_o_c_a_t_i_o_n .SEEDNSLC _s_t_a_t_i_o_n._n_e_t_w_o_r_k._l_o_c_a_t_i_o_n._c_h_a_n_n_e_l are optional lines that allow you to select only a sub- set of the the data channel from the events. If you do not include any of these channel selection lines in your request, you will receive all of the data channels for the events. You may use as many of these lines as NCEDC Last change: October 18, 2004 2 NCEDC EVENT WAVEFORM RETRIEVAL SYSTEM EVT_FAST(5) necessary to specify the channels you want. Each of the above lines differs only in the order in which you specify the network, station, channel, and location. An empty location code should be specified as the empty string, eg: .SEEDSNCL KBO.NC.HHE. .SEEDNSLC NC.KBO..HHE both specify channel HHE with an empty location code from the NC station KBO. You may use Unix wildcard characters in any of the network, station, channel, or location components. * matches 0 or more characters ? matches exactly 1 character The channel selection commands must appear AFTER the .END line, and apply to ALL events in the request. .EVENT _e_v_e_n_t_i_d__1 specifies the eventid of the event for which you want waveform data. Each .EVENT line may have only one eventid, but you may specify as many .EVENT lines as you want. SAMPLE EVT_FAST FILE An example of a valid short EVT_FAST file .EVT_FAST_REQUEST .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 My First Request .FORMAT_WAVEFORM SACBINARY .MEDIA FTP .END .SEEDSNCL *.*.HH?. .SEEDSNCL *.*.EH?. .EVENTID 21200813 .EVENTID 21200815 SUBMITTING YOUR REQUESTS Once you have generated your EVT_FAST file you can simply mail it via email to EVT_FAST@quake.geo.berkeley.edu When the NCEDC receives your request, it will extract the specified data channels from the specified events, collect the data into a gzipped tar file, place the file in an appropriate anonymous FTP directory, and send you email NCEDC Last change: October 18, 2004 3 NCEDC EVENT WAVEFORM RETRIEVAL SYSTEM EVT_FAST(5) informing you where and how to retrieve the data. NOTES 1. The only format that is guaranteed to provide ALL of the channels for an event is MSEED format. All other formats require the creation of a SEED volume, and therefore require (at least some type of) SEED response. We currently do not have SEED responses for all of the stations from the CI, WR, and NN networks recorded by the NCSN. 2. Since the SAC and AH formats are derived from a SEED volume, they should have the station coordinates from the NCEDC in the headers. 3. The file created by the NCEDC with your data will be a gzipped tar file, containing a separate directory for each specified event. To unpack the file, you need the gzip and tar programs, which can be found at the web site http://www.gnu.org NCEDC Last change: October 18, 2004 4