This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

Automate Label Management in a Simulink Project

This example shows how to the Simulink® Project functions to manage labels.

Open the Airframe Example Project

Run the following commands to create and open a working copy of the "sldemo_slproject_airframe" example.

Initializing: Project Path
Identifying shadowed project files
Running: /tmp/publish_examples0/bml.batserve.057896/work/projects/slexamples/airframe7/utilities/set_up_project.m
Building with 'gcc'.
MEX completed successfully.

Get a Project Object.

Use the simulinkproject function to get a project object to manipulate the currently open Simulink Project at the command line.

project = simulinkproject;

View the Labels of a File

Examine the Files property of the project. The Files property contains an array of file objects, one for each file in the project.

files = project.Files;
  1×33 ProjectFile array with properties:


You can use indexing to access files in this array. The following command gets file number 2. Each file has two properties describing its path and attached labels.

aFile = files(2);
  ProjectFile with properties:

                   Path: '/tmp/publish_examples0/bml.batserve.057896/work/projects/slexamples/airframe7/custom_tasks/analyzeModelFiles.m'
                 Labels: [1×1 slproject.Label]
               Revision: ''
    SourceControlStatus: NotUnderSourceControl

Find information about a file's attached labels by indexing into the file object's Labels property. The following command gets the first label attached to this particular file.

label = aFile.Labels(1);
  Label with properties:

            File: '/tmp/publish_examples0/bml.batserve.057896/work/projects/slexamples/airframe7/custom_tasks/analyzeModelFiles.m'
        DataType: 'none'
            Data: []
            Name: 'Analysis'
    CategoryName: 'Classification'

Attach a Label to a Subset of Files.

The following code attaches the label 'Design' in the 'Classification' category to all files in the project with the .m file extension.

First get the list of files:

files = project.Files;

Then loop through each file and attach the label 'Design' from the 'Classification' category if the file has the extension .m.

for fileIdx = 1:numel(files)
   file = files(fileIdx);
   [~, ~, fileExtension] = fileparts(file.Path);
   if strcmp(fileExtension,'.m')
       addLabel(file, 'Classification', 'Design');

Find a Named Label

You can set and query data on a label that is attached to a file. To do this, you first need to find the file object. You can do this by looping through all files in the project, as shown in the previous step. Alternatively, you can use the findFile function on the project.

The following code finds the file object for the file 'utilities/set_up_project.m'.

pathToLocate = fullfile('utilities','clean_up_project.m');
file = findFile(project, pathToLocate);

Examine the Labels property to get an array of Label objects, one for each label attached to the file.

labels = file.Labels;
  Label with properties:

            File: '/tmp/publish_examples0/bml.batserve.057896/work/projects/slexamples/airframe7/utilities/clean_up_project.m'
        DataType: 'none'
            Data: []
            Name: 'Design'
    CategoryName: 'Classification'

To find a label by name, use findLabel on the file object.

label = findLabel(file, 'Classification','Design');

Create a New Category

You must create new labels before you can attach them to a file. You define labels in categories, giving each category a name and supported data type.

The following code creates a category of labels called Engineers which can be used to denote file ownership in a project. These labels have the char datatype for attaching String data.

engineersCategory = findCategory(project, 'Engineers');

You can now attach an Sam label from the 'Engineers' category to a file in the project.

addLabel(file, 'Engineers', 'Sam');
label = findLabel(file, 'Engineers', 'Sam');

Set Label Data

The following command sets the data for the attached label.

label.Data = 'Maintenance responsibility';
  Label with properties:

            File: '/tmp/publish_examples0/bml.batserve.057896/work/projects/slexamples/airframe7/utilities/clean_up_project.m'
        DataType: 'char'
            Data: 'Maintenance responsibility'
            Name: 'Sam'
    CategoryName: 'Engineers'

Further Information

Simulink Project documentation

Was this topic helpful?