Simulink.BlockDiagram.propagateConfigSet

Propagate top model configuration reference to referenced models

Syntax

[isPropagated, convertedModels] = Simulink.BlockDiagram.propagateConfigSet(mdl)

[isPropagated, convertedModels] = Simulink.BlockDiagram.propagateConfigSet(mdl,'include',refmodels)

[isPropagated, convertedModels] = Simulink.BlockDiagram.propagateConfigSet(mdl,'exclude',refmodels)

h = Simulink.BlockDiagram.propagateConfigSet(mdl,'gui')

Description

[isPropagated, convertedModels] = Simulink.BlockDiagram.propagateConfigSet(mdl) propagates the configuration reference for the model mdl to all referenced models. Execute the function from a writable folder.

[isPropagated, convertedModels] = Simulink.BlockDiagram.propagateConfigSet(mdl,'include',refmodels) propagates the configuration reference for the mdl to the models in the list refmodels. Execute the function from a writable folder.

[isPropagated, convertedModels] = Simulink.BlockDiagram.propagateConfigSet(mdl,'exclude',refmodels) propagates the configuration reference for the model mdl to all referenced models in the hierarchy except for the models in the list refmodels. Execute the function from a writable folder.

h = Simulink.BlockDiagram.propagateConfigSet(mdl,'gui') opens the Configuration Reference Propagation to Referenced Models dialog box.

Examples

Propagate Configuration Reference to All Referenced Models

openExample("simulink/VisualizeModelReferenceHierarchiesExample")
[isPropagated,convertedModels] = ...
Simulink.BlockDiagram.propagateConfigSet('sldemo_mdlref_depgraph')

Propagate Configuration Reference to Listed Referenced Models

openExample("simulink/VisualizeModelReferenceHierarchiesExample")
[isPropagated,convertedModels] = ...
Simulink.BlockDiagram.propagateConfigSet(...
'sldemo_mdlref_depgraph','include',...
{'sldemo_mdlref_heater','sldemo_mdlref_house'})

Propagate Configuration Reference to Referenced Models with Exclusions

openExample("simulink/VisualizeModelReferenceHierarchiesExample")
[isPropagated,convertedModels] = ...
Simulink.BlockDiagram.propagateConfigSet(...
'sldemo_mdlref_depgraph','exclude',...
{'sldemo_mdlref_heater','sldemo_mdlref_house'})

Open Configuration Reference Propagation to Referenced Models Dialog Box for Model

openExample("simulink/VisualizeModelReferenceHierarchiesExample")
Simulink.BlockDiagram.propagateConfigSet(...
'sldemo_mdlref_depgraph','gui')

Input Arguments

mdl — Top model

character vector | string scalar

Top model with configuration reference to propagate, specified as a character vector or string scalar.

Example: ‘MyModel’

refmodels — Referenced models to include or exclude in propagation

cell array of character vectors | string array

Referenced models to include or exclude in propagation, specified as a cell array of character vectors or a string array.

Example: {‘mdl1’,’mdl2’,’mdl3’}

Output Arguments

isPropagated — Success of propagation

false (default) | true

Indication of whether configuration reference propagation is successful, returned as a Boolean.

convertedModels — Converted models

cell array of character vectors

Converted models, returned as a cell array of character vectors.

h — Handle to Configuration Reference Propagation to Referenced Models dialog box

handle

Handle to Configuration Reference Propagation to Referenced Models dialog box. Returned when you specify the ‘gui’ argument to the function.

Version History

Introduced in R2012b