Archives pour la catégorie MEX

Compiler un MEX lié à un Framework avec MATLAB sur Mac OS X

Il est possible de compiler un fichier MEX en le liant à un framework sur Mac OS X. Je vais vous montrer comment en compilant un MEX utilisant les ressources de la bibliothèque SDL2. J’utiliserai MATLAB R2011b et R2014a sur Mac OS X 10.9.3.

Qu’est-ce qu’un framework ?

Un framework est un dossier qui contient des ressources partagées que l’on peut utiliser dans d’autres applications ou codes (lire What are Frameworks?). Dans notre cas, ce sont les bibliothèques partagées et les fichiers d’entêtes qui nous intéressent ici.

Avec MATLAB, l’intérêt est de pouvoir utiliser ces ressources via des fichiers MEX. La difficulté consiste à pourvoir lier ces ressources lors de la compilation avec la commande mex.

Nous prendrons ici l’exemple du framework de la SDL2 (Simple DirectMedia Layer)

Installation du framework de la SDL2

Téléchargez le fichier « SDL2-2.0.3.dmg » (http://www.libsdl.org/download-2.0.php). Une fois téléchargé, cliquez d’une part sur le fichier, ouvrez d’autre part une fenêtre du Finder et rendez-vous dans le dossier « Library > Frameworks ». Cliquez sur le dossier « SDL2.framework » et déplacez le, tout en maintenant le bouton de la souris, dans le dossier Frameworks du Finder :

Installation du framework de la SDL2 sur Mac

La fenêtre suivante apparait :

Mot de passe installation framework sur Mac

Cliquez sur « Authentifier » et entrez votre mot de passe utilisateur.

Voila l’installation du framework est terminée.

Fichier MEX exemple

Nous allons écrire un MEX qui permet d’afficher la version de la SDL et qui fait appel à la fonction SDL_GetVersion.

#include "mex.h"
#include "SDL_version.h"

void mexFunction(int nlhs, mxArray *plhs[],
        int nrhs, const mxArray *prhs[])
       
{
   
    SDL_version ver;
   
    if(nrhs!=0)
        mexErrMsgTxt("Too many input arguments.");
    if(nlhs!=0)
        mexErrMsgTxt("Too many output arguments.");
   
    SDL_GetVersion(&ver);
   
    mexPrintf("SDL version: %u.%u.%u\n", ver.major, ver.minor, ver.patch);

}

Enregistrez ce code dans un fichier getSdlVersion.c

Compilation du MEX

Avec les versions récentes de MATLAB, ici la R2014a :

mex getSdlVersion.c -I/Library/Frameworks/SDL2.framework/Headers LDFLAGS="$LDFLAGS -framework SDL2"

Si vous avez une version plus ancienne de MATLAB et que la commande ci-dessus ne fonctionne pas, essayé ceci :

mex getSdlVersion.c -I/Library/Frameworks/SDL2.framework/Headers /Library/Frameworks/SDL2.framework/SDL2

Note : il y a deux lignes de compilation différentes car Apple a remplacé au fil du temps le compilateur GCC par Clang. Tout dépend donc de la version de MATLAB et de Mac OS X.

Si la compilation réussi, vous obtiendrez un fichier getSdlVersion.mexmaci64 à utiliser comme ceci :

>> getSdlVersion
SDL version: 2.0.3

Conclusion

Vous devriez maintenant pouvoir compiler vos MEX sur Mac en les liant à un framework (voire plusieurs frameworks). Si vous rencontrez des difficultés, n’hésitez pas à venir poser vos questions sur le forum MATLAB.

Récupérer des informations sur le processeur avec MATLAB et la SDL 2

La bibliothèque SDL 2 (Simple DirectMedia Layer) possède quelques fonctionnalités pour récupérer des informations sur le CPU (voir CPU Feature Detection). J’ai donc écrit un fichier MEX qui permet de récupérer ces informations avec MATLAB. Vous pouvez télécharger le code ici.

Il faut installer les outils de développement de la SDL 2 et compiler le fichier MEX avant la première utilisation. Toutes les informations sont contenues dans les entêtes des fichiers getCpuInfoSdl2.m et getCpuInfoSdl2mx.c. Pour les utilisateurs sur Mac, vous pouvez vous référer à ce billet pour la compilation du MEX.

Les information suivantes sont renvoyées :

  • cpuCacheLineSize : taille du cache L1 en Ko
  • cpuCount : nombre de cœurs (Intel hyperthreading compris)
  • systemRAM : quantité de mémoire RAM installée

Le code renvoi également, sous forme de booléens, la disponibilité des jeux d’instructions suivants :

« /usr/bin/ld: cannot find -lstdc++ » : compilation impossible de MEX sur Linux

Suite à une installation toute fraîche de Xubuntu 14.04, plus moyen de compiler le moindre fichier MEX. Que ce soit avec MATLAB R2014a ou R2011b…

calvin-shovel

A chaque fois, le message d’erreur est le suivant :

/usr/bin/ld: cannot find -lstdc++
collect2: ld returned 1 exit status

On trouve de nombreuses discussions autour de ce problème sur Internet. Il y a malheureusement presque autant de propositions de solutions différentes que de discussions.

Pour ma part, la solution était simplement d’installer le paquet g++ :

sudo apt-get install g++

Voila, tout est maintenant rentré dans l’ordre !

8-)