rsac                  package:Rsac                  R Documentation

_R_E_A_D _A _B_I_N_A_R_Y _S_A_C _F_I_L_E

_D_e_s_c_r_i_p_t_i_o_n:

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

_U_s_a_g_e:

       rsac(files, endian = .Platform$endian)

_A_r_g_u_m_e_n_t_s:

   files: name of file to be read.

  endian: the endian-ness of the file. See 'readBin'.

_V_a_l_u_e:

     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.

_A_u_t_h_o_r(_s):

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

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.llnl.gov/sac/>

_E_x_a_m_p_l_e_s:

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

     plot(x)

