plotWaveform: Plot Graphical Representations of Waveforms

In PAMpal: Load and Process Passive Acoustic Data

Plot Graphical Representations of Waveforms

Description

Fetches matching binary data from a single or multiple detections in an AcousticStudy object, then plot the resulting data

Usage

plotWaveform(x, UID, length = NULL, sr = NULL)

plotSpectrogram(x, UID, length = NULL, sr = NULL, ...)

plotWigner(x, UID, length = NULL, sr = NULL, ...)

Arguments

x	a AcousticStudy object, a list of AcousticEvent objects, or a single AcousticEvent object
UID	the UID(s) of the individual detections to fetch the binary data for
length	length of the waveform to use for plotting, in samples. The clip used will be centered around the maximum value of the waveform, if length is NULL (default), the entire waveform will be used. If length is greater than the stored clip, the waveform will be zero-padded to length
sr	if NULL (default) will try to read sample rate from your data. If provided as a value will override sample rate in the data.
...	other arguments to pass to the spectrogram or wigner functions

Details

The plotSpectrogram function uses the function specgram to plot the spectrogram, see this function for plotting options. The plotWigner function uses the function wignerTransform to plot the Wigner-Ville transform, see this function for options.

Value

Nothing, just shows plots for every channel of the waveform for each UID provided

Author(s)

Taiki Sakai [e-mail]

Examples

data(exStudy)
plotWaveform(exStudy, 8000003)
plotSpectrogram(exStudy, 8000003)
plotWigner(exStudy, 8000003)

PAMpal documentation built on Aug. 12, 2023, 1:06 a.m.