attenuation             package:seewave             R Documentation

_G_e_n_e_r_a_t_e _s_o_u_n_d _i_n_t_e_n_s_i_t_y _a_t_t_e_n_u_a_t_i_o_n _d_a_t_a

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

     This function generates dB data following theoretical spherical
     attenuation of sound.

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

     attenuation(lref, dref = 1, dstop, n, plot = TRUE,
     xlab = "Distance (m)", ylab = "dB", ...)

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

    lref: reference intensity or pressure level (in dB).

    dref: reference distance corresponding to 'lref' (in m.) (by
          default = 1).

   dstop: maximal distance of propagation (in m.).

       n: number of points generated between 'dref' and 'dstop'.

    plot: logical, if 'TRUE' plots attenuation against distance of
          propagation (by default 'TRUE').

    xlab: title of the x axis.

    ylab: title of the y axis.

     ...: other 'plot' graphical parameters.

     ss

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

     If 'plot' is 'FALSE' return a numeric vector with the data
     generated.

_N_o_t_e:

     Sound attenuation in a free, unbounded medium behaves in
     accordance with the inverse square law. 'attenuation' generates
     data following this rule from a reference point where sound
     intensity level (SIL) or  sound pressure level (SPL) is known.
     Such theoretical data can be compared with experimental data
     collected in a real environment.

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

     Jrme Sueur jerome.sueur@ibaic.u-psud.fr

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

     Hartmann, W. M. 1998 _Signals, sound and sensation_. New York:
     Springer.

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

     'convSPL', 'moredB'

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

     # theoretical attenuation up to 200 m of a 100 dB/1m sound source
     attenuation(lref=100,dstop=150,n=200,type="l")

