dependencies.fileDependencyAnalysis

Find model file dependencies

Syntax

files = dependencies.fileDependencyAnalysis('modelname')

[files,missing] = dependencies.fileDependencyAnalysis('modelname')

[files,missing,depfile] = dependencies.fileDependencyAnalysis('modelname')

[files,missing,depfile,manifestfile] = dependencies.fileDependencyAnalysis('modelname','manifestfile')

Description

files = dependencies.fileDependencyAnalysis('modelname') returns the full paths of all existing files referenced by the model modelname.

[files,missing] = dependencies.fileDependencyAnalysis('modelname') also returns missing, any referenced files that cannot be found.

[files,missing,depfile] = dependencies.fileDependencyAnalysis('modelname') also returns depfile, the full path of the user dependencies (.smd) file, if it exists, that stores the names of any files the user manually added or excluded.

[files,missing,depfile,manifestfile] = dependencies.fileDependencyAnalysis('modelname','manifestfile') also creates a manifest file specified in manifestfile.

Examples

Find Model File Dependencies

Programmatically find all the file dependencies of the model sldemo_mdlref_depgraph.

files = dependencies.fileDependencyAnalysis('sldemo_mdlref_depgraph')

files = 7x1 cell
    {'/tmp/Bdoc21a_2203895_240803/tpa8b862bc/simulink-ex05898741/sldemo_mdlref_F2C.slx'         }
    {'/tmp/Bdoc21a_2203895_240803/tpa8b862bc/simulink-ex05898741/sldemo_mdlref_depgraph.slx'    }
    {'/tmp/Bdoc21a_2203895_240803/tpa8b862bc/simulink-ex05898741/sldemo_mdlref_heat2cost.slx'   }
    {'/tmp/Bdoc21a_2203895_240803/tpa8b862bc/simulink-ex05898741/sldemo_mdlref_heater.slx'      }
    {'/tmp/Bdoc21a_2203895_240803/tpa8b862bc/simulink-ex05898741/sldemo_mdlref_house.slx'       }
    {'/tmp/Bdoc21a_2203895_240803/tpa8b862bc/simulink-ex05898741/sldemo_mdlref_outdoor_temp.slx'}
    {'/tmp/Bdoc21a_2203895_240803/tpa8b862bc/simulink-ex05898741/sldemo_mdlref_thermostat.slx'  }

Input Arguments

modelname — Model, library, or subsystem name or path

character vector | string

Full name or path of a model, library, or subsystem to analyze, specified as a character vector or string.

Data Types: char | string

manifestfile — Manifest file name or path

character vector | string

(Optional) Full name or path of the manifest file to create, specified as a character vector or string. The function adds the suffix .smf to the user-specified name.

Data Types: char | string

Output Arguments

files — Full paths of referenced files

character vector | cell array of character vectors

Full paths of all existing files referenced by the model or library modelname, returned as a character vector or a cell array of character vectors.

missing — Full paths of missing files

character vector | cell array of character vectors

Full paths of files referenced by the model or library modelname that cannot be found, returned as a character vector or a cell array of character vectors.

depfile — Full path of user dependencies file

character vector

Full path of user dependencies (.smd) file, if it exists, that stores the names of any files the user manually added or excluded, returned as a character vector.

manifestfile — Full path of created manifest file

character vector

Full path of new manifest (.smf) file, returned as a character vector.

Tips

• Interactively generate a dependency graph and a report summarizing the list of required files and products. For more details, see Analyze Model Dependencies.

• If your model is in a project, use listRequiredFiles instead.

• To programmatically check which add-ons are required, use dependencies.toolboxDependencyAnalysis instead.

Compatibility Considerations

Output arguments manifestfile and depfile will be removed

Not recommended starting in R2020b

Output arguments manifestfile and depfile will be removed in a future release.

Starting in R2020b, you can only generate the manifest file programmatically. You can open manifest files created prior to R2020b using the Dependency Analyzer. To interactively generate a dependency graph and report, perform a dependency analysis. For more details, see Analyze Model Dependencies.

Starting in R2020b, you can no longer generate a user dependencies file (.smd file). The function only returns a .smd file if it already exists. To manually add or exclude dependencies, create a project from your model. For more details, see Create a Project from a Model and Add Files to the Project.