Automate Project Tasks Using Scripts

Open Script

This example shows how to use the project API to automate project tasks manipulating files, including working with modified files, dependencies, shortcuts, and labels.

Get Project at the Command Line

Open the Airframe project and use currentProject to get a project object to manipulate the project at the command line.

proj = sldemo_slproject_airframe

Building with 'MinGW64 Compiler (C)'. MEX completed successfully. proj = Project with properties: Name: "Airframe Example" SourceControlIntegration: "Git" RepositoryLocation: "C:\workSpace\examples\repositories\airframe3" SourceControlMessages: ["Branch status: Normal" … ] ReadOnly: 0 TopLevel: 1 Dependencies: [1×1 digraph] Categories: [1×1 matlab.project.Category] Files: [1×32 matlab.project.ProjectFile] Shortcuts: [1×7 matlab.project.Shortcut] ProjectPath: [1×7 matlab.project.PathFolder] ProjectReferences: [1×0 matlab.project.ProjectReference] StartupFiles: [1×0 string] ShutdownFiles: [1×0 string] DefinitionFilesType: FixedPathMultiFile Description: "This is an example project.↵↵Use the "Project Shortcuts" toolstrip tab to find ways of getting started with this project." RootFolder: "C:\workSpace\examples\airframe3" SimulinkCodeGenFolder: "C:\workSpace\examples\airframe3\work\codegen" ProjectStartupFolder: "C:\workSpace\examples\airframe3" SimulinkCacheFolder: "C:\workSpace\examples\airframe3\work\cache"

Find Project Commands

Find out what you can do with your project.

methods(proj)

Methods for class matlab.project.Project: addFile listImpactedFiles addFolderIncludingChildFiles listModifiedFiles addPath listRequiredFiles addReference refreshSourceControl addShortcut reload addShutdownFile removeCategory addStartupFile removeFile addprop removePath close removeReference createCategory removeShortcut export removeShutdownFile findCategory removeStartupFile findFile runChecks isLoaded updateDependencies listAllProjectReferences Call "methods('handle')" for methods of matlab.project.Project inherited from handle.

Examine Project Files

获得一个项目对象后,您可以检查公关oject properties such as files.

files = proj.Files

files = 1×32 ProjectFile array with properties: Path Labels Revision SourceControlStatus

Use indexing to access files in this list. The following command gets file number 10. Each file has properties describing its path and attached labels.

proj.Files(10)

ans = ProjectFile with properties: Path: "C:\workSpace\examples\airframe3\data\controller.sldd" Labels: [1×1 matlab.project.Label] Revision: "27b6d5ec735ea103997d4cf6fc7abe625665678b" SourceControlStatus: Unmodified

Examine the labels of the 10th file.

proj.Files(10).Labels

ans = Label with properties: File: "C:\workSpace\examples\airframe3\data\controller.sldd" DataType: 'none' Data: [] Name: "Design" CategoryName: "Classification"

Get a particular file by name.

myfile = findFile(proj,'models/AnalogControl.slx')

myfile = ProjectFile with properties: Path: "C:\workSpace\examples\airframe3\models\AnalogControl.slx" Labels: [1×1 matlab.project.Label] Revision: "27b6d5ec735ea103997d4cf6fc7abe625665678b" SourceControlStatus: Unmodified

Find out what you can do with the file.

methods(myfile)

Methods for class matlab.project.ProjectFile: addLabel findLabel removeLabel

Get Modified Files

Modify a project model file by adding an arbitrary block.

open_system('AnalogControl') add_block('built-in/SubSystem','AnalogControl/test') save_system('AnalogControl')

Get all the modified files in the project. Observe two modified files. Compare with the Modified Files view in Project, where you can see a modified model file, and the corresponding project definition file.

modifiedfiles = listModifiedFiles(proj)

modifiedfiles = 1×2 ProjectFile array with properties: Path Labels Revision SourceControlStatus

第二个修改文件。观察到的文件SourceControlStatusproperty is Modified. Similarly,listModifiedFilesreturns any files that are added, conflicted, deleted, etc., that show up in the Modified Files view in Project.

modifiedfiles(2)

ans = ProjectFile with properties: Path: "C:\workSpace\examples\airframe3\resources\project\uuid-08e31a06-2b0a-43a0-8031-deb3ab31ef15.xml" Revision: "" SourceControlStatus: Added

Refresh source control status before querying individual files. You do not need to do before usinglistModifiedFiles.

refreshSourceControl(proj)

Get all the project files with a particular source control status. For example, get the files that areUnmodified.

proj.Files(ismember([proj.Files.SourceControlStatus], matlab.sourcecontrol.Status.Unmodified))

ans = 1×23 ProjectFile array with properties: Path Labels Revision SourceControlStatus

Get File Dependencies

Update the file dependencies. The project runs a dependency analysis to update the known dependencies between project files.

updateDependencies(proj)

Get the list of dependencies in the Airframe project. The Dependencies property contains the graph of dependencies between project files, stored as a MATLAB digraph object.

g = proj.Dependencies

g = digraph with properties: Edges: [21×1 table] Nodes: [21×1 table]

Get the files required by a model.

requiredFiles = bfsearch(g, which('AnalogControl'))

requiredFiles = 3×1 cell array {'C:\workSpace\examples\airframe3\models\AnalogControl.slx'} {'C:\workSpace\examples\airframe3\data\controller.sldd' } {'C:\workSpace\examples\airframe3\data\buses.sldd' }

Get the top-level files of all types in the graph.

g.Nodes.Name(indegree(g)==0);

Get the top-level files that have dependencies.

