Learn R Programming

⚠️There's a newer version (2.7.2) of this package.Take me there.

R package for sound synthesis and acoustic analysis.
Homepage with help, demos, etc: http://cogsci.se/soundgen.html
Source code on github: https://github.com/tatters/soundgen

Performs parametric synthesis of sounds with harmonic and noise components such as animal vocalizations or human voice. Also includes tools for spectral analysis, pitch tracking, audio segmentation, self-similarity matrices, morphing, etc.

Key functions

  • Sound synthesis from R console: soundgen()
  • Shiny app for sound synthesis (opens in a browser): soungen_app()
  • Acoustic analysis of a wav/mp3 file: analyze()
  • Shiny app for editing intonation contours (opens in a browser): pitch_app()
  • Measuring syllables, pauses, and bursts in a wav/mp3 file: segment()

For more information, please see the vignettes on sound synthesis and acoustic analysis:

vignette("sound_generation", package="soundgen")

vignette("acoustic_analysis", package="soundgen")

Or, to open the vignettes in a browser:
RShowDoc('sound_generation', package = 'soundgen')

RShowDoc('acoustic_analysis', package = 'soundgen')

Example of sound synthesis

Use the soundgen() function to create a breathy moan:

s = soundgen(
  sylLen = 230,               # duration of voiced part, ms
  pitch = c(305, 280),        # pitch, Hz (goes down from 305 to 380 Hz)
  ampl = c(0, -20),           # amplitude, dB (gradual fade-out by 20 dB)
  rolloff = -30,              # strong f0, weak harmonics
  temperature = 0.05,         # some stochasticity in generation
  formants = c(260, 960, 1500, 2200,  # F1-F8 formant frequencies, Hz
               2600, 3600, 4200, 4500),
  noise = data.frame(
    time = c(-50, 120, 700),  # time of noise anchors
    value = c(-15, -5, -50)   # noise amplitude, dB
  ),
  rolloffNoise = 0,           # flat noise spectrum before adding formants
  addSilence = 0, samplingRate = 44100, pitchSamplingRate = 44100,
  play = TRUE, plot = TRUE, osc = TRUE, ylim = c(0, 6)
)

Example of acoustic analysis

Use the analyze() function to detect pitch and obtain other spectral descriptives of the sound we have just synthesized:

a = analyze(s, 44100, ylim = c(0, 6))
#> Scale not specified. Assuming that max amplitude is 1
a[1:5, c('pitch', 'peakFreq', 'harmHeight', 'HNR', 'ampl', 'loudness')]
#>      pitch peakFreq harmHeight       HNR      ampl  loudness
#> 1       NA       NA         NA        NA 0.0305833        NA
#> 2       NA 305.2747         NA  1.083205 0.1442435  9.636858
#> 3 300.0882 305.2747   1197.802 12.934929 0.3642711 17.808124
#> 4 299.4505 305.2747   1197.802 14.042033 0.5131389 22.289716
#> 5 296.0563 305.2747   1110.114 13.450248 0.4959925 22.193244
colnames(a)
#>  [1] "duration"           "duration_noSilence" "time"               "ampl"              
#>  [5] "amplVoiced"         "dom"                "entropy"            "f1_freq"           
#>  [9] "f1_width"           "f2_freq"            "f2_width"           "f3_freq"           
#> [13] "f3_width"           "harmEnergy"         "harmHeight"         "HNR"               
#> [17] "loudness"           "peakFreq"           "pitch"              "quartile25"        
#> [21] "quartile50"         "quartile75"         "specCentroid"       "specSlope"         
#> [25] "voiced"

Installation

To install the current release from CRAN: install.packages("soundgen")

NB: Make sure all dependencies have been installed correctly! For problems with seewave, see http://rug.mnhn.fr/seewave/

On Macs, you may need to do the following:

  • First install brew according to the instructions here: https://brew.sh/
  • Then run the following from the terminal
    brew install libsndfile
    brew install fftw
  • Finally, install soundgen in R:
    install.packages("soundgen")

Copy Link

Version

Install

install.packages('soundgen')

Monthly Downloads

623

Version

1.8.0

License

GPL (>= 2)

Maintainer

Andrey Anikin

Last Published

August 11th, 2020

Functions in soundgen (1.8.0)

HzToSemitones

Convert Hz to semitones
addVectors

Add overlapping vectors
addFormants

Add formants
clumper

Clump a sequence into large segments
beat

Generate beat
analyze

Analyze sound
Mode

Modified mode
analyzeFolder

Analyze folder
analyzeFrame

Analyze fft frame
addPitchCands

Plot pitch candidates
costPerPath

Cost per path
defaults_analyze

Defaults and ranges for analyze()
convert_sec_to_hms

Print time
defaults_analyze_pitchCand

Defaults for plotting with analyze()
costJumps

Cost of jumps
defaults

Shiny app defaults
def_form

Defaults and ranges for formant_app()
crossFade

Join two waveforms by cross-fading
filterMS

Filter modulation spectrum
filterSoundByMS

Filter sound by modulation spectrum
evaluatePars

Evaluate parameters for optimization
fade

Fade
findSyllables

Find syllables
estimateVTL

Estimate vocal tract length
drawContour

Draw contour
compareSounds

Compare sounds (experimental)
getBandwidth

Get bandwidth
generatePath

Generate path
findVoicedSegments

Find voiced segments
generateEpoch

