Main Content

Hinzufügen von Bibliotheken zum Library Browser

Dieses Beispiel zeigt, wie Sie eine Block-Bibliothek erstellen und dem Simulink® Library Browser hinzufügen können. Dieses Beispiel zeigt zudem, wie Sie eine Unterbibliothek hinzufügen können.

Erstellen Sie eine Funktion namens slblocks, um Informationen zu Ihrer Bibliothek anzugeben.

Hinzufügen einer Bibliothek zum Library Browser

  1. Geben Sie auf der Simulink-Startseite im Suchfeld library ein. Wählen Sie Blank Library aus und klicken Sie auf Create Library.

    Hinweis

    Der Library Browser unterstützt nur Bibliotheken. Im Library Browser können keine Modellinhalte angezeigt werden.

  2. Fügen Sie der Bibliothek einen Gain-Block hinzu.

  3. Geben Sie im MATLAB®-Befehlsfenster diesen Befehl ein, um die Bibliothekseigenschaft EnableLBRepository auf 'on' zu setzen. Ihre Bibliothek erscheint nur im Library Browser, wenn diese Eigenschaft beim Speichern Ihrer Bibliothek aktiviert ist.

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

  4. Speichern Sie die Bibliothek in einem Ordner im MATLAB-Verzeichnis. Nennen Sie die Bibliothek für dieses Beispiel mylib.

  5. Öffnen Sie im MATLAB Current Folder Browser den Ordner, der mylib enthält. Klicken Sie daraufhin in der MATLAB-Symbolleiste auf New Script.

  6. Der MATLAB Editor wird geöffnet. Fügen Sie hier diese Funktion hinzu, die festlegt, dass die Bibliothek mylib im Library Browser unter dem Namen My Library angezeigt werden sollte.

    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. Speichern Sie die Funktion als slblocks.m.

    Hinweis

    Sie können die Funktion als .m- oder .mlx-Datei speichern. Sie können die Funktion nicht als P-Code-Datei speichern.

  8. Um den Library Browser zu öffnen, klicken Sie in der Simulink-Symbolleiste auf Library Browser.

  9. Um die neue Bibliothek im Library Browser zu betrachten, klicken Sie rechts auf die Bibliotheksliste und wählen Sie Refresh Library Browser aus.

    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.

    In der Abbildung ist die Beispiel-Bibliothek mylib mit dem Namen My Library im Library Browser dargestellt.

Hinweis

Wenn Sie die Bibliothek speichern, ohne 'EnableLBRepository' auf 'on' zu setzen, wird am oberen Rand des Library Browser eine Meldung angezeigt.

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.

Klicken Sie auf Fix und befolgen Sie die Anleitung.

Hinzufügen einer Unterbibliothek zum Library Browser

Befolgen Sie diese Schritte, um Ihrer mylib-Bibliothek eine Unterbibliothek namens mylib2 hinzuzufügen.

  1. Erstellen Sie eine neue Bibliothek namens mylib2. Fügen Sie ihr Blöcke hinzu.

  2. Setzen Sie im MATLAB-Befehlsfenster die Bibliothekseigenschaft EnableLBRepository für die neue Bibliothek auf 'on'. 

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

  3. Speichern Sie mylib2 in dem Ordner, der mylib enthält.

  4. Fügen Sie der Bibliothek mylib einen Subsystem-Block hinzu.

  5. Entfernen Sie die Eingangs- und Ausgangsports vom Subsystem, indem Sie die Blöcke Inport und Outport im Subsystem löschen.

  6. Nennen Sie den Subsystem-Block My Sublibrary.

  7. Um den Subsystem-Block mit der Unterbibliothek zu verknüpfen, setzen Sie den Callback OpenFcn mithilfe des Property Inspector auf mylib2.

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

  8. Speichern Sie mylib.

  9. Um die neue Unterbibliothek im Library Browser zu betrachten, klicken Sie rechts auf die Bibliotheksliste und wählen Sie Refresh Library Browser aus.

    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.

    In der Abbildung ist die Beispiel-Unterbibliothek mylib2 mit dem Namen My Sublibrary im Library Browser dargestellt.

    Aufgrund des von Ihnen erstellten Callbacks werden die Inhalte der mylib2-Bibliothek angezeigt, wenn Sie My Sublibrary erweitern.

Festlegen der Reihenfolge der Bibliotheken in der Bibliotheksliste

Sie können die Anordnung Ihrer Bibliothek gegenüber den anderen Bibliotheken in der Liste festlegen, indem Sie eine sl_customization.m-Datei im MATLAB-Verzeichnis hinzufügen und die Sortierpriorität der Bibliothek festlegen. Um Ihre Bibliothek am Anfang der Liste anzuzeigen, können Sie die Sortierpriorität beispielsweise auf -2 setzen. Standardmäßig ist die Sortierpriorität der Simulink-Bibliothek -1. Die anderen Bibliotheken weisen standardmäßig die Sortierpriorität 0 auf und diese Bibliotheken erscheinen unter der Simulink-Bibliothek. Bibliotheken mit derselben Sortierpriorität werden in alphabetischer Reihenfolge dargestellt.

Dieser Beispielinhalt für die sl_customization.m-Datei platziert die neue Bibliothek am Anfang der Bibliothekenliste. 

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

Damit die Änderungen unmittelbar wirksam werden, können Sie im MATLAB-Befehlsfenster folgendes eingeben:

sl_refresh_customizations

My Library appears at the top of the Library Browser tree

Verwandte Themen