eseis (version 0.5.0)

write_sac: Write seismic traces as sac file to disk.

Description

This function converts seismic traces to sac files and writes them to disk.

Usage

write_sac(
  data,
  file,
  time,
  component,
  unit,
  station,
  location,
  network,
  dt,
  autoname = FALSE,
  parameters,
  biglong = FALSE
)

Arguments

data

eseis object or numeric vector, data set to be processed. Most other arguments can be omitted if data is an eseis object.

file

Character scalar, sac file name with extension.

time

POSIXct vector, time vector corresponding to the seismic trace. Alternatively, the start time stamp can be provided as POSIXct value and a value for dt must be given.

component

Character value, component ID, optional.

unit

Character value, unit of the signal, optional. One out of "unknown", "displacement", "velocity", "volts", "acceleration". Default is "unknown".

station

Character value, station ID, optinal.

location

Character vector of length four, station location data (latitude, longitude, elevation, depth), optional.

network

Character value, network ID, optional.

dt

Numeric value, sampling period. Only needed if no time vector is provided.

autoname

Logical value, option to let the function generate the file name automatically. Default is FALSE.

parameters

Data frame sac parameter list, as obtained from list_sacparameters. Allows user-specific modifications. If this data frame is provided, it overrides all other arguments.

biglong

Logical value, biglong option, default is FALSE

Value

A binary file written to disk.

Details

For description of the sac file format see https://ds.iris.edu/files/sac-manual/manual/file_format.html. Currently the following parameters are not supported when writing the sac file: LAT, LON, ELEVATION, NETWORK.

Examples

# NOT RUN {
# }
# NOT RUN {
## load example data 
data("rockfall")

## write as sac file
write_sac(data = rockfall_eseis)
          
# }
# NOT RUN {
# }