This repository includes a Matlab class and a Python module which implement a number of methods/functions for the different algorithms of the REpeating Pattern Extraction Technique (REPET), and Matlab GUIs to demo the original REPET, REPET-SIM, and uREPET.

- [urepet Matlab GUI](#urepet-matlab-gui)

Simple user interface system for recovering patterns repeating in time and frequency in mixtures of sounds.

Functionalities:

- [Open](#open)

- [Save](#save)

- [Play](#play)

- [Select](#select)

- [Zoom](#zoom-2)

- [Pan](#pan-2)

- [uREPET](#urepet)

- [Background](#background)

- [Undo](#undo)

- 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 the processed audio as a WAVE file; the default name is "urepet_file.wav."

- 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.

- 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.

<img src="images/urepet/open_play_select.gif" width="1000">

- 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 view of graph interactively (see https://www.mathworks.com/help/matlab/ref/pan.html)

- If used on the signal axes, pan horizontally only; the x-axis limits of the signal axes and the spectrogram axes will stay synchronized.

<img src="images/urepet/zoom_pan.gif" width="1000">

- 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.

- 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 the last changes done by uREPET.

<img src="images/urepet/select_urepet_background_undo_save.gif" width="1000">