Jrdseed Manual

Jrdseed 0.09

NAME

Jrdseed - A Java port of our classic rdseed application developed by ISTI.

DESCRIPTION

A Java version of rdseed currently under development. This evaluation supports core rdseed functionality, including the reading and writing of SEED volumes, as well as SAC (binary) and CSS output. SAC ASCII format is forthcoming. SEGY output is not being considered in the short term.

Treat the operation of Jrdseed much like you would the legacy rdseed code. As for the command interface, some features are not being used in the current release:

In place of ALT_RESPONSE_FILE, use the '-g' flag on the command line to indicate a dataless SEED file to use for response information.
The volume number ('-v') option: SEED files with multiple volume numbers are no longer used.
The start/stop times ('-t') output will not have the logical record sequence number printed.
The list contents of each record in the volume ('-l') option is not supported.
SAC ASCII output is not in SAC format, but is a currently a rudimentary delimited ASCII output.
SEGY output is not supported.

INSTALLATION AND USAGE

You can download Jrdseed from:

http://www.iris.edu/manuals/#jrdseed

For those not familiar with the 'rdseed' interface, please refer to the rdseed online manual at:

http://www.iris.edu/manuals/rdseed.htm

The rdseed manual will tell you how to use Jrdseed, aside from the feature differences mentioned above. The other critical difference is how you start Jrdseed. Since it uses Java, you have to use the Java launcher on the .jar file itself:

java -jar Jrdseed0.09.jar (Java 1.4 or later is required.)

A sample session with Jrdseed looks like:

        myserver% java -jar Jrdseed0.09.jar

        << Java SEED Reader, Release 0.09 >>
        Input File (/dev/nrst0) or 'Quit' to Exit: waveforms_99.seed
        Output File (stdout) :
        Volume # [(1)-N] :
        Options [acCsSpRtde] : d
        Station List (ALL) :
        Channel List (ALL) : BH?,LH?
        Network List (ALL) :
        Loc Ids (ALL ["--" for spaces]) :
        Output Format [(1=SAC), 2=AH, 3=CSS, 4=mini seed, 5=seed, 6=sac ascii,
        7=SEGY] : 4
        Select Data Type [(E=Everything), D=Data of Undetermined State, R=Raw
        waveform Data, Q=QC'd data] : E
        Start Time(s) YYYY,DDD,HH:MM:SS.FFFF : 1999,027,06:24:59.0000
        End Time(s) YYYY,DDD,HH:MM:SS.FFFF :
        Extract Responses [Y/(N)] : N
        Input File (/dev/nrst0) or 'Quit' to Exit: q

CHANGES

version 09-270

- support compressed flags
- support for "SEEDALIAS" environment variable
- support for "ALT_RESPONSE_FILE" environment variable

AUTHORS

Kevin Frechette and Sid Hellman
Instrumental Software Technologies, Inc. (ISTI)
www.isti.com
(under contract by IRIS)

LICENSING

Jrdseed consists of two components, each carrying a separate license.

IRIS is presenting the Jrdseed interface code as well as JavaSeed as open source under the Lesser GNU Public License (LGPL). The LGPL license can be found in the 'license' subdirectory of this distribution. The following copyright applies to all IRIS source code:

Copyright © 2006 Incorporated Research Institutions for Seismology

This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free Software
Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this
library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
Boston, MA 02111-1307 USA

For more information, please contact the principle author shown here.

The other component consists of ISTI-proprietary utilities that cannot have its source code exposed by IRIS, but only through direct contact with the developers at ISTI. They are not obligated by IRIS's LGPL license.

Under IRIS LGPL Licensing:
./com/isti/jrdseed
./com/opensymphony/oscache
./edu/iris/Fissures
./src
ISTI Proprietary code can be found in:
./com/isti/shape
./com/isti/util

FEEDBACK

Jrdseed is currently a public evaluation release, having undergone internal testing and evaluation. There are no guarantees that Jrdseed is a suitable replacement for rdseed or should be put into production use. Please evaluate the tool to determine its suitability for your purposes. Development and support will continue for this tool as time and resources allow.

For questions and comments regarding Jrdseed, please write to comments@iris.washington.edu

[return to top]

updated 01/26/2009