sac2mseed - SAC to miniSEED converter

About Sac

       Seismic Analysis Code (SAC) is a general purpose interactive program designed for the study of sequential
       signals,  especially timeseries data.  Originally developed at the Lawrence Livermore National Laboratory
       the SAC software package is also available from IRIS.

Author

       Chad Trabant
       IRIS Data Management Center

                                                   2017/04/03                                       SAC2MSEED(1)

Description

sac2mseed  converts  SAC  waveform  data to miniSEED format.  By default the format of the input files is
       automatically detected: alpha or binary (byte order autodetected).  The format can also  be  forced  with
       the  -f option.  If an input file name is prefixed with an '@' character the file is assumed to contain a
       list of input data files, see LISTFILES below.

       If the input file name ends in ".sac" (not case sensitive) the default output file name will be the  same
       with  the extension replace with ".mseed".  The output data may be re-directed to a single file or stdout
       using the -o option.

List Files

       If  an  input  file  is  prefixed with an '@' character the file is assumed to contain a list of file for
       input.  Multiple list files can be combined with multiple input files on the  command  line.   The  last,
       space separated field on each line is assumed to be the file name to be read.

       An example of a simple text list:

       TA.ELFS..LHE.SAC
       TA.ELFS..LHN.SAC
       TA.ELFS..LHZ.SAC

Name

       sac2mseed - SAC to miniSEED converter

Options

-V Print program version and exit.

-h Print program usage and exit.

-v Be more verbose. This flag can be used multiple times ("-v -v" or "-vv") for more verbosity.

-S Include SEED blockette 100 in each output record with the sample rate in floating point format.
The basic format for storing sample rates in SEED data records is a rational approximation
(numerator/denominator). Precision will be lost if a given sample rate cannot be well
approximated. This option should be used in those cases.

-n netcode
Specify the SEED network code to use, if not specified the network code will be the value of the
KNETWK variable in the SAC header, if KNETWK is not specified the network code will be blank. It
is highly recommended to specify a network code if no network is defined in the SAC file.

-s stacode
Specify the SEED station code to use, if not specified the station code will be the value of the
KSTNM variable in the SAC header, if KSTNM is not specified the location ID will be blank.

-l locid
Specify the SEED location ID to use, if not specified the location ID will be the value of the
KHOLE variable in the SAC header, if KHOLE is not specified the location ID will be blank.

-c chancodes
Specify the SEED channel codes to use, if not specified the channel code will be the value of the
KCMPNM variable in the SAC header, if KCMPNM is not specified the location ID will be blank. As a
special case a dot (.) will be interpreted as the same character as the input channel name, for
example, "L.." can be specified to only replace the first code with 'L' and leave the other two
codes as they are.

-r bytes
Specify the miniSEED record length in bytes, default is 4096.

-e encoding
Specify the miniSEED data encoding format, default is 11 (Steim-2 compression). Other supported
encoding formats include 10 (Steim-1 compression), 1 (16-bit integers) and 3 (32-bit integers).
The 16-bit integers encoding should only be used if all data samples can be represented in 16
bits.

-b byteorder
Specify the miniSEED byte order, default is 1 (big-endian or most significant byte first). The
other option is 0 (little-endian or least significant byte first). It is highly recommended to
always create big-endian SEED.

-o outfile
Write all miniSEED records to outfile, if outfile is a single dash (-) then all miniSEED output
will go to stdout. All diagnostic output from the program is written to stderr and should never
get mixed with data going to stdout.

-m metafile
For each input SAC file write a one-line summary of channel metadata metafile. The one-line
summary is a comma-separated list containing: network, station, location, channel, latitude,
longitude, elevation, depth, azimuth, incidence, instrument name, scale factor, sampling rate and
start and end times. In SAC the component azimuth is in degrees clockwise from north, the
component incident angle is in degrees from vertical and the elevation and depth are both in
meters.

-me When writing out a metadata file include the event name (kevnm) and user strings 0, 1 and 2
(kuser0, kuser1 and kuser2).

-s factor
When writing data to an integer (miniSEED) encoding format apply this scaling factor to each input
floating point data sample before truncating to an integer. By default autoscaling is used and a
scaling factor is determined that will scale the maximum sample value to a minimum of 6 digits.
If none of the input sample values include fractional components the scaling factor will be 1 and
the floating point data will simply be truncated to their integer components.

-f format
By default the format of each input file is autodetected, either alpha or binary (little or big
endian byte order autodetected as well). This option forces the format for every input file:

0 : Autodetect SAC format (default)
1 : Alphanumeric SAC format
2 : Binary SAC format, autodetect byte order
3 : Binary SAC format, little-endian
4 : Binary SAC format, big-endian

Seed Location Ids

       The  contents  of  the SAC header variable KHOLE is used as the SEED location ID if it is set.  While the
       definition of KHOLE and SEED location ID are not officially the same, this is  a  known  convention  when
       converting between these two formats.

Synopsis

       sac2mseed [options] file1 [file2 file3 ...]