rsac {Rsac} | R Documentation

## READ A BINARY SAC FILE

### Description

This function reads the header information and data of a SAC binary file into a list.

### Usage

      rsac(files, endian = .Platform$endian)

### Arguments

`files` | name of file to be read.
`endian` | the endian-ness of the file. See `readBin`.

### Value

an object of class `"rsac"`, which is a list containing the following elements:

`amp` | data.
`dt` | Increment between evenly spaced samples (nominal value).
`depmin` | Minimum value of dependent variable.
`depmax` | Maximum value of dependent variable.
`scale` | Multiplying scale factor for dependent variable.
`odelta` | Observed increment if different from nominal value.
`b` | Beginning value of the independent variable.
`e` | Ending value of the independent variable.
`o` | Event origin time (seconds relative to reference time.
`a` | First arrival time, seconds relative to reference time.
`f` | End of event time.
`stla` | Station latitude (degrees, north positive).
`stlo` | Station longitude (degrees, east positive).
`stel` | Station elevation (meters).
`stdp` | Station depth below surface (meters).
`evla` | Event latitude (degrees, north positive).
`evlo` | Event longitude (degrees, east positive).
`evel` | Event elevation (meters).
`evdp` | Event depth below surface (meters).
`mag` | Event magnitude.
`dist` | Station to event distance (km).
`az` | Event to station azimuth (degrees).
`baz` | Station to event azimuth (degrees).
`gcarc` | Station to event great circle arc length (degrees).
`cmpaz` | Component azimuth (degrees clockwise from north).
`cmpinc` | Component incident angle (degrees from vertical).
`nzyear` | GMT year corresponding to reference (zero) time in file.
`nzjday` | GMT julian day.
`nzhour` | GMT hour.
`nzmin` | GMT minute.
`nzsec` | GMT second.
`nzmsec` | GMT millisecond.
`norid` | Origin ID.
`nevid` | Event ID.
`N` | Number of points in time series.
`units` | Type of dependent variable (IUNKN=Unknown; IDISP=Displacement in nm; IVEL=Velocity in nm/sec; IVOLTS=Velocity in volts; IACC=Acceleration in nm/sec/sec).
`iztype` | Reference time equivalence (IUNKN=Unknown; IB=Begin time; IDAY=Midnight of refernece GMT day; IO=Event origin time; IA=First arrival time; ITn=User defined time pick n, n=0,9).
`leven` | `TRUE` if data is evenly spaced.
`lpspol` | `TRUE` if station components have a positive polarity (left-hand rule).
`sta` | Station name.
`kevnm` | Event name.
`khole` | Hole identification if nuclear event.
`ko` | Event origin time identification.
`ka` | First arrival time identification.
`comp` | Component name.
`knetwork` | Name of seismic network.
`kinst` | Generic name of recording instrument.

### Author(s)

Eric M. Thompson <eric.thompson@tufts.edu>

### References

http://www.llnl.gov/sac/

### Examples

    x <- rsac(system.file("bigendian/2003.356.19.15.31.0000.NC.NTAB..EHZ.D.SAC", package = "Rsac"), endian = "big")

    plot(x)

[Package Rsac version 0.1-8 Index]