Main Content

Ajouter des bibliothèques à l'explorateur de bibliothèques

Cet exemple montre comment créer une bibliothèque de blocs et l’ajouter à Simulink® Library Browser. Cet exemple explique également comment ajouter une sous-bibliothèque.

Pour fournir des informations à propos de votre bibliothèque, créez une fonction du nom de slblocks.

Ajouter une bibliothèque à l'explorateur de bibliothèques

  1. Sur la page d’accueil de Simulink, dans la zone de recherche, tapez library. Sélectionnez Blank Library, puis cliquez sur Create Library.

    Remarque

    L'explorateur de bibliothèques supporte uniquement les bibliothèques. Vous ne pouvez pas ajouter le contenu d’un modèle dans l’explorateur de bibliothèques.

  2. Ajoutez un bloc Gain à la bibliothèque.

  3. Dans la fenêtre de commande MATLAB®, saisissez cette commande afin de définir la propriété de bibliothèque EnableLBRepository sur 'on'. Votre bibliothèque n’apparaît dans l’explorateur de bibliothèques que si cette propriété est activée lorsque vous enregistrez votre bibliothèque.

    set_param(gcs,'EnableLBRepository','on');

  4. Enregistrez la bibliothèque dans un dossier situé dans le répertoire MATLAB. Pour cet exemple, attribuez à la bibliothèque le nom de mylib.

  5. Dans l’explorateur des dossiers actuels de MATLAB, ouvrez le dossier qui contient mylib, puis, dans MATLAB Toolstrip, cliquez sur New Script.

  6. Dans l’éditeur MATLAB qui apparaît, ajoutez cette fonction qui indique que la bibliothèque mylib doit apparaître dans l’explorateur de bibliothèques sous le nom de My Library.

    function blkStruct = slblocks
% This function specifies that the library 'mylib'
% should appear in the Library Browser with the 
% name 'My Library'

    Browser.Library = 'mylib';
    % 'mylib' is the name of the library

    Browser.Name = 'My Library';
    % 'My Library' is the library name that appears
    % in the Library Browser

    blkStruct.Browser = Browser;

  7. Enregistrez la fonction sous slblocks.m.

    Remarque

    Vous pouvez enregistrer la fonction au format de fichier .m ou .mlx. Vous ne pouvez pas enregistrer la fonction en tant que fichier P-code.

  8. Pour ouvrir l'explorateur de bibliothèques, dans Simulink Toolstrip, cliquez sur Library Browser.

  9. Pour voir la nouvelle bibliothèque dans l’explorateur de bibliothèques, cliquez avec le bouton droit de la souris sur la liste de bibliothèques et sélectionnez Refresh Library Browser.

    The Library Browser tree shows a library with the name My Library. My Library is expanded in the tree, and beneath the library name, there is a Gain block.

    La figure présente un exemple de bibliothèque mylib répondant au nom de My Library dans l’explorateur de bibliothèques.

Remarque

Si vous enregistrez votre bibliothèque sans configurer 'EnableLBRepository' sur 'on', un message apparaît en haut de l’explorateur de bibliothèques.

At the top of the Library Browser in docked mode, there is a message that says "Some libraries are missing repository information. Fix" The word "Fix" is a hyperlink.

Cliquez sur Fix et répondez au message comme il se doit.

Ajouter une sous-bibliothèque à l'explorateur de bibliothèques

Pour ajouter une sous-bibliothèque du nom de mylib2 à votre bibliothèque mylib, procédez comme suit.

  1. Créez une bibliothèque du nom de mylib2. Ajoutez-y des blocs.

  2. Dans la fenêtre de commande MATLAB, configurez la propriété de bibliothèque EnableLBRepository sur 'on' pour la nouvelle bibliothèque. 

    set_param(gcs,'EnableLBRepository','on');

  3. Enregistrez mylib2 dans le dossier qui contient mylib.

  4. Ajoutez un bloc Subsystem à la bibliothèque mylib.

  5. Retirez les ports d’entrée et de sortie du sous-système en supprimant les blocs Inport et Outport au sein du sous-système.

  6. Attribuez au bloc Subsystem le nom My Sublibrary.

  7. Pour lier le bloc Subsystem à la sous-bibliothèque, définissez le callback OpenFcn sur mylib2 au moyen du Property Inspector.

    The Property Inspector lets you set the OpenFcn callback on the Properties tab.

  8. Enregistrez mylib.

  9. Pour voir la nouvelle sous-bibliothèque dans l’explorateur de bibliothèques, cliquez avec le bouton droit de la souris sur la liste de bibliothèques et sélectionnez Refresh Library Browser.

    In the Library Browser tree, My Library is expanded. My Library contains a Gain block and a sublibrary called My Sublibrary. My Sublibrary is expanded and contains a Ramp block, a Sine Wave block, and a Step block.

    La figure présente un exemple de sous-bibliothèque mylib2 répondant au nom de My Sublibrary dans l’explorateur de bibliothèques.

    Du fait du callback que vous avez créé, le développement de My Sublibrary affiche le contenu de la bibliothèque mylib2.

Préciser l’ordre des bibliothèques dans la liste des bibliothèques

Vous pouvez préciser l’ordre de votre bibliothèque par rapport aux autres qui figurent dans la liste en ajoutant un fichier sl_customization.m au chemin d’accès MATLAB et en définissant la priorité de tri de votre bibliothèque. Par exemple, pour que votre bibliothèque apparaisse en haut de la liste, vous pouvez définir la priorité de tri sur -2. Par défaut, la priorité de tri de la bibliothèque Simulink est -1. Les autres bibliothèques présentent par défaut une priorité de tri de 0. Ces bibliothèques apparaissent par conséquent sous la bibliothèque Simulink. Les bibliothèques présentant la même priorité de tri apparaissent dans l’ordre alphabétique.

Cet exemple de contenu du fichier sl_customization.m place la nouvelle bibliothèque en haut de la liste des bibliothèques. 

function sl_customization(cm)
% Change the order of libraries in the Simulink Library Browser. 
cm.LibraryBrowserCustomizer.applyOrder({'My Library',-2});
end

Pour faire en sorte que la personnalisation soit appliquée immédiatement, dans la fenêtre de commande MATLAB, saisissez :

sl_refresh_customizations

My Library appears at the top of the Library Browser tree

Sujets associés