g.Nodes.Name(indegree(g)==0 & outdegree(g)>0)

ans = 4×1 cell array {'C:\workSpace\examples\airframe3\models\DigitalControl.slx'} {'C:\workSpace\examples\airframe3\models\LinearActuator.slx'} {'C:\workSpace\examples\airframe3\models\slproject_f14.slx' } {'C:\workSpace\examples\airframe3\tests\f14_airframe_test.m'}

Find impacted (or "upstream") files by creating a transposed graph.

transposed = flipedge(g) impacted = bfsearch(transposed, which('vertical_channel'))

transposed = digraph with properties: Edges: [21×1 table] Nodes: [21×1 table] impacted = 4×1 cell array {'C:\workSpace\examples\airframe3\models\vertical_channel.slx'} {'C:\workSpace\examples\airframe3\models\f14_airframe.slx' } {'C:\workSpace\examples\airframe3\models\slproject_f14.slx' } {'C:\workSpace\examples\airframe3\tests\f14_airframe_test.m' }

Find files impacted by a data dictionary.

impacted2 = bfsearch(transposed, which('buses.sldd'))

impacted2 = 11×1 cell array {'C:\workSpace\examples\airframe3\data\buses.sldd' } {'C:\workSpace\examples\airframe3\data\controller.sldd' } {'C:\workSpace\examples\airframe3\data\system_model.sldd' } {'C:\workSpace\examples\airframe3\tests\f14_airframe_test.m' } {'C:\workSpace\examples\airframe3\models\AnalogControl.slx' } {'C:\workSpace\examples\airframe3\models\DigitalControl.slx' } {'C:\workSpace\examples\airframe3\models\LinearActuator.slx' } {'C:\workSpace\examples\airframe3\models\NonLinearActuator.slx'} {'C:\workSpace\examples\airframe3\models\f14_airframe.slx' } {'C:\workSpace\examples\airframe3\models\slproject_f14.slx' } {'C:\workSpace\examples\airframe3\models\vertical_channel.slx' }

Get information on your files, such as the number of dependencies and orphans.

averageNumDependencies = mean(outdegree(g)); numberOfOrphans = sum(indegree(g)+outdegree(g)==0);

If you want to make changes to a model hierarchy, starting from the bottom up, find the topological order.

ordered = g.Nodes.Name(flip(toposort(g)));

Query Shortcuts

Examine the project's Shortcuts property.

shortcuts = proj.Shortcuts

shortcuts = 1×7 Shortcut array with properties: Name Group File

Examine a shortcut in the array.

shortcuts(7)

ans = Shortcut with properties: Name: "Rebuild Project's S-functions" Group: "Utility" File: "C:\workSpace\examples\airframe3\utilities\rebuild_s_functions.m"

Get the file path of a shortcut.

shortcuts(7).File

ans = "C:\workSpace\examples\airframe3\utilities\rebuild_s_functions.m"

Examine all the files in the shortcuts cell array.

{shortcuts.File}'

ans = 7×1 cell array {["C:\workSpace\examples\airframe3\custom_tasks\analyzeModelFiles.m"]} {["C:\workSpace\examples\airframe3\custom_tasks\billOfMaterials.m" ]} {["C:\workSpace\examples\airframe3\custom_tasks\checkCodeProblems.m"]} {["C:\workSpace\examples\airframe3\custom_tasks\runUnitTest.m" ]} {["C:\workSpace\examples\airframe3\models\slproject_f14.slx" ]} {["C:\workSpace\examples\airframe3\reports\slproject_f14.pdf" ]} {["C:\workSpace\examples\airframe3\utilities\rebuild_s_functions.m" ]}

Label files

Create a new category of labels, of type char. In the Project, the new Engineers category appears in the Labels pane.

createCategory(proj,'Engineers','char')

ans = Category with properties: Name: "Engineers" SingleValued: 0 DataType: "char" LabelDefinitions: [1×0 matlab.project.LabelDefinition]

Find out what you can do with the new category.

猫egory = findCategory(proj,'Engineers'); methods(category)

Methods for class matlab.project.Category: createLabel findLabel removeLabel

Define a new label in the new category.

createLabel(category,'Bob');

Get a label definition.

ld = findLabel(category,'Bob')

ld = LabelDefinition with properties: Name: "Bob" CategoryName: "Engineers"

Attach a label to the retrieved file, myfile. If you select the file in Project, you can see this label in the label editor pane.

addLabel(myfile,'Engineers','Bob');

Get a particular label and attach data to it, for example, some text.

label = findLabel(myfile,'Engineers','Bob'); label.Data ='Please assess'

label = Label with properties: File: "C:\workSpace\examples\airframe3\models\AnalogControl.slx" DataType: 'char' Data: 'Please assess' Name: "Bob" CategoryName: "Engineers"

You can specify a variable for the label data, for example:

mydata = label.Data

mydata = 'Please assess'

Create a new label category with numeric data type.

createCategory(proj,'Assessors','double'); category = findCategory(proj,'Assessors'); createLabel(category,'Sam');

Attach the new label to a specified file and assign data value 2 to the label.

myfile = proj.Files(14); addLabel(myfile,'Assessors','Sam', 2)

ans = Label with properties: File: "C:\workSpace\examples\airframe3\lib\timesthree.tlc" DataType: 'double' Data: 2 Name: "Sam" CategoryName: "Assessors"

Close Project

Closing the project at the command line is the same as closing the project using the Project tool. For example, the project runs shutdown scripts ad checks for unsaved models.

close(proj)

More Information

使用API的更多细节,输入:doc currentProject.

To automate start and shutdown tasks, seeAutomate Startup Tasks.