Ajouter des bibliothèques à l’explorateur de bibliothèques et au menu d’insertion rapide

Ouvrir le script

Cet exemple montre comment ajouter une bibliothèque à Simulink® Library Browser et comment configurer un bloc de bibliothèque pour l’ajouter au menu d’insertion rapide.

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

L’explorateur de bibliothèques affiche une arborescence des bibliothèques disponibles sur votre système que vous pouvez parcourir pour ajouter des blocs à vos modèles.

Pour ajouter une bibliothèque personnalisée à l’explorateur de bibliothèques, procédez comme suit :

1. Chargez une bibliothèque existante myLib et déverrouillez-la. Vous pouvez également créer une nouvelle bibliothèque. Pour plus d’informations, consultez Create Custom Library.

load_system("myLib")
set_param("myLib","Lock","off")

2. Pour afficher les annotations dans l’explorateur de bibliothèques, ajoutez des annotations de texte ou d’image dans la bibliothèque, faites un clic droit dessus et sélectionnez Show in Library Browser. Pour plus d’informations sur la procédure à suivre pour définir des annotations dans un modèle, consultez la rubrique Annotate Models.

Vous pouvez organiser les blocs et les annotations dans l’ordre de votre choix dans votre bibliothèque. Par défaut, ils apparaissent par ordre alphabétique dans l’explorateur de bibliothèques, les sous-systèmes étant répertoriés en premier, suivis des blocs, puis des annotations. Les utilisateurs de votre bibliothèque peuvent utiliser le menu contextuel de l’explorateur de bibliothèques pour basculer entre l’ordre alphabétique et l’ordre que vous avez spécifié. Lorsque les utilisateurs choisissent l’ordre que vous avez spécifié, l’organisation dans votre bibliothèque détermine leur affichage dans la grille de l’explorateur de bibliothèques.

3. Dans la fenêtre de commande MATLAB®, saisissez cette commande afin de définir la propriété de bibliothèque EnableLBRepository sur on.

set_param("myLib","EnableLBRepository","on");

Votre bibliothèque n’apparaît dans l’explorateur de bibliothèques que si cette propriété est activée lors de l’enregistrement de votre bibliothèque.

4. Enregistrez la bibliothèque dans un dossier situé dans le chemin d’accès MATLAB ou ajoutez son emplacement au chemin d’accès MATLAB.

save_system("myLib");

5. Pour spécifier comment votre bibliothèque personnalisée doit apparaître dans l’explorateur de bibliothèques, procédez comme suit :

Créez un nouveau script slblocks dans le dossier qui contient votre bibliothèque personnalisée.
Ajoutez cette fonction pour indiquer que la bibliothèque personnalisée myLib doit apparaître sous le nom de My Library dans l’explorateur de bibliothèques :

function blkStruct = slblocks
Browser.Library = "myLib";
Browser.Name = "My Library";
blkStruct.Browser = Browser;

Enregistrez slblocks. Vous pouvez enregistrer le fichier en tant que fichier .m ou .mlx, mais pas en tant que fichier P-code.

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

7. Pour afficher la nouvelle bibliothèque dans l’explorateur de bibliothèques, faites un clic droit sur la liste de bibliothèques dans l’explorateur de bibliothèques et sélectionnez Refresh Library Browser.

Notez que si vous enregistrez une bibliothèque personnalisée sans configurer EnableLBRepository sur On, un message apparaîtra en haut de l’explorateur de bibliothèques. Cliquez sur Fix et répondez au message comme il se doit.

Ajouter une sous-bibliothèque à l’explorateur

Si votre bibliothèque contient plusieurs blocs, vous pouvez améliorer son organisation en regroupant les blocs associés dans des blocs Subsystem distincts afin de créer des sous-bibliothèques.

Pour créer une sous-bibliothèque dans la bibliothèque myLib, procédez comme suit :

