'\" t
.TH EVT_FAST 5 "October 18, 2004" "NCEDC" "NCEDC EVENT WAVEFORM RETRIEVAL SYSTEM"
.\"
.\" To properly format this file, you must use the -man troff macros and tbl
.\"
.SH NAME
EVT_FAST, evt_fast  - EVenT waveform requests, FAST
.SH SYNOPSIS
.B EVT_FAST
.SH DESCRIPTION
.LP
 
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 available to you.
You can request that the data is made available on one of several standard
formats:  SEED, MSEED (MiniSEED), 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.

.SH FILE FORMAT
.LP
 
The format of an EVT_FAST request file is as follows:
 
.TS
center tab (\);
l.

 .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.
.TE
 
The format of each line is as follows:

.TP 
.B .EVT_FAST_REQUEST
.br
must be the first line of the request, and identifies this as an EVT_FAST data request.
.TP
.B NAME \fIYour Name\fR
.br
specifies your name.  Your output will be filed under your name in the NCEDC
anonymous FTP directory.
.TP
.B .INST \fIYour Institution\fR
.br
specifies the name of your institution.
.TP
.B .MAIL \fIYour Mailing address\fR
.br
specifies your postal mail address.
.TP
.B .PHONE \fIyourphone#\fR
.br
specifies your phone number.
.TP
.B .FAX \fIyourfax#\fR
.br
specifies your fax number.
.TP
.B .LABEL name_for_output_file
.br
is the name that will be used for your output tar file.
.TP
.B .MEDIA ftp
.br
specifies how your data will be delivered to you.
The NCEDC only supports FTP (no tape).
.TP
.B FORMAT_WAVEFORM 
SEED | MSEED | SACBINARY | SACASCCII | AH
.br
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.
.TP
 specify.B .END
.br
specifies that the header values are done, and that the
remaining lines specify the events and optional channel
selections.
.TP
.B .SEEDSNCL \fIstation.network.channel.location
.TP
.B .SEEDNSCL \fInetwork.station.channel.location
.TP
.B .SEEDNSLC \fIstation.network.location.channel
.br
are optional lines that allow you to select only a subset
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 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:
.nf
.in +.5in
 .SEEDSNCL KBO.NC.HHE.
 .SEEDNSLC NC.KBO..HHE
.in -.5in
both specify channel HHE with an empty location code
from the NC station KBO.
.p
You may use Unix wildcard characters in any of the
network, station, channel, or location components.
.nf
.in +.5in
* matches 0 or more characters
? matches exactly 1 character
.in -.5in
.ad
The channel selection commands must appear AFTER the .END line,
and apply to ALL events in the request.
.TP
.B .EVENT \fIeventid_1\fR
.br
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.

.SH SAMPLE EVT_FAST FILE
.LP
An example of a valid short EVT_FAST file 

.TS  
center tab (\);  
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s 
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
l s s s s s s s s s s s s s s s s
c c c c c c c c c c c c c c c c c .
 .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
.TE
 
.SH SUBMITTING YOUR REQUESTS
.LP

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 informing you where and how to retrieve the data.

.SH NOTES
.LP

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.
.P
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.
.P
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