2003/01/13 Doug Neuhauser, doug@seismo.berkeley.edu The quanterra programs are ANSI C compilant. Notes: 1. With the exception of quan2dbx and sdrsplit, all programs the manipulate MiniSEED or SEED Data Records (SDR) files only work with single-component files. Multi-component block-multiplexed files must be split into single component files using sdrsplit. 2. The qlib2 library is used by virtually all of the C programs in this directory, and is needed to rebuild these programs. 3. The file leapseconds describes the leapseconds that have ocurred since the start of leapseconds. It should be installed as /usr/local/lib/leapseconds or set the LEAPSECONDS environment variable to point to the file. An current version of this fill can be found at ftp://quake.geo.berkeley.edu/pub/quanterra/leapseconds You should check every June and December, as these months can contain leapseconds. Table of Contents: ============================================================================== bhold Creates a holdings record for each B050 blockette found within the specified directory. The files are used by sdata when writing dataless SEED volumes. (Data Center Only) caldate Performs date calculations. Can add or subtract times, and format the output in user-specified formats. Used by qdata and sdata, or handy for other purposes. It currently tries to calculate the differences between dates, but this is not well specifies (eg is the difference: (1993.50 - 1992.50) = 1 year or 366 days? fortran_example Sample fortran programs to read and write MiniSEED data. ms2ah Convert MiniSEED data file to AH XDR format data file. Requires AH libraries from lamont.ldeo.columbia.edu. ms2sac Convert MiniSEED data to SAC ASCII or binary format. msextract Extract selected event timeseries from MiniSEED data files. Data extraction controlled by an event list file. mssync Apply time corrections from one MiniSEED reference file to other MiniSEED files. Useful for performing time corrections for multiple channels from a single station. msunpack Unpack "packed" log channel files that were retrieved from Quanterra dataloggers into standard MiniSEED records. qasc2ms Converts Quanterra ascii files (as retrieved by dialup "retrieve" program from Quanterra dataloggers) into MiniSEED files. qdata This perl program will extract data from either the online telemetry files or the daily archive files, and create MiniSEED output files for the specified station/channel and times. It uses qmerge to perform the actual extraction. (Data Center Only) qedit Qedit is an "line" editor for MiniSEED, Steim-1/Steim-2 SEED Data Records, or Adebahr DRM data files. It allows you to change (almost) any value in the SEED Fixed Data Headers. It is mostly used to perform time corrections (using the Time correction field) or to add and/or change fields such as the station, channel, or network id fields. Note: Since the DRM files do not have time correction field, and time correction made on a DRM file will get incorporated into the time header when the file is rewritten. qhold Qhold creates "holdings" records (as defined by the IRIS Interim Data Center System) for a MiniSEED or SDR (Seed Data Record) file. They are used by "qrequest", "sdata" and the IRIS SEED writer POD when writing SEED volumes. (Data Center only). qlib2 Library routines used by all of these programs. Most useful are the time conversion routines and manipulation routines, which take into account leap seconds. qlog (previously named nlog) Qlog converts Quanterra Event detection telemetry files ("E" files), Quanterra console log files ("L" files), and Quanterra timing log (ACE channel) files into printable format. qmerge Qmerge is a data extraction, merge, and conversion program that can read and convert any combination of: 1. Steim-1 or Steim-2 SEED data records (512 or 4K byte records) 2. MiniSEED files (Steim-1, Steim-2, INT16, INT24, INT32 format) 3. DRM data files. 4. Quanterra non-SDR binary files from dialup ("QDR" format, 512/4K blocks, rarely seen) 5. Quanterra PC datalogger format. and merge them into a single output datastream of 4K byte MiniSEED (or optionally SDR) records. qrequest This program creates a "request" record from a holdings record in a holdings file (that was create by qhold). It is used by sdata to create the request records needed by the IRIS SEED writer POD. (Data Center Only). quan2dbx Converts MiniSEED or SDR files into DBX format (or optionally ASCII) files. DBX format is a file and directory format used for broadband data files by Geoscope, and modified at UCB to hold single-component data files. This version of DBX is not used outside of UCB. The ASCII file format is useful, however, when used with the "-F" (flat file) option. sac2ms This program convert SAC ASCII or binary files into MiniSEED data files. sdata Sdata is similar to qdata (in fact it uses qdata to perform any DRM data extraction) in that it will find the appropriate data from either the DRM files or the Data Center directories, and will create a full SEED volume using the IRIS SEED writer POD. It requires a number of auxilliary program and files: qdata - to perform DRM extraction qrequest - to create request records for POD qhold - to create the holdings files used by qrequest POD - IRIS SEED writer HDRxxx directory - Directory containing SEED blockettes for stations and channels, and the SEED abbreviation dictionary. See doug@seismo.berkeley.edu if you are interested in using this. (Data Center Only) sdata_db Sdata is similar to qdata (in fact it uses qdata to perform any DRM data extraction) in that it will find the appropriate data from either the DRM files or the Data Center directories, and will create a full SEED volume using the IRIS SEED writer POD. It queries the NCEDC database. It requires a number of auxilliary program and files: qdata - to perform DRM extraction qrequest - to create request records for POD qhold - to create the holdings files used by qrequest POD - IRIS SEED writer HDRxxx directory - Directory containing SEED blockettes for stations and channels, and the SEED abbreviation dictionary. See doug@seismo.berkeley.edu if you are interested in using this. (Data Center Only) sdrsplit Sdrsplit will split a block-multiplexed SEED Data Record file (such as those retrieved from Quanterra systems over dialup in Kermit mode) or block-multiplexed MiniSEED file into individual channel files. It can split data either by channels or by contiguous time period within each channel. seqy2ms Convert UCB/LBL (and optionally PASSCAL) SEGY format files into MiniSEED. For PASSCAL data, see the PASSCAL program segy2mseed program.