rdseed.l

gsac程序包

This file is called rdseed.alert.log and is located in the startup directory.

.SH Rdseed error logging

All rdseed error messages are logged to a file, called rdseed.error.log with the date. This file is appended to throughout the day.

.SH Data Recovery
.br
There are two necessary steps to recovering seismograms from a SEED tape.

The first step consists of finding out what is on the tape; one does this
by using any of the command line options -c or -t,
to list the station and channel names, starting times, and record numbers
of the seismograms contained in the volume. 

Seismic data are recovered from SEED tapes in the second step. Using the station,
channel and time information, use User Prompt Mode to select start and stop times for
individual seismograms.

Seismogram files are written to the current directory with names of the
form

.br
	yyyy.ddd.hh.mm.ss.ffff.SSSSS.CCC.SAC  for SAC Files
.br
	yyyy.ddd.hh.mm.ss.ffff.SSSSS.CCC.AH   for AH  Files
.br
	yy.ddd.hh.mm.ss.ffff/SSSSS.CCC.w      for CSS Files
.br     
	mini.seed                             for mini seed
.br 	
	yyyy.ddd.hh.mm.ss.ffff.SSSSS.CCC.SAC_ASC for sac ascii
.br	
	yyyy.ddd.hh.mm.ss.ffff.SSSSS.CCC.SEGY for SEGY
.br

where yyyy is the year,
ddd is the Julian day,
hh.mm.ss.ffff is the time of day of the start of the first record,
SSSSS is the station name, and
CCC is the component name for the particular seismogram being recovered.
This seismogram file naming convention was chosen to provide unique names to
output files
without user intervention; however, the large number of files which
can be generated to a single directory 
might cause problems for some operating systems.
Notice that CSS uses a slightly different format that puts channel data in
subdirectories. This is due to a limitation in the filename field in the
CSS database. For CSS there are three additional files created, RDSEED.WFDISC,
RDSEED.SITE and RDSEED.SITECHAN. These files are used by the CSS database system.

Be aware that rdseed always appends onto the mini.seed file. You need to
manually remove this file if you wish to start over.

.SH Recovering auxiliary data from an FDSN SEED volume.
.br
One may also retrieve the set of abbreviation dictionaries or the set of
station information tables from an FDSN SEED volume.  
The former is accomplished with the command
.br
.B	rdseed -af inputfile 
.br
while the latter results from 
.br
.B	rdseed -sf inputfile 
.br
Output from these commands should be redirected to files, as in examples
6 and 7.
.\"                *=======================================*
.\"================|              Diagnostics              |===================
.\"                *=======================================*
.SH DIAGNOSTICS
Various warnings and error messages are issued to the standard error device 
by the procedure.
Typical response of the procedure to a warning condition is to write a message
to the standard error device and then to continue execution. 
An error condition, on the other hand, will cause a message to be generated
to the standard error device followed by immediate termination of the procedure.
.\"                *=======================================*
.\"================|                Examples               |===================
.\"                *=======================================*
.SH EXAMPLES
1.  Reading the table of contents from a volume.
.br
	rdseed -cf /dev/rmt8 > tape.contents &
                         or
.br
	rdseed
.br
	Input Device (/dev/rst0)      : /dev/rmt8
.br
	Output Device (stdout)        : tape.contents
.br
	Volume #         [(1)-N]      :
.br
	Options          [acsSrRtde]  : c

reads the table of contents from the tape on device /dev/rmt8
into a file called tape.contents; the job is run in the background (command line
example).
Output directed to "stderr", such as error messages, comes to the terminal.
Table-of-contents entries have the format
.br
  AFI    LPZ      1988,228,00:00:00.68          1         147
.br
where the columns represent station name, channel name, start time, 
location flag (here, a blank), subsequence number, and starting record number.

2.  Determining event start/stop times on a volume.
.br
	rdseed -tvf 2 image > image.times &
                         or
	rdseed
.br
	Input Device (/dev/rst0)      : image
.br
	Output Device (stdout)        : image.times
.br
	Volume #         [(1)-N]      : 2
.br
	Options          [acsSrRtde]  : t

reads a disk file called "image" and creates 
a table containing starting record numbers, station and channel names, start and stop times
of events, nominal sample rate, calculated sample rate and numbers of samples
for that file.
Output is written to the file "image.times".
The lines of the output table have the format
.br
119  ANMO  LPZ  1988,230,00:00:00.6800  1988,230,18:35:04.6800  1.00  66904
.br
where the columns represent station name, channel name, start time, end time,
sample rate in samples per second, number of samples, and starting record number
for these data.

3.  Creating a detailed list of the contents of a volume.
.br
	rdseed -lf /dev/rmt11 > tape.list &
.br
reads a tape on drive mt11 and writes a list of the contents of each record
to a file called tape.list.
The job is run in the background.

