Main Content

Add Libraries to the Library Browser

This example shows how to create a block library and add it to the Simulink® Library Browser. This example also shows how to add a sublibrary.

You create a function slblocks to specify information about your library. You can save the function as a .m or .mlx file. You cannot save it as a P-code file.

  1. From the Simulink start page, select Blank Library and click Create Library.

  2. Add a Gain block and a Subsystem block to the library. Remove the input and output port from the subsystem.

  3. Name the Subsystem block My Sublibrary. To link it to a sublibrary, in the My Sublibrary properties, set the OpenFcn callback to mylib2.

  4. At the MATLAB® command prompt, enter this command to enable the model property EnableLBRepository. Your library can appear in the browser only if this property is on when you save your library.

    set_param(gcs,'EnableLBRepository','on');
  5. Save the library in a folder on the MATLAB path. For this example, name the library mylib.

  6. Create another library mylib2 and add some blocks to it.

  7. At the MATLAB command prompt, enable the model property EnableLBRepository for the new library.

    set_param(gcs,'EnableLBRepository','on');
  8. Save mylib2 to the same folder you saved mylib to.

    You can close both libraries if you want.

  9. In MATLAB, right-click the folder you saved the library to and select New File > Script. Name the file slblocks.m.

  10. Open slblocks.m. Add this function to it and save.

    function blkStruct = slblocks
    		% This function specifies that the library should appear
    		% in the Library Browser
    		% and be cached in the browser repository
    
    		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; 

  11. In the Library Browser, refresh to see the new library and sublibrary. Right-click the library list and select Refresh Library Browser.

    The figure shows the example library mylib with the Library Browser name My Library.

    Because of the callback you created, clicking My Sublibrary displays the contents of the mylib2 library.

Note

If you saved your library without setting 'EnableLBRepository' to 'on', a message appears at the top of the Library Browser.

Click Fix and respond to the prompt as appropriate.

Specify Library Order in the Library List

You can specify the order of your library relative to the other libraries in the list by adding a sl_customization.m file to the MATLAB path and setting the sort priority of your library. For example, to see your library at the top of the list, you can set the sort priority to -2. By default, the sort priority of the Simulink library is -1. The other libraries have a sort priority of 0 by default, and these libraries appear below the Simulink library. Libraries with the same sort priority appear in alphabetical order.

This sample content of the sl_customization.m file places the new library at the top of the list of libraries.

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

To make the customization take effect immediately, at the command prompt, enter:

sl_refresh_customizations

Related Examples

More About