spectrum                package:stats                R Documentation

_S_p_e_c_t_r_a_l _D_e_n_s_i_t_y _E_s_t_i_m_a_t_i_o_n

_D_e_s_c_r_i_p_t_i_o_n:

     The 'spectrum' function estimates the spectral density of a time
     series.

_U_s_a_g_e:

     spectrum(x, method = c("pgram", "ar"), plot = TRUE,
              na.action = na.fail, ...)

_A_r_g_u_m_e_n_t_s:

       x: A univariate or multivariate time series.

  method: String specifying the method used to estimate the spectral
          density.  Allowed methods are '"pgram"' (the default) and
          '"ar"'.

    plot: logical. If 'TRUE' then the spectral density is plotted.

na.action: 'NA' action function.

     ...: Further arguments to specific spec methods or 'plot.spec'.

_D_e_t_a_i_l_s:

     'spectrum' is a wrapper function which calls the methods
     'spec.pgram' and 'spec.ar'.

     The spectrum here is defined with scaling '1/frequency(x)',
     following S-PLUS.  This makes the spectral density a density over
     the range '(-frequency(x)/2, +frequency(x)/2]', whereas a more
     common scaling is 2pi and range (-0.5, 0.5] (e.g., Bloomfield) or
     1 and range (-pi, pi].

     If available, a confidence interval will be plotted by
     'plot.spec': this is asymmetric, and the width of the centre mark
     indicates the equivalent bandwidth.

_V_a_l_u_e:

     An object of class '"spec"', which is a list containing at least
     the following components: 

    freq: vector of frequencies at which the spectral density is
          estimated. (Possibly approximate Fourier frequencies.) The
          units are the reciprocal of cycles per unit time (and not per
          observation spacing): see Details below.

    spec: Vector (for univariate series) or matrix (for multivariate
          series) of estimates of the spectral density at frequencies
          corresponding to 'freq'.

     coh: 'NULL' for univariate series. For multivariate time series, a
          matrix containing the _squared_ coherency between different
          series. Column  i + (j - 1) * (j - 2)/2 of 'coh' contains the
          squared coherency between columns i and j of 'x', where i <
          j.

   phase: 'NULL' for univariate series. For multivariate time series a
          matrix containing the cross-spectrum phase between different
          series. The format is the same as 'coh'.

  series: The name of the time series.

  snames: For multivariate input, the names of the component series.

  method: The method used to calculate the spectrum.


     The result is returned invisibly if 'plot' is true.

_N_o_t_e:

     The default plot for objects of class '"spec"' is quite complex,
     including an error bar and default title, subtitle and axis
     labels.  The defaults can all be overridden by supplying the
     appropriate graphical parameters.

_A_u_t_h_o_r(_s):

     Martyn Plummer, B.D. Ripley

_R_e_f_e_r_e_n_c_e_s:

     Bloomfield, P. (1976) _Fourier Analysis of Time Series: An
     Introduction._ Wiley.

     Brockwell, P. J. and Davis, R. A. (1991) _Time Series: Theory and
     Methods._ Second edition. Springer.

     Venables, W. N. and Ripley, B. D. (2002) _Modern Applied
     Statistics with S-PLUS._ Fourth edition. Springer. (Especially
     pages 392-7.)

_S_e_e _A_l_s_o:

     'spec.ar', 'spec.pgram'; 'plot.spec'.

_E_x_a_m_p_l_e_s:

     ## Examples from Venables & Ripley
     ## spec.pgram
     par(mfrow=c(2,2))
     spectrum(lh)
     spectrum(lh, spans=3)
     spectrum(lh, spans=c(3,3))
     spectrum(lh, spans=c(3,5))

     spectrum(ldeaths)
     spectrum(ldeaths, spans=c(3,3))
     spectrum(ldeaths, spans=c(3,5))
     spectrum(ldeaths, spans=c(5,7))
     spectrum(ldeaths, spans=c(5,7), log="dB", ci=0.8)

     # for multivariate examples see the help for spec.pgram

     ## spec.ar
     spectrum(lh, method="ar")
     spectrum(ldeaths, method="ar")

