spectro3D              package:seewave              R Documentation

_3_D-_s_p_e_c_t_r_o_g_r_a_m _o_f _a _t_i_m_e _w_a_v_e

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

     This functions returns a three-dimension spectrographic
     representation of a time wave. The function corresponds to
     short-term Fourier transform.

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

     spectro3D(wave, f, wl, zp = 0, ovlp = 0, plot = TRUE,
     magt = 10, magf = 10, maga = 2, palette = rev.terrain.colors)

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

    wave: data describing a time wave.

       f: sampling frequency of 'wave'.

      wl: length of the window for the analysis (even number of
          points).

      zp: zero-padding (even number of points), see 'Details'.

    ovlp: overlap between two successive windows (in % ).

    plot: logical, if 'TRUE' plots the spectrogram (by default 'TRUE').

    magt: magnification of the time axis.

    magf: magnification of the frequency axis.

    maga: magnification of the amplitude axis.

 palette: a color palette function to be used to assign colors in the
          plot, see 'Details'.

_D_e_t_a_i_l_s:

     A Hanning function is applied to the analysis window.
      'zp' adds 0 values on both sides of the analysis window. This
     increases frequency resolution without altering time resolution.
      Any colour palette can be used. In particular, it is possible to
     use other palettes coming with 'seewave': 'spectro.colors' and
     'rev.heat.colors',  'rev.cm.colors', 'rev.topo.colors',
     corresponding to the reverse of 'heat.colors','topo.colors',
     'cm.colors'.
      Use 'magt', 'magf' and 'maga' to resize the plot.

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

     If 'plot' is 'FALSE', this function returns a matrix. Each column
     corresponds to a Fourier transform of length 'wl'.

_N_o_t_e:

     This function runs with 'rgl' and is based on 'fft'. See examples
     of 'spectro' for analysis arguments ('wl','zp', 'ovlp').

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

     Jrme Sueur jerome.sueur@ibaic.u-psud.fr and  Caroline
     Simonis-Sueur csimonis@mnhn.fr.

_S_e_e _A_l_s_o:

     'spectro', 'fft'.

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

     data(tico)
     spectro3D(tico,f=22050,wl=512,ovlp=75,zp=16,maga=4,palette=rev.terrain.colors)

