Getting Started - Gforge
Contents
1. 13 5 7 Reconstructing a signal mprecons reconstructs the signal from the given book sigrec mprecons book 5 8 Finding further informations on MPTK for Matlab For further informations on how to use MPTK Matlab functionalities please refer to the Chapter of the User Manual 14 6 MPTK command line utilities 6 1 List of commands Here is a list of the MPTK command line utilities mpd decompose a waveform signal using matching pursuit gpd decompose a waveform signal using gradient pursuit mpd_demix decompose a waveform signalusing matching pursuit and a mixer matrix mpf filters the atoms contained in books mpr reconstructs a signal from the atoms contained in a book mpcat concatenates any number of books into one mpview makes a time frequency pixmap 6 2 Basic example Here is a simple example on how to use MPTK with terminal commands mpd command iterates Matching Pursuit on signal sndFileToDecomp wav with dictionary dictFile xml and gives the resulting book bookFile bin and an optional residual signal after N iterations or after reaching the signal to residual ratio SNR mpd s 10 R 10 d dictFile xml sndFileToDecomp wav bookFile bin mpr commands rebuilds a signal sndReconsFile wav from the atoms contained in the book file bookFile bin An optional residual sndResidFile wav can be added mpr bookFile bin sndReconsFile wav sndResidFile wav2. MPTK binary v v v i386 x86_64 Windows exe 1 Accept the terms of the licence agreement 2 Select the path folder where to install MPTK we ll call it path to MPTK e We suggest to use the default folder C Program Files MPTK 3 Finish the installation Installation de MPTK Installation de MPTK Licence utilisateur Choisissez le dossier d installation Veuillez examiner les termes de la licence avant d installer MPTK Choisissez le dossier dans lequel installer MPTK Ceci installera MPTK dans le dossier suivant Pour installer dans un autre dossier cliquez sur Parcourir et choisissez un autre dossier Cliquez sur Suivant pour continuer Appuyez sur Page Suivante pour lire le reste de la licence utilisateur GNU GENERAL PUBLIC LICENSE Version 2 June 1991 ID Copyright C 1989 1991 Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed Dossier d installation Preamble The licenses for most software are designed to take away your v Si vous acceptez les conditions de la licence utilisateur cliquez sur J accepte pour continuer 4 Espace requis 12 1Mo Vous devez accepter la licence utilisateur afin d installer MPTK Espace disponible 27 1Go lt Pr c dent Jaccepte Annuler lt Pr c dent Suivant gt A
3. information Some book examples are available under path_to MPTK mptk reference book mpf commands filters the atoms contained in bookFile bin or stdin stores those which satisfy the indicated properties in bookYes bin or stdout and the others in bookNo bin mpf Freg 0 110 len 0 256 bookFile bin book Yes bin bookNo bin 6 3 Finding further informations on MPTK cmd line For further informations on how to use MPTK command line utilities please refer to the Chapter of the User Manual 15 7 Source installation The source installation archive file https gforge inria fr frs group_id 36 is available un der gforge website This kind of installation is recommended for e Whoever have problems installing the binary files e Whoever wants to help developing MPTK and or adding new functionalities to MPTK For further information on how to pre build with cmake build and install MPTK from the source files please refer to the chapter Download amp install from source of the Usermanual documentation situated under gforge website https gforge inria fr docman group_id 36 or under the documentation directory MPTK UserManual 16 8 Help contact and forums If you need help with the software 1 Check if a more recent release fixes your problem https gforge inria fr frs group_id 36 2 Check if somebody else has had a samilar problem and if a fix exist on the help forum
4. https gforge inria fr forum forum php forum_id 109 3 If not post a message on the help forum If you need documentation about the software Some articles exposing scientific results related to MPTK are available in PDF format through the following page https gforge inria fr docman group_id 36 If you want specific information You can write to us to matching pursuit irisa fr Request for help sent to this address won t be answered Please use the Help forum instead Thank you for your interest in The Matching Pursuit ToolKit 17
5. sections e Downloading and installing MPTK depending on the system OS e Understanding the basic usage of MPTK with command line tools e Understanding the basic usage of MPTK within Matlab If you need more specific details about any part of this Getting Started document please refer to the following chapters of the User manual document e Chapter for how to pre build build and install MPTK from the source files e Chapter amp for how to use MPTK with command line tools e Chapter amp for how to use MPTK within Matlab The User manual document can be downloaded here e https gforge inria fr docman group id 36 Part I Installing MPTK 2 MPTK for Windows 2 1 Downloading MPTK The latest version of MPTK is available at https gforge inria fr frs group id 36 De pending on the processor architecture of your computer you will have to download either the 32 bits package or the 64 bits package e For Windows 32 bits MPTK binary v v v i386 Windows exe e For Windows 64 bits MPTK binary v v v x86 64 Windows exe Hint To find the processor architecture of your computer e Open a terminal command using Start gt All Programs gt Accessories Command Prompt e Use the following command echo APROCESSOR_ARCHITECTURE If the answer is r86 then your OS is 32 bits If the answer is AMD64 then your OS is 64 bits 2 2 Installing MPTK When double clicking the executable
6. windows names that can be used to through the signal waveform The example or default environment paths mptkInfo getmptkinfo 5 3 Reading a signal sigread command reads an imports signal exampleSignal of any format supported by lib sndfile library to Matlab and gives a matrix signal numSamples x numChans and the sampling frequency of the read signal sampleRate signal sampleRate sigread mptkInfo path exampleSignal 5 4 Reading a dictionary dictread command imports a dictionary description defaultDict to Matlab and gives a dictionary description with the following structure dict block i block where for example block type dirac dict dictread mptkInfo path default Dict 5 5 Decomposing a signal mpdecomp command decompose a signal Signal using its sampling frequency sampleR ate a dictionary structure dict performing numlter iterations and gives the resulting decomposition book the residual obtained after the iterations and decay a vector with the energy of the residual after each iteration book residual decay mpdecomp signal sampleRate dict numlter 5 6 Plotting a book bookover plots the given book over a STFT spectrogram of the given Signal for channel numChan or 1 for default The book and or the signal can be given as filenames WAV format for the signal figure 5 bookover book signal
7. ging it is not allowed ai HD pachamama 187 Go disponibles 297 Go au total Preamble The licenses for most software are designed to take away your freedom to share and change it By contrast the GNU General Public License is intended to guarantee your freedom to share and change free software to make sure the software is free for all its users This General Public License applies to most of the Free Software Foundation s software and to any other program whose authors commit to using it Some other Free Software Foundation software is covered Y by the GNU Library General Public License instead You can anolvitto installation de ce logiciel requiert 5 6 Mo d espace libre Vous avez choisi d installer ce logiciel sur le volume HD pachamama 4 Imprimer C Enregistrer Revenir 4 C Continuer Revenir Continuer Figure 4 1 Licence agreement Figure 4 2 Path folder selection 4 4 Configuring the path An environment variable called MPTK CONFIG FILENAME needs to be set either temporary either permanently with the path of the path xml file located in the path to MPTK mptk directory This file defines the environment paths that MPTK needs to work properly 4 4 1 Temporary path configuration Here is the way to temporary configure the MPTK CONFIG FILENAME environment variable Warning This is a temporary setting and it needs to be done at each reset of the compute
8. informatics mathematics UA METISS TEAM The Matching Pursuit Tool Kit Getting Started Authors Contributors Sacha KRSTULOVIG Ronan LE BOULCH R mi GRIBONVAL Benjamin Roy March 1 2012 Contents 1 Introduction 1 1 Learning about MPTK The Matching Pursuit Tool Kit MPTK provides a fast implementation of the Matching Pursuit algorithm for the sparse decomposition of multichannel signals such as audio signals It comprises a library standalone utilities and Matlab scripts MPTK provides an implementation of Matching Pursuit which is e FAST e g extract 1 5 million atoms from a 1 hour long 16kHz audio signal 15dB extracted in 0 25x real time on a Pentium IV 2 4GHz out of a dictionary of 178M Gabor atoms Such incredible speed makes it possible to process real world signals e FLEXIBLE multi channel various signal input formats flexible syntax to describe the dictionaries gt reproducible results cleaner experiments e OPEN modular architecture add your own atoms Free distribution under the GPL MPTK is mainly developed and maintained within the METISS Research Group http www irisa fr metiss on audio signal processing at the INRIA Research Institute http www irisa fr or http www inria fr rennes in Rennes France 1 2 Reading this document This document describes the basic principles about how to download install and use the Matching Pursuit Tool Kit It is divided into two major
9. lugins anywave anywavehilbert constant dirac gabor harmonic mclt mdct mdst nyquist As well as information on the path where reference files can be found path to MPTK mptk reference which can be used to find examples of dictionaries dic anywave xml dic constant xml dic harmonic xml dic_mdst xml dic anywave modifie xml dic_dirac xml dic mclt xml dic nyguist xml dic chirp xml dic gabor two scales xml dic mdct two scales xml dic_test xml 2nd part description Description of the tutorials There are several tutorials on using MPTK4Matlab 1 Dictionaries Books Running Matching Pursuit Toolkit Multichannel decompositions in preparation Anywave atoms in preparation 6 Demixing pursuit in preparation OT O E Dictionaries How to read dictread create dictwrite a dictionary description Books What is a book storage format for sparse signal representations and how to read bookread save bookwrite or plot any book bookplot bookover Running MPTK Procedure to follow if you want to decompose a signal e Read a signal sigread e Read a dictionary dictread e Decompose the signal mpdecomp 12 5 2 Getting the environment information getmptkinfo command is launched under the GettingStarted m script and is used to retrieve the environment datas such as The plugins atoms names available The block parameters needed to correctly define each atom The
10. n 1 0 23 pre compiled library e FFTW tested with version 3 2 2 pre compiled library You can see below some examples about how to download those libraries using terminal Ubuntu Fedora Mandriva sudo apt get install y qq libsndfile1 dev sudo yum y gg install libsndfile devel sudo smart install y gg libsndfile1 dev sudo apt get install y gg libfftw3 dev sudo yum y gg install fftw devel sudo smart install y gg libfftw3 dev sudo yum y gg install fftw static 3 3 Installing MPTK Depending on the type of Linux you have there ares two ways to install the packages e for rpm package rpm ivh MPTK binary v v v 1386 x86_64 Linux rpm e for deb package dpkg i MPTK binary v v v 1386 186 64 Linuzx deb 3 4 Configuring the path An environment variable called MPTK_CONFIG_FILENAME needs to be set either temporarily either permanently with the path of the path xml file located in the path to MPTK mptk directory This file defines the environment paths that MPTK needs to work properly 3 4 1 Temporary path configuration Here is the way to temporarily configure the MPTK CONFIG FILENAME environment variable Warning This is a temporary setting and it needs to be done at each reset of the computer e With Bash shell export MPTK_CONFIG_FILENAME path to MPTK mptk path zml e With C shell setenv MPTK_CONFIG_FILENAME path to MPTK mptk path zml e You can check if the e
11. nnuler Figure 2 1 Licence agreement Figure 2 2 Path folder selection 2 3 Configuring the path An environment variable called MPTK CONFIG FILENAME needs to be set either temporarily or permanently with the path of the path xml file located in the path to MPTK mptk directory This file defines the environment paths that MPTK needs to work correctly 2 3 1 Temporary path configuration Here is the way to temporarily configure the MPTK CONFIG FILENAME environment variable Warning This is a temporary setting and it needs to be done at each reset of the computer e Open a terminal command using Start gt All Programs Accessories Command Prompt e Use the command set MPTK_CONFIG_FILENAME path to MPTK mptk path zml Figure 2 3 Filled command prompt 2 3 2 Permanent path configuration Here is the way to permanently configure the MPTK_CONFIG_FILENAME environment variable e Check if the environment variable is correctly set with echo MPTK_CONFIG_FILENAME e Open the environment variable configuration panel situated under Start Config panel System gt Advanced gt Environment variables e Add a new user variable with Name MPTK_CONFIG_FILENAME Value path to MPTK mptk path zml Variables d environnement Variables utilisateur pour rleboulc Variables systeme Variable valeur EN ComSpec C WINDOWS system32 cmd exe NO os gt Windows NT Path CAWINDOWS
12. nvironment variable is correctly set with echo MPTK_CONFIG_FILENAME 3 4 2 Permanent path configuration In order to permanently configure the MPTK_CONFIG_FILENAME environment variable add the bash shell or the C shell configuration line to the bashrc or the cshrc file situated under your home directory 3 4 3 Matlab path configuration When launching Matlab the user needs to configure Matlab to work with MPTK e Configure the working path either by Selecting the current folder as path to MPTK mptk matlab Adding the working path using addpath path to MPTK mptk matlab 4 MPTK for Mac OS 4 1 Downloading MPTK The latest version of MPTK is available at https gforge inria fr frs group id 36 De pending on the processor architecture of your computer you will have to download either the 32 bits package or the 64 bits package e For Mac 32 bits MPTK binary v v v i386 Mac exe e For Mac 64 bits MPTK binary v v v x86 64 Mac exe Hint To find the processor architecture of your computer e Open a terminal command and use the following command uname m If the answer is i886 then your OS is 32 bits If the answer is 186 64 then your OS is 64 bits 4 2 Obtaining additional required packages Two additional packages are needed Their installation require administrator privileges on the machine The sudo command may ask you to input administrator passwo
13. r e With Bash shell export MPTK CONFIG FILENAME usr local mptk path xml e With C shell setenv MPTK CONFIG FILENAME usr local mptk path xml e You can check if the environment variable is correctly set with echo MPTK_CONFIG_FILENAME 4 4 2 Permanent path configuration In order to permanently configure the MPTK CONFIG FILENAME environment variable add the bash shell or the C shell configuration sentence to the bashrc or the cshrc file situated under your home directory 4 4 3 Matlab path configuration When launching Matlab the user needs to configure Matlab to work with MPTK e Configure the working path either by Selecting the current folder as usr local mptk matlab Adding the working path using addpath usr local mptk matlab 10 Part II Using MPTK 5 MPTK from within Matlab In the following we assume that MPTK has been installed correctly that the system path configuration has been set and that Matlab is installed 5 1 Getting Started GettingStarted command is used for a better understanding of MPTK functionalities This script is divided in two parts The first part consists in retrieving the environment informa tions and the available plugins The second part consists in describing several tutorials about MPTK utilities 1st part description Example of available plugins and dictionaries Here is the list of types of atoms available in MPTK p
14. rd e Libsndfile tested with version 1 0 23 pre compiled library e FFTW tested with version 3 2 2 pre compiled library You can see below some examples about how to download those libraries using terminal Mac sudo opt local bin port install libsndfile universal sudo opt local bin port install fftw 3 universal Hint We suggest to use the port command from MacPorts because the command uni versal allows to retrieve libraries which are compatible with both system architectures 32 bits and 64 bits The package is available at http www macports org install php 4 3 Installing MPTK When double clicking the executable MPTK binary v v v i386 x86_64 Mac dmg 1 Accept the terms of the licence agreements 2 Accept the path folder where to install MPTK e The default and unique folder is usr local 3 Finish the installation 000 amp Installer MPTK Contrat de licence Selectionner une destination S lectionnez le volume sur leguel vous souhaitez installer English I a 6 Introduction Introduction le logiciel MPTK GNU GENERAL PUBLIC LICENSE Lisez moi Version 2 June 1991 0 Lisez moi Licence Q Copyright C 1989 1991 Free Software Foundation Inc Licence Y O Destinati a Y 59 Temple Place Suite 330 Boston MA 02111 1307 USA e Destination 4 Everyone is permitted to copy and distribute verbatim copies W of this license document but chan
15. system32 C WINDOWS YA Nouveau modifier Supprimer Annular Figure 2 4 Environment variable configuration 2 3 3 Matlab path configuration When launching Matlab the user needs to configure Matlab to work with MPTK e Configure the working path either by Selecting the current folder as path to MPTK mptk matlab Adding the working path using addpath path to MPTK mptk matlab 3 MPTK for Linux 3 1 Downloading MPTK The latest version of MPTK is available at https gforge inria fr frs group id 36 De pending on the processor architecture of your computer download either the 32 bits package or the 64 bits package e For RedHat Suse Fedora Mandriva 32 bits MPTK binary v v v i386 Linux rpm 64 bits MPTK binary v v v x86_64 Linux rpm e For Debian Knoppix Ubuntu 32 bits MPTK binary v v v i386 Linux deb 64 bits MPTK binary v v v x86_64 Linux deb Hint To find the processor architecture of your computer e Open a terminal command and use the following command uname m If the answer is i886 then your OS is 32 bits If the answer is 186 64 then your OS is 64 bits 3 2 Obtaining additional required packages Two additional packages are needed Their installation require administrator privileges on the machine The sudo command may ask you to input administrator password e Libsndfile tested with versio
Download Pdf Manuals
Related Search