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 at: http://www.data.scec.org/research-tools/stp-index.html. 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 from: http://www.data.scec.org/ftp/programs/stp
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: http://www.data.scec.org/stp/stpfaq.html 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
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.
mymachine% stp 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 HELP Command: HELP [TOPIC] where topic is one of the entries above UNIX shell escape: Any line starting with '!' will be executed as a UNIX command; e.g. 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
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.