Main Content

Exclude Blocks From Custom Checks

This example shows how to exclude blocks from custom checks. To save time during model development and verification, you can exclude individual blocks from custom checks during a Model Advisor analysis. To exclude custom checks from Simulink blocks and Stateflow charts, use the ModelAdvisor.Check.supportExclusion and Simulink.ModelAdvisor.filterResultWithExclusion functions in the check definition file.

Update the Check Definition File

  1. Set your folder to a writeable directory.

  2. Copy the script prepare_cust_chk_code to your current folder and run the script. The script copies the files necessary for this example to your current folder.

    copyfile(fullfile(matlabroot,'examples','slcheck','main','prepare_cust_chk_code.m'),...
        'prepare_cust_chk_code.m','f');
    run('prepare_cust_chk_code.m');

  3. Open the defineDetailStyleCheck file.

  4. To update the Check position of block names check to exclude blocks during Model Advisor analysis, make two modifications to the defineDetailStyleCheck file.

    1. Enable the Check position of block names check to support check exclusions by using the ModelAdvisor.Check.supportExclusion property. After rec.setCallbackFcn(@DetailStyleCallback,'None','DetailStyle');, add rec.supportExclusion = true;. The first section of the function defineDetailStyleCheck now looks like:

      % Create ModelAdvisor.Check object and set properties.
      rec = ModelAdvisor.Check('com.mathworks.sample.detailStyle');
      rec.Title = 'Check whether block names appear below blocks';
      rec.TitleTips = 'Check position of block names';
      rec.setCallbackFcn(@DetailStyleCallback,'None','DetailStyle');
      rec.supportExclusion = true;
      

    2. Use the Simulink.ModelAdvisor.filterResultWithExclusion function to filter model objects causing a check warning or failure with checks that have exclusions enabled. To do this, modify the DetailStyleCallback(system, CheckObj) function as follows:

      % Find all blocks whose name does not appear below blocks
      violationBlks = find_system(system, 'Type','block',...
          'NamePlacement','alternate',...
          'ShowName', 'on');
      violationBlks = mdladvObj.filterResultWithExclusion(violationBlks);
      

  5. Save the DefineDetailStyleCheck file. If you are asked if it is OK to overwrite the file, click OK.

Create and Save Exclusions

  1. In order for your customizations to be visible in the Model Advisor, you must refresh the Model Advisor check information cache. At the MATLAB command prompt, type this command:

    Advisor.Manager.refresh_customizations();

  2. To open the model, double-click AdvisorCustomizationExample.slx.

  3. In the Modeling tab, select Model Advisor to open the Model Advisor.

    Note

    If the By Product folder is not displayed in the Model Advisor window, select Show By Product Folder from the Settings > Preferences dialog box.

  4. In the left pane of the Model Advisor window, select the By Product > Demo > Check whether block names appear below blocks check. In the right pane, select Run This Check. The check fails.

  5. In the Model Advisor window, check that HighlightingHighlight Check Results is selected. The blocks causing the Check whether block names appear below blocks check failure are highlighted in yellow.

  6. In the model window, right-click the X block and select Model Advisor > Exclude block only > Check position of block names.

  7. In the Model Advisor Exclusion Editor, click OK to create an exclusion file.

  8. In the model window, open the Amplifier subsystem and right-click the GainBlock block and select Model Advisor > Exclude block only > Check position of block names.

  9. In the Model Advisor Exclusion Editor, click OK to update the exclusion file.

Review Exclusions

  1. In the Model Advisor, click Settings > Preferences > Show Exclusion Tab. Review the exclusions in the Exclusions tab.

  2. In the left pane of the Model Advisor window, select the By Product > Demo > Check position of block names check. In the right pane, select Run This Check. The check now passes. In the right-pane of the Model Advisor window, you can see the Check Exclusion Rules that the Model Advisor applies during the analysis.

  3. Close the model and the Model Advisor.

See Also

|

Related Examples

More About