Advisor.addExclusion
Add exclusions to model or exclusion file
Syntax
Description
exclusionInfo = Advisor.addExclusion(modelName,filterType,entityIdentifier)modelName , and returns an object
exclusionInfo that contains information about the exclusion. The type
of exclusion is specified by the filterType argument. The entity is
specified by the entityIdentifier argument.
exclusionInfo = Advisor.addExclusion(___,Name,Value)checks argument to
exclude an entity from specific Model Advisor checks or the rationale
argument to provide a reason for the exclusion.
Note
If you add an exclusion, you can save time during model development and verification by limiting the scope of the analysis that Model Advisor has to perform on your model.
Examples
Exclude a Simulink® block from Model Advisor analysis.
Open the slexAircraftExample model.
openExample('simulink_aerospace/AircraftLongitudinalFlightControlExample')Click the Inport block named u.
Exclude the selected block from Model Advisor analysis by adding an exclusion to the block. In the MATLAB® Command Window, enter:
exclusions = Advisor.addExclusion('slexAircraftExample','Block',gcb);
'Block'
specifies that the exclusion filters out a Simulink block.Get the exclusions from the model by entering:
exclusions(1)
ans =
AdvisorFilterSpecification with properties:
filteredItem: [1×1 advisor.filter.IFilter]
metadata: [1×1 advisor.filter.Metadata]
mode: Exclude
commentThread: [1×0 advisor.filter.Metadata Sequence]
type: Block
id: 'slexAircraftExample:1'
checks: [1×1 String Sequence]You can also view the exclusion in the Model Advisor Exclusion Editor by right-clicking the Simulink canvas and selecting Model Advisor > Open Model Advisor Exclusion Editor.
The Model Advisor Exclusion Editor shows a table with a row for the
u
Inport block exclusion. The Filter Identifier column
shows the pathname specified by the entityIdentifier argument and
the Filter Type column shows the exclusion filter type specified by
filterType argument. The Rationale and
Check ID(s) columns are associated with the
rationale and checks arguments.
Use the Advisor.addExclusion function to exclude
a Stateflow chart from the Model Advisor analysis. This example requires Stateflow.
Open the sf_yoyo model.
openExample('stateflow/YoYoControlOfSatelliteExample')In the Stateflow chart, click the entity that you want to exclude from Model Advisor checks. For this example, click the default transition {ReelState= 0;}.
Exclude the selected transition from Model Advisor analysis by adding an exclusion to the transition. In the MATLAB Command Window, enter:
exclusions = Advisor.addExclusion('sf_yoyo','Transition',gcb,'rationale','Do not analyze.')
Get the exclusions from the model by entering:
exclusions(1)
ans =
AdvisorFilterSpecification with properties:
filteredItem: [1×1 advisor.filter.IFilter]
metadata: [1×1 advisor.filter.Metadata]
mode: Exclude
commentThread: [1×0 advisor.filter.Metadata Sequence]
type: Block
id: 'sf_yoyo:1'
checks: [1×1 String Sequence]You can view the exclusion in the Model Advisor Exclusion Editor by right-clicking the Simulink canvas and selecting Model Advisor > Open Model Advisor Exclusion Editor.
Input Arguments
Name-Value Arguments
Output Arguments
Alternative Functionality
Model Advisor Exclusion Editor
You can also add exclusions from the Simulink canvas by using the Model Advisor Exclusion Editor. To add an exclusion from the Simulink canvas, right-click an entity, select Model Advisor, and select the menu option for the type of exclusion that you want to add. For more information, see Exclude Blocks from Model Advisor Check Analysis.