Generate an epoch
generateGC

Generate glottal cycles
gaussianSmooth2D

Gaussian smoothing in 2D
findBursts

Find bursts
findGrad

Find gradient
gaussian.w

Gaussian window
getLoudnessFolder

Loudness per folder
convertStringToFormants

Prepare a list of formants
getFrameBank

Frame bank
getGlottalCycles

Divide f0 contour into glottal cycles
divideIntoSyllables

Syllable structure of a bout
getLoudnessPerFrame

Get loudness per frame
getRMSFolder

RMS amplitude per folder
forcePerPath

Force per path
fart

Fart
flatSpectrum

Flat spectrum
generateNoise

Generate noise
getEntropy

Entropy
filled.contour.mod

Modified filled.contour
generateHarmonics

Generate harmonics
getDom

Get lowest dominant frequency band
downsample

Simple downsampling
getMelSpec

Mel-transformed spectrum
flatEnv

Flat envelope
getDiscreteContour

Discrete smooth contour from anchors
formant_app

Interactive formant tracker
findZeroCrossing

Find zero crossing
getCheckerboardKernel

Checkerboard kernel
getEnv

Get amplitude envelope
getNovelty

SSM novelty
interpolate

Interpolate
getRandomWalk

Random walk
intplPitch

Interpolate pitch contour
getPitchAutocor

Autocorrelation pitch tracker
getFormantDispersion

Get formant dispersion
getIntegerRandomWalk

Discrete random walk
log01

log01
getLoudness

Get loudness
getVocalFry

Subharmonics
ftwindow_modif

Fourier transform windows (seewave)
getRMS

RMS amplitude per frame
getPrior

Get prior for pitch candidates
getVocalFry_per_epoch

Constant subharmonics regime
interpolMatrix

Interpolate matrix
getPitchHps

Harmonic product spectrum
getPitchSpec

BaNa pitch tracker
htmlPlots

HTML for clickable plots
iso226

iso226
getSigmoid

Get sigmoid filter
guessPhase_GL

Guess phase GL
getSmoothContour

Smooth contour from anchors
medianSmoother

Median smoothing
matchPars

Match soundgen pars (experimental)
guessPhase_spsi

Guess phase SPSI
pitchManual

Manual pitch estimation in 260 sounds
pathfinding_slow

Path through pitch candidates: slow
wiggleGC

Wiggle glottal cycles
morphDF

Morph dataframes
pathfinding_fast

Path through pitch candidates: fast
getPitchCep

Cepstral pitch tracker
wiggleAnchors

Randomly modify anchors
morphFormants

Morph formants
logMatrix

Log-warp matrix
pitchContour

Manually corrected pitch contours in 260 sounds
getRolloff

Control rolloff of harmonics
killDC

Kill DC
invertSpectrogram

Invert spectrogram
isCentral.localMax

Simple peak detection
notesDict

Conversion table from Hz to musical notation
osc_dB

Oscillogram on a decibell scale
normalizeFolder

Normalize folder
msToSpec

Modulation spectrum to spectrogram
playme

Play audio
morphList

Morph lists
harmEnergy

Energy in harmonics
getRough

Get roughness
getSmoothSpectrum

Get smooth spectrum
optimizePars

Optimize parameters for acoustic analysis
presets

Presets
sampleModif

sampleModif
splitContour

Split contour
rnorm_truncated

Random draw from a truncated normal distribution
reportTime

Report time
reportCI

Report CI
spreadSpec

Spread spectrum
pDistr

Proportion of total
segmentFolder

Segment all files in a folder
getSpectralEnvelope

Spectral envelope
harmHeight

Height of harmonics
modulationSpectrumFolder

Modulation spectrum per folder
morph

Morph sounds
matchLengths

Resize vector to required length
matchColumns

Match number of columns
osc

Oscillogram
soundgen_app

Interactive sound synthesizer
segmentManual

Manual counts of syllables in 260 sounds
specToMS

Spectrogram to modulation spectrum
switchColorTheme

Switch color theme
spectrogram

Spectrogram
pitchSmoothPraat

Pitch smoothing as in Praat
spectrogramFolder

Save spectrograms per folder
pitch_app

Interactive pitch tracker
parabPeakInterpol

Parabolic peak interpolation
scaleNoiseAnchors

Scale noise anchors
scaleSPL

Scale SPL
to_dB

Convert to dB
pathfinder

Pathfinder
harmHeight_dif

Height of harmonics: difference method
transplantFormants

Transplant formants
transplantEnv

Transplant envelope
harmHeight_peaks

Height of harmonics: peaks method
modulationSpectrum

Modulation spectrum
schwa

Schwa-related formant conversion
mergeSyllables

Merge syllables
lockToFormants

Lock to formants
permittedValues

Defaults and ranges for soundgen()
listDepth

List depth
phon2sone

Convert phon to sone
segment

Segment a sound
reformatAnchors

Reformat anchors
ssm

Self-similarity matrix
reformatFormants

Reformat formants
selfsim

Compute self-similarity
summarizeAnalyze

Summarize the output of analyze()
upsamplePitchContour

Upsample pitch contour
semitonesToHz

Convert semitones to Hz
soundgen

Generate a sound
validatePars

Validate parameters
wigglePars

Wiggle parameters
snake

Snake
updateAnalyze

Update analyze
zeroOne

Normalize 0 to 1
upsample

Upsample pitch contour