R: Generate sound intensity attenuation data

attenuation {seewave}

R Documentation

Generate sound intensity attenuation data

Description

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

Usage

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

Arguments

`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.
`type`	if `plot` is `TRUE`, type of plot that should be drawn. See `plot` for details (by default "l" for lines).
`...`	other `plot` graphical parameters.

Value

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

Note

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.

Author(s)

Jerome Sueur

References

Hartmann, W. M. 1998 Signals, sound and sensation. New York: Springer.

Examples

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

[Package seewave version 2.1.6 Index]