主要内容

本页采用了机器翻译。点击此处可查看英文原文。

Simulink.CloneDetection.addExclusions

从克隆检测中排除组件

自 R2025a 起

说明

excludeResults = Simulink.CloneDetection.addExclusions(modelName,query,rationale)query 指定的组件(例如子系统或参考模型)从模型 modelName 的克隆检测分析中排除,理由由 rationale 指定。

示例

示例

全部折叠

从克隆检测分析中排除模块。

打开模型 ex_detect_clones

openExample('ex_detect_clones')

从克隆检测分析中排除模型 ex_detect_clones 中的子系统 SS2SS3

exclusionResults = Simulink.CloneDetection.addExclusions('ex_detect_clones',...
               {'ex_detect_clones/SS2','ex_detect_clones/SS3'},'Block to be removed later.')
exclusionResults =

  struct with fields:

    AddedExclusions: [1×2 struct]
    FailedExclusions: []

查看第一个新增的排除项:

exclusionResults.AddedExclusions(1)
ans =

  struct with fields:

        Query: ''
        Block: 'ex_detect_clones/SS2'
    Rationale: 'Block to be removed later.'

根据特定准则从克隆检测分析中排除模块。

打开模型 ex_detect_clones

openExample('ex_detect_clones')

从克隆检测分析中排除模型 ex_detect_clones 中的虚拟子系统。

exclusionResults = Simulink.CloneDetection.addExclusions('ex_detect_clones',...
           {'BlockType','Subsystem','IsSubsystemVirtual','On'},'Virtual subsystems excluded.')
exclusionResults =

  struct with fields:

    AddedExclusions: [1×1 struct]
    FailedExclusions: []

这定义了基于 BlockTypeSubsystem 且属性 IsSubsystemVirtualOn 的排除准则,表明该子系统是虚拟的。

查看新增的除外条款:

exclusionResults.AddedExclusions(1)
ans =

  struct with fields:

        Query: 'BlockType,Subsystem,IsSubsystemVirtual,On'
        Block: ''
    Rationale: 'Virtual subsystems excluded.'

Simulink.CloneDetection.addExclusions 添加了一个查询,用于将虚拟子系统从克隆检测分析中排除。该函数能够处理 find_system 函数支持的查询。

输入参数

全部折叠

用于添加排除项的模型,指定为字符向量或字符串标量。

示例: 'mymodel'

数据类型: char | string

要从克隆检测分析中排除的块或查询,以字符向量的元胞数组形式指定。

示例: {'Subsystem1','Subsystem2'}

示例: {'BlockType','Subsystem','IsSubsystemVirtual','On'}

数据类型: cell

排除原因,指定为字符向量或字符串数组。

示例: 'Block to be removed later.'

数据类型: char | string

输出参量

全部折叠

排除操作的结果,以包含以下字段的结构体返回:

添加的排除项将以包含以下字段的结构体形式返回:

字段描述
Query用于排除块的查询
Blocks克隆分析中排除的模块
Rationale排除理由

未添加的排除项,将以包含以下字段的结构体返回:

字段描述
ExcludedBlockOrQuery用于排除块的块或查询
ExclusionReason排除理由

替代功能

克隆检测排除编辑器

您还可以使用克隆检测排除编辑器来管理排除项。要从 Simulink® 模型中添加排除项,请右键点击子系统或 Model 模块,然后选择 识别建模克隆 > 打开克隆检测排除编辑器。有关详细信息,请参阅从克隆检测中排除组件

版本历史记录

在 R2025a 中推出