H | R Documentation |

This function estimates the total entropy of a time wave.

`H(wave, f, channel = 1, wl = 512, envt="hil", msmooth = NULL, ksmooth = NULL)`

`wave` |
an R object. |

`f` |
sampling frequency of |

`channel` |
channel of the R object, by default left channel (1). |

`wl` |
window length for spectral entropy analysis
(even number of points). See |

`envt` |
the type of envelope to be used: either "abs" for absolute
amplitude envelope or "hil" for Hilbert amplitude envelope. See |

`msmooth` |
a vector of length 2 to smooth the amplitude envelope with a
mean sliding window. The first component is the window length
(in number of points). The second component is the overlap between
successive windows (in %). See |

`ksmooth` |
kernel smooth via |

This function computes the product between the values obtained with
`sh`

and `th`

functions.

This then gives a global (time and frequency) estimation of signal entropy.

The frequency mean spectrum and the amplitude envelope needed for computing
respectively `sh`

and `th`

are automatically generated.
They can be controlled through `wl`

and `smooth`

arguments respectively.
See examples below and examples in `sh`

and `th`

for implications on the results.

A single value varying between 0 and 1 is returned. The value has no unit.

The entropy of a noisy signal will tend towards 1 whereas the entropy of a pure tone signal will tend towards 0.

Jerome Sueur sueur@mnhn.fr

Sueur, J., Pavoine, S., Hamerlynck, O. & Duvail, S. (2008) - Rapid acoustic survey for biodiversity appraisal. *PLoS ONE*, 3(12): e4065.

`sh`

, `th`

, `csh`

```
data(orni)
H(orni,f=22050)
# changing the spectral parameter (wl)
H(orni,f=22050,wl=1024)
# changing the temporal parameter (msmooth)
H(orni,f=22050,msmooth=c(20,0))
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.