tweak_spectro plots a mosaic of spectrograms with varying display parameters to
facilitate selection of display parameters
tweak_spectro(X, length.out = 5, ovlp = 90, wl = c(100, 1000), wn = "hanning",
collev.min = -40, pal = "reverse.gray.colors.2", path = NULL, rm.axes = TRUE, ...)Image files with spectrograms of entire sound files in the working directory. Multiple pages can be returned, depending on the length of each sound file.
object of class 'selection_table', 'extended_selection_table' or data frame with a single row and columns for sound file name (sound.files), selection number (selec),
and start and end time of signal (start and end). Default is NULL.
Numeric vector of length 1 controlling the number of sublevels of the numeric arguments for which a range has been provided. Ranges are allowed for 'ovlp', 'wl', and 'collev.min' arguments.
Numeric vector of length 1 or 2 specifying % of overlap (or
lower/upper values the desired range) between two consecutive windows, as in
spectro. Default is 90.
A numeric vector of length 1 or 2 specifying the window length (length 1) or the lower and upper range limits of the desired window length range (length 2) for creating spectrograms. Default is c(100, 1000).
Character vector specifying the window function names to be used. Several
names can be provided. See ftwindow
for name options. Default is "hanning". If "all", then all window functions available are used.
A (negative) numeric vector of length 1 or 2. Determines the first argument
to use in 'collevels' for the internal spectrogram creating function. This replaces the
first element in the 'collevels' as in spectro. Note that
'collevels' is not available in this function tweak_spectro.
Color palette function for spectrogram. Default is "reverse.gray.colors.2".
Several palettes can be provided in a character vector. Note that, contrary to
other warbleR and seewave functions, the
palette most be provided as character string rather than as a function. See
spectro for more palettes.
Character string containing the directory path where the sound file are located.
Logical. If TRUE frequency and time axes are excluded. Default is TRUE.
Additional arguments to be passed to catalog function for customizing
graphical output. Check out catalog for more details.
Marcelo Araya-Salas (marcelo.araya@ucr.ac.cr)
This functions aims to simplify the selection of spectrogram parameters. The function plots, for a single selection, a mosaic of spectrograms with varying display parameters. For numeric arguments the upper and lower limits of a range can be provided. The following arguments accept can have varying values:
wl: Windows length (numeric range)
ovlp: Overlap (numeric range)
collev.min: Minimum value of the color levels (numeric range)
wn: window function names (character)
pal: palette (character)
Outputs are similar to those of catalog. The output image files can be put together in a single pdf file with catalog2pdf.
We recommend using low resolution (~60-100) and smaller dimensions (width & height < 10) if
aiming to generate pdfs (otherwise pdfs could be pretty big).
catalog2pdf