Package: warbleR 1.1.37

warbleR: Streamline Bioacoustic Analysis

Functions aiming to facilitate the analysis of the structure of animal acoustic signals in 'R'. 'warbleR' makes use of the basic sound analysis tools from the packages 'tuneR' and 'seewave', and offers new tools for exploring and quantifying acoustic signal structure. The package allows to organize and manipulate multiple sound files, create spectrograms of complete recordings or individual signals in different formats, run several measures of acoustic structure, and characterize different structural levels in acoustic signals (Araya-Salas et al 2016 <doi:10.1111/2041-210X.12624>).

Authors:Marcelo Araya-Salas [aut, cre], Grace Smith-Vidaurre [aut]

warbleR_1.1.37.tar.gz
warbleR_1.1.37.zip(r-4.7)warbleR_1.1.37.zip(r-4.6)warbleR_1.1.37.zip(r-4.5)
warbleR_1.1.37.tgz(r-4.6-x86_64)warbleR_1.1.37.tgz(r-4.6-arm64)warbleR_1.1.37.tgz(r-4.5-x86_64)warbleR_1.1.37.tgz(r-4.5-arm64)
warbleR_1.1.37.tar.gz(r-4.7-arm64)warbleR_1.1.37.tar.gz(r-4.7-x86_64)warbleR_1.1.37.tar.gz(r-4.6-arm64)warbleR_1.1.37.tar.gz(r-4.6-x86_64)
warbleR_1.1.37.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
warbleR/json (API)

