Skip to content

zafarrafii/uREPET-Matlab

Repository files navigation

uREPET-Matlab

Matlab GUI for uREPET, a simple user interface system for recovering patterns repeating in time and frequency in mixtures of sounds.

Files:

See also:

urepet.m

Functionalities:

Open

  • Select a WAVE or MP3 to open; the audio can be mono or stereo.
  • Display the audio signal and the audio spectrogram; the x-axis limits of the signal axes and the spectrogram axes will be synchronized (and will stay synchronized if a zoom or pan is applied on one of them).

Save

  • Save the processed audio as a WAVE file; the default name is "urepet_file.wav."

Play

  • Play the audio if the playback is not in progress; stop the audio if the playback is in progress; a playback line will be displayed as the playback is in progress.
  • If there is no selection line or region, the audio will be played from the start to the end; if there is a selection line, the audio will be played from the selection line to the end of the audio; if there is a selection region, the audio will be played from the start to the end of the selection region.
  • Pressing the space key will also play and stop the audio.

Select

  • If a left mouse click is done on the signal axes, a selection line is created; the audio will be played from the selection line to the end of the audio.
  • If a left mouse click and drag is done on the signal axes or on a selection line, a selection region is created; the audio will be played from the start to the end of the selection region.
  • If a left mouse click and drag is done on the left or right boundary of a selection region, the selection region is resized.
  • If a right mouse click is done on the signal axes, any selection line or region is removed.
  • If a left mouse click and drag is done on the spectrogram axes, a customizable rectangle is created; the region-of-interest (ROI) can then be processed by clicking on the uREPET button; the rectangle can be resized and moved, and also deleted by doing a right mouse click on it.

Zoom

  • Turn zooming on or off or magnify by factor (see https://mathworks.com/help/matlab/ref/zoom.html)
  • If used on the signal axes, zoom horizontally only; the x-axis limits of the signal axes and the spectrogram axes will stay synchronized.

Pan

uREPET

  • Apply uREPET to the audio, after selecting an ROI on the spectrogram axes, by searching for similar regions repeating in time and frequency and recovering the common background if the background button is selected, or the common foreground if the background button is deselected.

Background

  • If selected, uREPET will recover the repeating background in the ROI (default); if deselected, uREPET will recover the non-repeating foreground in the ROI.

Undo

  • Undo the last changes done by uREPET.

Audio files

  • audio_file.wav: 23 second audio excerpt from the song Que Pena Tanto Faz performed by Tamy.
  • melody&cough.wav: piano melody with a cough masking the first note.
  • accompaniment&vocals.wav: song excerpt with female vocals on a guitar accompaniment.
  • speech&noise.wav: male speech being masked by an alarm noise.

CQT_toolbox_2013

See: https://www.cs.tut.fi/sgn/arg/CQT/

References

  • Zafar Rafii, Antoine Liutkus, and Bryan Pardo. "A Simple User Interface System for Recovering Patterns Repeating in Time and Frequency in Mixtures of Sounds," 40th IEEE International Conference on Acoustics, Speech and Signal Processing, Brisbane, Australia, April 19-24, 2015. [article][poster]

  • Christian Schorkhuber and Anssi Klapuri. "Constant-Q Transform Toolbox for Music Processing," AES 53rd International Conference on Semantic Audio, London, UK, January 26-29, 2014. [article][website]

Author