write_sac: Write seismic traces as sac file to disk.

In coffeemuggler/eseis: Environmental Seismology Toolbox

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

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.

Value

A binary file written to disk.

Author(s)

Michael Dietze

Examples

## Not run: 
## load example data 
data("rockfall")

## write as sac file
write_sac(data = rockfall_eseis)
          

## End(Not run)

coffeemuggler/eseis documentation built on June 11, 2025, 9:09 a.m.