Ajoutez un bloc Subsystem nommé Basic Signals.
Dans Basic Signals, supprimez les blocs Inport et Outport par défaut. Si les ports d’entrée et de sortie de tous les blocs à l’intérieur d’un bloc Subsystem sont connectés, le bloc Subsystem est considéré comme un bloc de bibliothèque réutilisable et non comme une bibliothèque référencée.
Ajoutez des blocs Step, Ramp et Sin dans le bloc Basic Signals.
Vous pouvez également créer un masque pour le bloc Subsystem afin d’afficher du texte ou une image qui décrivent l’objectif de la bibliothèque. Cependant, le masque ne peut posséder qu’une seule icône. Si vous ajoutez du code ou des paramètres dans le masque du bloc Subsystem, le bloc Subsystem sera considéré comme un bloc de bibliothèque réutilisable et non comme une bibliothèque référencée.
Enregistrez myLib.
Pour voir la sous-bibliothèque dans l’explorateur de bibliothèques, faites un clic droit sur la liste de bibliothèques et sélectionnez Refresh Library Browser.

Considérations relatives à l’utilisation de sous-bibliothèques

Si le nom du bloc Subsystem contient le mot Examples (en majuscules), l’explorateur de bibliothèques affichera le sous-système sous forme de bloc et non sous forme de sous-bibliothèque.
Si vous créez une hiérarchie de sous-systèmes dans une bibliothèque, vous devez utiliser des noms de sous-système uniques. Par exemple, ne créez pas une hiérarchie de type SubsystemA/SubsystemB/SubsystemA.

Définir l’ordre des bibliothèques dans la liste des bibliothèques

Vous pouvez spécifier l’ordre dans lequel votre bibliothèque doit apparaître par rapport aux autres bibliothèques dans l’explorateur de bibliothèques. Par défaut, la bibliothèque Simulink apparaît en haut de la liste avec une priorité de tri de -1. Les autres bibliothèques possèdent une priorité de tri de 0 et apparaissent sous la bibliothèque Simulink. Pour que votre bibliothèque apparaisse en haut de la liste, définissez sa priorité de tri sur -2. Les bibliothèques possédant la même priorité de tri sont triées dans l’ordre alphabétique.

Pour définir la priorité de tri d’une bibliothèque, ajoutez un fichier sl_customization.m au chemin d’accès MATLAB. Cet exemple de contenu du fichier sl_customization place la bibliothèque My Library en haut de la liste des bibliothèques :

function sl_customization(cm)
cm.LibraryBrowserCustomizer.applyOrder({'My Library',-2});
end

Pour appliquer immédiatement la personnalisation, utilisez la commande suivante dans la fenêtre de commande MATLAB :

sl_refresh_customizations

Ajouter des blocs de bibliothèque au menu d’insertion rapide

Vous pouvez ajouter des mots clés à un bloc dans votre bibliothèque et les utiliser pour insérer des blocs de bibliothèque dans un modèle à partir du menu d’insertion rapide. Le menu d’insertion rapide vous permet d’ajouter des blocs directement à un modèle sans quitter le canevas. Pour cela, il vous suffit de cliquer sur le canevas pour ouvrir le menu d’insertion rapide et commencer à saisir le mot clé ou le nom du bloc.

Pour ajouter des mots clés à un bloc dans une bibliothèque personnalisée, procédez comme suit :

1. À l’aide de la fonction set_param, définissez le paramètre BlockKeywords du bloc Gain :

set_param('myLib/Gain','BlockKeywords',["My Gain", "Your Gain"])

2. Enregistrez la bibliothèque.

save_system("myLib")

3. Actualisez l’explorateur de bibliothèques pour mettre à jour le menu d’insertion rapide avec les nouveaux mots clés.

4. Vous pouvez désormais ajouter le bloc Gain à votre modèle en saisissant le nom du bloc ou l’un des mots clés dans le menu d’insertion rapide.

Considérations relatives à l’utilisation du menu d’insertion rapide

Les caractères spéciaux « & », « ( », « ) », « + », « @ » et « ! » sont supportés dans les mots clés.
Vous ne pouvez pas ajouter de mots clés aux blocs de la section Commonly Used Blocks, car celle-ci sert à afficher les blocs fréquemment utilisés provenant de différentes bibliothèques. Si vous souhaitez ajouter des mots clés à un bloc disponible dans la section Commonly Used Blocks, vous devez les ajouter dans la bibliothèque dans laquelle le bloc a été défini.
Le menu d’insertion rapide supporte la recherche de blocs à l’aide de mots clés saisis dans des langues autres que l’anglais en utilisant des mots clés internationalisés.

Voir aussi

Outils

Library Browser