4.  Reading all data from a tape.
.br
	rdseed
.br
	Input Device (/dev/rst0)       : /dev/rmt8
.br
	Output Device (stdout)         : tape.extraction.list
.br
	Volume #         [(1)-N]       :
.br
	Options          [acsSrRtde]   : d
.br
	Station List (ALL)             : 
.br
	Channel List (ALL)             : 
.br
	Output format [(1-SAC),2-AH...]:
.br
	Start Time(s) (FIRST)          : 
.br
	End Time(s) (LAST)             : 
.br
	Sample Buffer Length [2000000] : 
.br
	Extract Responses [Y/(N)]      : 

reads all seismograms from the tape on device /dev/rmt8
into the current directory, writes "stdout" output to a file.

5.  Reading the abbreviation dictionaries.
.br
	rdseed -af tape.image > tape.abbreviation.dictionaries 
                         or
	rdseed
.br
	Input Device (/dev/rst0)      : tape.image
.br
	Output Device (stdout)        : tape.abbreviation.dictionaries
.br
	Volume #         [(1)-N]      : 1
.br
	Options          [acsSrRtde]  : a

extracts the abbreviation dictionaries from a tape image stored on disk,
sends the result to a file, and runs in the foreground.

6.  Reading station information.
.br
	rdseed -sf /dev/rmt8 > tape.station.information &
                         or
	rdseed
.br
	Input Device (/dev/rst0)      : /dev/rmt8
.br
	Output Device (stdout)        : tape.station.information
.br
	Volume #         [(1)-N]      : 1
.br
	Options          [acsSrRtde]  : s

recovers station and channel location and response information from the tape
on device /dev/rmt8, writes the information to a file, and in the command line form
runs in the background.

7.  Reading specific station/channel/time information.
.br
	rdseed
.br
	Input Device (/dev/rst0)      : /dev/rmt8
.br
	Output Device (stdout)        : tape.station.information
.br
	Volume #         [(1)-N]      : 2
.br
	Options          [acsSrRtde]  : d
.br 	
	Summary File (None)	      :
.br
	Station List (ALL)            : BJI YKW1
.br
	Channel List (ALL)            : *Z
.br
	Network List (ALL)	      :
.br
	Output format [(1-SAC),2-AH..]:
.br
	Start Time(s) (FIRST)         : 1990,270,20:30
.br
	End Time(s) (LAST)            : 1991/2/1
.br
	Sample Buffer Length [2000000]: 3000000
.br
	Extract Responses [Y/(N)]     : Y

reads all seismograms from stations BJI and YKW1, all Z channels,
from year 1900, julian day 270, hour 20, minute 30 to Febuaury 1, 1991.
The buffer size was increased to 3 million samples and the channel response
information will be output.

.\"                *=======================================*
.\"================|         Files used or created         |===================
.\"                *=======================================*
.\" names of files that this command used or creates
.SH FILES
yyyy,ddd,hh.mm.ss.ffff.SSSSS.CCC - seismogram files as described above

mini.seed - file of mini seed data

rdseed.err_log.MM.DD.YY - a log of all error messages created during the day's usage.

rdseed.alert_log - file created when rdseed reverses the data.

.\"                *=======================================*
.\"================|Other relevant commands, files, manuals|===================
.\"                *=======================================*
.SH SEE ALSO
Halbert, S. E., R. Buland, and C. R. Hutt (1988).  Standard for
the Exchange of Earthquake Data (SEED), Version V2.0,
February 25, 1988.  United States Geological Survey,
Albuquerque Seismological Laboratory, Building 10002, Kirtland Air Force
Base East, Albuquerque, New Mexico 87115.  82 pp.

O'Neill, D. (1987).  IRIS Interim Data Distribution Format
(SAC ASCII), Version 1.0 (12 November 1987).  Incorporated
Research Institutions for Seismology, 1616 North Fort Myer
Drive, Suite 1440, Arlington, Virginia 22209.  11 pp.

Tull, J. (1987).  SAC User's Manual, Version 10.2, October 7,
1987.  Lawrence Livermore National Laboratory, L-205,
Livermore, California 94550.  ??? pp.
.\"                *=======================================*
.\"================|    Known problems with the command    |===================
.\"                *=======================================*
.SH BUGS

The -d option dumps all records .

Address bug reports to Chris Laughbon at IRIS DMC, 206-547-0393,
or send ARPAnet mail to [e-mail] .  
Please DO NOT "fix bugs" locally without telling the author about them.
.B
Please DO NOT redistribute this program.
Address requests for the program to IRIS at the numbers given above.
.\"                *=======================================*
.\"================|             Author's name             |===================
.\"                *=======================================*
.SH AUTHOR
Dennis O'Neill; Allen Nance, IRIS