Seismogram Transfer Program (STP)
STP is a client-side program for retrieving triggered and continuous waveform and phase data from the Southern California Earthquake Data Center. This program can be run using the Web-based graphical interface. For more extensive documentation on STP, the STP User Manual (Version 1.01) is now available.
Waveforms retrieved via the Web-based version of STP can be downloaded from the Data Center's anonymous FTP site, either using the graphical interface itself, or by manually running FTP and retrieving the data from: pub/stpdata/username on scedc.caltech.edu
STP can also be run as a stand-alone program on the user's local computer. A tar file of the stand-alone version can be retrieved via FTP from: pub/programs/stp on scec.gps.caltech.edu, or downloaded here.
Users running the stand-alone version of the software can retrieve the waveforms directly to their local machines.
STP can access waveform and phase data from 1932 through the present (1978-80 is currently unavailable).
Through popup menus, the STP Web site can be used to search for and select up to 100 events based on origin time, magnitude, location, depth, and/or type; to choose individual stations or entire networks; and to select channel(s). Repeat users may wish to store a user profile to retain a set of default stations or channels from which to retrieve data in future.
For more documentation, go to the: FAQ or click the HELP button.
After downloading the STP tar file from the Web site or retrieving it using FTP, extract the tar archive by running tar -xvf stp.tar,then compile the STP program by running make stp. STP currently compiles under Solaris and Linux. Execute stp to start the program. You can then enter HELP at the prompt for a list of commands. Enter HELP TOPIC for documentation pertaining to topic. NOTE: stp is not case-sensitive.
STP: Connected to stp.gps.caltech.edu
You are running the latest version of stp.
* Welcome to the Southern California *
* Earthquake Data Center *
* Seismic Transfer Program *
STP> Seismic Transfer Program
Command and Help Summary
NEWS - latest news on STP
WIN - get time window of data
WIND - get time window of data, searchable by location code
TRIG - get data for triggered event
STA - station info
CHAN - channel info
META - get station metadata
EVENT - event search
ALTLOC - event search for alternative catalogs
PHASE - obtain phase pick information
SAC - output in SAC format MSEED - output in MSEED format
SEED - output in SEED format
FLT32 - output in FLT32 (32-bit IEEE float) format
INT32 - output in INT32 (32-bit integer) format
ASCII - output in ASCII format
COSMOS - output V0/V1 COSMOS formats (commands V0 and V1)
XML - output phase and event in XML 24 -- return -->
NORM - output phase and event normally (onscreen)
GAIN - yes/no correction for station gain SWAP - data byte order
TTMODE - yes/no correction for header start time
DATE - summary of how to specify dates and times
INPUT - redirect source of commands to a file
OUTPUT - make a shadow copy of the session in a file STATUS - status of the client and server
VERBOSE - describe in detail the transactions
UPGRADE - download the latest version of the STP program BUGS - list of known bugs with STP
AVAIL - list data streams that are available at a particular time
EAVAIL - list data streams that are available for a particular event
SET - set some default parameters in STP
where topic is one of the entries above
UNIX shell escape:
Any line starting with '!' will be executed as a UNIX
STP> !ls (list the current directory)
- LIST LOCAL EVENTS OCCURRING IN SEPTEMBER 2002 THAT HAVE MAGNITUDES
BETWEEN 4.5 AND 5.0:
STP> event -t0 2002/09/01 2002/09/30 -mag 4.5 5.0 -type le 9818433 le 2002/09/03,07:08:51.870 33.9173 -117.7758 12.92 4.75 l 1.0 # Number of events= 1
- LIST TELESEISMS RECORDED IN THE PAST 36 HOURS:
STP> event -t0 -36h +36h -type ts 9819309 ts 2002/09/04,14:34:19.000 -0.8000 147.8000 33.00 5.90 b 0.0 # Number of events= 1
- LIST CATALOG INFORMATION FOR EVENT 9818433:
STP> event -e 9818433 9818433 le 2002/09/03,07:08:51.870 33.9173 -117.7758 12.92 4.75 l 1.0 # Number of events= 1
- LIST AVAILABLE SEISMOGRAMS FOR EVENT 9818433, STATION PAS, BH CHANNELS:
STP> eavail -l -sta PAS -chan BH_ 9818433 CI PAS BHE T T 2002/09/03,07:08:20.698 5.62m CI PAS BHN T T 2002/09/03,07:08:24.998 5.61m CI PAS BHZ T T 2002/09/03,07:08:35.048 5.57m # Number of seismograms= 3
- LIST ALL PHASE DATA FOR 9818433:
STP> phase -e 9818433
9818433 le 2002/09/03,07:08:51.870 33.9173 -117.7758 12.92 4.75 l 1.0
CI SRN HHZ 33.8284 -117.7894 181.0 P d. i 1.0 9.96 2.211
CI CHN HHZ 33.9988 -117.6804 178.0 P c. i 1.0 12.62 2.879
CI CHN HHN 33.9988 -117.6804 178.0 S i 0.8 12.62 5.593 [etc.]
By default, a maximum of 100 events are listed. To change this, enter SET NEVNTMAX nnnn, where nnnn is the new limit.
- OUTPUT ALL PHASE DATA FOR 9818433 TO FILE "phase.1":
STP> phase -f phase.1 -e 9818433
- RETRIEVE ALL TRIGGERED SEISMOGRAMS FOR EVENTS 9818433 AND 13635528 FROM THE CI NETWORK:
STP> trig -net CI 9818433 13635528
The STP program creates a directory for each event with the name eventid and puts the seismograms there, along with a file of event parameters, eventid.evnt.