# Install 'warbleR' in R:
install.packages('warbleR', repos = c('https://marce10.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/marce10/warbler/issues

Pkgdown/docs site:https://marce10.github.io

Uses libs:
  • c++– GNU Standard C++ Library v3
Datasets:
  • comp_matrix - Example matrix listing selections to be compared by 'cross_correlation'
  • lbh_selec_table - Example data frame of selections (i.e. selection table).
  • sim_coor_sing - Simulated coordinated singing events.
  • sth_annotations - Example data frame of annotations from a Scale-throated hermit song (i.e. selection table).

On CRAN:

Conda:

animal-acoustic-signalsaudio-processingbioacousticsspectrogramstreamline-analysiscpp

10.88 score 62 stars 4 packages 402 scripts 864 downloads 6 mentions 67 exports 54 dependencies

Last updated from:8514cc01ea. Checks:13 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64OK200
linux-devel-x86_64OK226
source / vignettesOK254
linux-release-arm64OK207
linux-release-x86_64OK212
macos-release-arm64OK118
macos-release-x86_64OK279
macos-oldrel-arm64OK130
macos-oldrel-x86_64OK343
windows-develOK169
windows-releaseOK183
windows-oldrelOK204
wasm-releaseOK171

Exports:acoustic_activityby_element_estcatalogcatalog2pdfcheck_selscheck_sound_filescolor_spectrocompare_methodsconsolidatecross_correlationcut_selsduration_sound_filesenvelopeffDTWfilter_selsfind_clippingfix_extended_selection_tablefix_wavsfreq_DTWfreq_rangefreq_range_detecfreq_tsfull_spectrogram2pdffull_spectrogramsgapsimage_to_waveinflectionsinfo_sound_filesis_extended_selection_tableis_selection_tablemake.selection.tablemap_xcmfcc_statsmove_imagesmp32wavmulti_DTWopen_wdoverlapping_selsphylo_spectroplot_coordinationquerxcquery_xcread_sound_fileread_waveremove_channelsremove_silencerename_est_wavesresample_estselection_tablesig2noisesimulate_songssnr_spectrogramssong_analysissort_colmssound_pressure_levelspectro_analysisspectrogramssplit_sound_filestailor_selstest_coordinationtrack_freq_contourtrack_harmonictweak_spectrowarbleR_optionswav_2_flacwaveform_similaritywpd_features

Dependencies:askpassbase64encbioacousticsbriocallrclicrayoncurldescdiffobjdigestdtwevaluatefastmapfftwfsgluehighrhtmltoolshttrjsonliteknitrlifecyclemagrittrMASSmimemomentsmonitoRNatureSoundsopensslotelpbapplypkgbuildpkgloadpraiseprocessxproxypsR6RcpprlangrprojrootseewavesignalstringistringrsystestthattuneRvctrswaldowithrxfunyaml

Acoustic (dis)similarity, coordinated singing and simulating songs
Bioacoustics in R with warbleR | Package repositories | Parallel processing in warbleR | Vignette introduction | Prepare for analyses | Extract acoustic parameters as time series | Detect frequency range | Extract spectral entropy as a time series | Visualizing frequency contours with track_freq_contour | Extract fundamental or dominant frequency contours as a time series | Manually tailor frequency contours with tailor_sels | Count inflections across frequency contours | Compare methods for quantitative analysis of signal structure | Measure acoustic parameters with spectro_analysis | Calculate acoustic parameters by song type | Dynamic time warping of frequency contours | Spectrographic cross-correlation | Analysis of geographic variation using spectro_analysis measurements | Coordinated singing analysis | Simulating songs | Citation | Reporting bugs
Rendered fromc_warbleR_workflow_02.Rmdusingknitr::rmarkdown

Last update: 2025-07-23
Started: 2024-12-10

Package overview
Input acoustic data in warbleR | warbleR functions and the workflow of analysis in bioacoustics | Get and prepare recordings | Annotating sound | Organize annotations | Measure acoustic signal structure | Verify annotations | Visual inspection of annotations and measurements | Additional functions | References
Rendered froma_warbleR.Rmdusingknitr::rmarkdown

Last update: 2025-04-02
Started: 2024-08-29

Annotation data format
Data frames | warbleR annotation formats | Selection tables | Extended selection tables | Handling extended selection tables | 'By element' vs 'by song' extended selection tables | Performance | Sharing acoustic data | Citation | Reporting bugs | References
Rendered fromb_annotation_data_format.Rmdusingknitr::rmarkdown

Last update: 2025-04-02
Started: 2024-08-29

Readme and manuals

Help Manual

Help pageTopics
Estimate acoustic activity across sound files based on selectionsacoustic_activity
Convert a by-song extended selection table to by-elementby_element_est
Create catalogs of vocal signalscatalog
Combine 'catalog' images into pdfscatalog2pdf
Check selection data framescheck_sels
Check sound filescheck_sound_files
Highlight spectrogram regionscolor_spectro
Example matrix listing selections to be compared by 'cross_correlation'comp_matrix
Assessing the performance of acoustic distance measurementscompare_methods
Consolidate (sound) files into a single directoryconsolidate
Time-frequency cross-correlationcross_correlation
Cut selections into individual sound filescut_sels
Measure the duration of sound filesduration_sound_files
Calculates the absolute amplitude envelopeenvelope
Subset selection data frames based on manually filtered image filesfilter_sels
Find clipped selectionsfind_clipping
Fix extended selection tablesfix_extended_selection_table
Fix .wav files to allow importing them into Rfix_wavs
Acoustic dissimilarity using dynamic time warping on dominant frequency contoursfreq_DTW
Detect frequency range iterativelyfreq_range
Detect frequency range on wave objectsfreq_range_detec
Extract frequency contours as time seriesfreq_ts
'full_spectrogram2pdf' combines 'full_spectrograms' images in .jpeg format to a single pdf file.full_spectrogram2pdf
Create long spectrograms of entire sound filesfull_spectrograms
Gap durationgaps
Convert images into wave objectsimage_to_wave
Count number of inflections in a frequency contourinflections
Get sound file parameter informationinfo_sound_files
Class 'extended_selection_table': selection table containing wave objectsis_extended_selection_table
Class 'selection_table': double-checked frequency/time coordinates of selectionsis_selection_table
Example data frame of selections (i.e. selection table).lbh_selec_table
Maps of 'Xeno-Canto' recordings by speciesmap_xc
Calculate descriptive statistics on Mel-frequency cepstral coefficientsmfcc_stats
Move/copy image files between directoriesmove_images
Convert .mp3 files to .wavmp32wav
A wrapper on 'dtwDist' for comparing multivariate contoursmulti_DTW
Open working directoryopen_wd
Find overlapping selectionsoverlapping_sels
Add spectrograms onto phylogenetic treesphylo_spectro
Coordinated singing graphsplot_coordination
Access 'Xeno-Canto' recordings and metadataquery_xc
An extended version of read_wave that reads several sound file formats and files from selection tablesread_sound_file
A wrapper for tuneR's readWave that read sound files listed within selection tablesread_wave
Remove channels in wave filesremove_channels
Remove silence in wave filesremove_silence
Rename wave objects and associated metadata in extended selection tablesrename_est_waves
Resample wave objects in a extended selection tableresample_est
Create 'selection_table' and 'extended_selection_table' objectsselection_table
Measure signal-to-noise ratiosig2noise
Simulated coordinated singing events.sim_coor_sing
Simulate animal vocalizationssimulate_songs
Spectrograms with background noise marginssnr_spectrograms
Calculates acoustic parameters at the song levelsong_analysis
Sort columns in a more intuitive ordersort_colms
Measure relative sound pressure levelsound_pressure_level
Measure acoustic parameters in batches of sound filesspectro_analysis
Spectrograms of selected signalsspectrograms
Splits sound filessplit_sound_files
Example data frame of annotations from a Scale-throated hermit song (i.e. selection table).sth_annotations
Interactive view of spectrograms to tailor selectionstailor_sels
Randomization test for singing coordinationtest_coordination
Spectrograms with frequency measurementstrack_freq_contour
Track harmonic frequency contourtrack_harmonic
Plot a mosaic of spectrograms with varying display parameterstweak_spectro
Setting warbleR optionswarbleR_options
Convert .wav files to .flacwav_2_flac
Pairwise similarity of waveformswaveform_similarity
Measure wavelet packet decomposition features (EXPERIMENTAL)wpd_features