SCEDC Home
Home
Waveforms
STP User Guide


 
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/stp/stp.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 scec.gps.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).

WEB-BASED VERSION


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.

STAND-ALONE VERSION

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.


k2% stp
STP: Connected

You are currently running the latest version of stp

Welcome to the Southern California Earthquake Data Center Seismic Transfer Program

STP> help

Seismic Transfer Program Command and Help Summary

    NEWS - latest news on STP
    WIN - get time window of data
    TRIG - get data for triggered event
    STA - station info
    CHAN - channel info
    EVENT - event search
    PHASE - obtain phase pick information
    SAC - output in SAC format
    MSEED - output in MSEED 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)
    GAIN - yes/no correction for station gain
    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)



SAMPLE COMMANDS

• 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.
Research Tools >
General Earthquake Information
Stations/ Instrumentation
Educational Resources
About the Data Center
• website map