Changelog

Source: NEWS.md

baRulho 2.2.0

CRAN release: 2026-10-09

MINOR IMPROVEMENTS

• Fix bug in spcc() in which the cor.method argument was ignored (always computed Pearson correlation)
• Fix bug in tail_to_signal_ratio() that used the wrong dB scale (natural log instead of 20 * log10(), inconsistent with signal_to_noise_ratio() and excess_attenuation())
• Fix bug in envelope_correlation()’s internal sliding-window search that never actually slid across candidate alignments
• Fix bug in plot_degradation() and auto_realign() in which an internal dispatch issue caused some of their own argument validation checks to be silently skipped
• Fix bug in synth_sounds() that crashed when called with a single frequency and a single duration
• Fix bug in detection_distance() in which the wl argument was not reaching the internal peak-frequency calculation
• Fix bug in master_sound_file()’s marker creation that corrupted the graphics device stack, causing spurious “cannot shut down device 1 (the null device)” errors in R CMD check on some platforms
• Fix misspelled output column atmopheric.attenuation in attenuation() (now atmospheric.attenuation)
• Fix several smaller documentation inconsistencies (incorrect argument defaults, mislocated columns, stale formulas)
• Reformat all exported function documentation using markdown roxygen for a more consistent and readable reference site
• Vignettes now pull their citation directly from inst/CITATION instead of hardcoded text, and no longer describe a stale version of the example data set

baRulho 2.1.7

CRAN release: 2026-07-24

MINOR IMPROVEMENTS

• Fix bug in manual_realign() that ask for a ‘scores’ column in Y

• Improve argument validation

baRulho 2.1.6

CRAN release: 2025-10-24

MINOR IMPROVEMENTS

• Improve documentation of several functions

baRulho 2.1.5

CRAN release: 2025-07-17

NEW FEATURES

• new argument freq_range in synth_sounds() to limit the frequency range of modulated sounds
• new function spot_ambient_noise() to find segments of ambient noise to be used as reference by other functions
• new argument seed in add_noise() to let users set a seed for reproducibility (or not)

MINOR IMPROVEMENTS

• Improve error messages for functions working with master annotations
• Remove requirement of “sound.id” column in add_noise() and signal_to_noise_ratio()
• Fix bug in add_noise() in which ‘…’ were not sent internally to signal_to_noise_ratio()
• Improved error message when missing columns in supplied Y data frames

baRulho 2.1.4

MINOR IMPROVEMENTS

• Fix bug in find_markers() and manual_realign() when missing one marker that is not used

baRulho 2.1.3

CRAN release: 2025-01-24

MINOR IMPROVEMENTS

• Improved performance issue of plot_degradation()

baRulho 2.1.2

CRAN release: 2024-08-31

MINOR IMPROVEMENTS

• Improved tracking of progress messages when more than 1 progress bar is used by a process

baRulho 2.1.1

• Update requested by CRAN to fix package reference issue. No changes in the code.

baRulho 2.1.0

CRAN release: 2024-04-21

NEW FEATURES

• new function add_noise() to modifying signal-to-noise ratio by adding synthetic noise
• new function manual_realign() that generates an interactive plot for manual adjustment of time alignments
• new function plot_blur_ratio() that generates plots previously created by blur_ratio() and spectrum_blur_ratio()
• new function plot_degradation() to visually compare sounds across distances
• new function plot_aligned_sounds() to visually assess precision of test sound alignment
• align_test_files() now can take several markers as input and select that with the highest correlation score for aligning test files
• New function attenuation()
• Data frames and selection tables can be used as input data
• Added new methods to blur_ratio() and excess_atenuation()
• spectral_correlation() and spectral_blur_ratio() renamed to spectrum_correlation(), and spectrum_blur_ratio() respectively

MINOR IMPROVEMENTS

• optimize performance in signal_to_noise_ratio()
• atmospheric_attenuation() is no longer available (use attenuation() instead)
• Improved documentation for all functions
• Fix bug in spcc() and excess_attenuation()
• ‘markers’ argument deprecated in align_test_files()
• fix bug in auto_realign()
• find_markers() compares the time difference between markers to that in the master sound file as a measure of precision
• find_markers() can run several markers as templates on the same files
• ‘template.rows’ argument deprecated in find_markers()
• spcc_align() renamed auto_realign()
• search_templates() renamed find_markers()
• ‘output’ argument deprecated
• ‘parallel’ argument deprecated and replaced by ‘cores’

baRulho 1.0.6

CRAN release: 2022-03-01

• Update requested by CRAN

baRulho 1.0.5

CRAN release: 2021-04-21

• Update requested by CRAN

baRulho 1.0.4

CRAN release: 2021-03-09

MINOR IMPROVEMENTS

• warbleR::freq_range_detec() is now used internally to detect frequency range of markers in master_sound_file()

baRulho 1.0.3

CRAN release: 2021-02-11

• Update requested by CRAN

baRulho 1.0.3

CRAN release: 2021-02-11

MINOR IMPROVEMENTS

• New argument ‘marker’ in align_test_files() to control if the start or end marker is being used for aligning
• Fix bug when detecting several templates per sound file in search_templates()

baRulho 1.0.2

CRAN release: 2020-06-07

MINOR IMPROVEMENTS

• Windows length is converted to even in all functions
• Fix sign error in signal amplitude measurements (signal_to_noise_ratio() and excess_attenuation())
• New function noise_profile()
• rename snr() to signal_to_noise_ratio()
• New function tail_to_signal_ratio() to measure reverberations
• Fix bug on excess_attenuation() when method = 1
• Added type argument to excess_attenuation() to run “Darden” version of excess attenuation

baRulho 1.0.1

CRAN release: 2020-03-09

NEW FEATURES

• New function search_templates() to find signals in re-recorded sound files
• New function align_test_files() to set time of signals in aligned re-recorded files
• Parallel available on internal prep_X_bRlo_int() function
• Data frame are also returned by most functions

baRulho 1.0.0

CRAN release: 2020-02-22

• First release