slreportgen.finder.ChartDiagramFinder 类

命名空间: slreportgen.finder
超类: slreportgen.finder.DiagramFinder

创建 Stateflow 图查找器

全页展开

描述

查找 Stateflow^® 图。

slreportgen.finder.ChartDiagramFinder 类是 handle 类。

创建对象

描述

finder = ChartDiagramFinder(container) 创建一个查找器，默认查找指定 container 中所有未注释的 Stateflow 图。要将搜索限制到特定类型的图，请使用此查找器的属性。

注意

该查找器可以在查找模式或迭代器模式下运行。在查找模式下，使用其 find 方法将搜索结果作为结果数组返回。在迭代器模式下，使用其 hasNext 和 next 方法逐一返回搜索的结果。在具有许多模型引用的模型中搜索时，使用迭代器模式。迭代器模式在编译和搜索模型后会关闭该模型，而查找模式则会保持其搜索的所有模型处于打开状态。打开多个模型会消耗所有系统内存并减慢报告生成速度。迭代器模式比查找模式慢，因此使用查找模式来搜索引用很少或不引用其他模型的模型。

示例

finder = ChartDiagramFinder(Name=Value) 使用名称-值参量设置属性。您可以按任意顺序指定多个名称-值参量。

输入参量

全部展开

`Container` — 要搜索的图容器
路径 | 句柄 | 图 ID | 图对象

请参阅 Container 属性。

属性

全部展开

`Container` — 要搜索的图容器
路径 | 句柄 | 图 ID | 图对象

要搜索的图容器，指定为以下值之一：

Stateflow 图模块的句柄
Stateflow 图模块的路径
Stateflow 图 ID
Stateflow 图对象

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

`SearchDepth` — 系统图深度搜索
`Inf` (默认) | 正整数

系统图搜索的深度，指定为 Inf 或正整数。SearchDepth 指定在图容器中搜索图的深度级别。要搜索所有层级，请使用 Inf。

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: double

`IncludeMaskedSubsystems` — 搜索封装子系统
`true` (默认) | `false`

选择搜索封装子系统，指定为逻辑值 1 (true) 或 0 (false)。如果此属性为 true，则查找器将在图容器中搜索封装的 Subsystem 模块。它搜索指定的 SearchDepth 并将找到的图包含在搜索结果中。

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: logical

`IncludeReferencedModels` — 搜索模型参考
`true` (默认) | `false`

选择搜索参考模型，指定为逻辑值 1 (true) 或 0 (false)。如果此属性为 true，则查找器将搜索图容器中引用的模型。它搜索指定的 SearchDepth 并将找到的图包含在搜索结果中。

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: logical

`IncludeSimulinkLibraryLinks` — 搜索 Simulink^® 库链接
`true` (默认) | `false`

选择搜索 Simulink 库链接，指定为逻辑值 1 (true) 或 0 (false)。如果此属性和 IncludeMaskedSubsystems 都是 true，则查找器将在图容器中搜索指向 Simulink 库中的子系统和封装 Subsystem 模块的链接。它搜索指定的 SearchDepth 并将找到的图包含在搜索结果中。如果此属性为 true，但 IncludeMaskedSubsystems 为 false，则查找器仅搜索 Simulink 库中 Subsystem 模块的链接。

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: logical

`IncludeUserLibraryLinks` — 搜索用户库链接
`true` (默认) | `false`

选择搜索用户库链接，指定为逻辑值 1 (true) 或 0 (false)。如果此属性为 true 且 IncludeMaskedSubsystems 属性为 true，则查找器将在图容器中搜索指向用户库中的子系统和封装子系统模块的链接。它搜索指定的 SearchDepth 并将找到的图包含在搜索结果中。如果此属性为 true，但 IncludeMaskedSubsystems 属性为 false，则查找器仅搜索用户库中 Subsystem 模块的链接。

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: logical

`IncludeCommented` — 包括注释掉的图
`false` (默认) | `true`

选择在搜索结果中包含注释掉的图，指定为逻辑值。如果是 false，注释掉的图将被排除在搜索结果之外。

`IncludeVariants` — 包括图变体
`"Active"` (默认) | `"All"` | `"ActivePlusCode"` | ...

搜索图的变体，指定为字符串或字符向量。默认值为 Active。有效值为:

值	描述
`"Active"`	活动变体
`"All"`	所有变体
`"ActivePlusCode"`	活跃变体和代码变体

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: char | string

`SortType` — 查找器结果的排序方法
`"none"` (默认) | `"alphabetical"` | `"numBlocks"` | `"depth"`

查找器结果的排序方法，指定为下列值之一：

值	描述
`"none"`	不对结果进行排序。
`"alphabetical"`	按名称的字母顺序对结果进行排序。
`"numBlocks"`	按系统中的模块数对结果进行排序。排序列表中的第一个模块包含最多的块。
`"depth"`	按在模型层次结构中的深度对结果进行排序。排序列表中的第一个系统是层次结构中最高的系统。例如，一个模型及其子系统按以下顺序排序： `myModel`、`myModel/subsystem1`、`myModel/subsystem1/nestedSubststem`。

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: char | string

`Properties` — 要查找的对象的属性
元胞数组

要查找的对象的属性，指定为名称-值参量的元胞数组。查找器仅返回具有指定属性和指定值的对象。

示例: finder.Properties = {'Gain','5'}

属性：

`GetAccess`	`公共`
`SetAccess`	`公共`

数据类型: cell

`AutoCloseModel` — 是否关闭模型
`true` (默认) | `false`

是否关闭模型，指定为 true 或 false。如果是 true，则查找器的 next 方法会关闭当前打开的模型，然后再移动到下一个要搜索的模型。关闭模型可以防止在搜索引用许多模型的模型时过度消耗内存。

注意

查找器的 find 方法忽略此属性并将所有引用模型保持为打开状态。因此，您不应使用 find 方法来搜索具有许多模型引用的模型。

数据类型: logical

方法

全部展开

公共方法

find

results = find(finder) 在查找器指定的 container 中查找图。finder 是 slreportgen.finder.ChartDiagramFinder 对象。results 是 slreportgen.finder.DiagramResult 对象的数组，每个对象都包含通过此方法找到的图。将此数组添加到报告或报告器中会添加其所包含的图的图像。可以添加此方法的 results 的报告是 slreportgen.report.Report 类型报告或其他报告器对象（例如 slreportgen.report.Chapter 报告器）。

hasNext

tf = hasNext(finder) 确定查找器搜索的容器是否至少包含一个图。如果容器至少有一个图，则 hasNext 方法会将该图排队为 next 方法将返回的下一个图。然后 hasNext 方法返回 true。使用 next 方法获取该图。在后续调用中，hasNext 方法确定容器是否具有 next 尚未检索的图。它将图排队以供 next 方法检索并返回 true。如果不存在更多可供检索的图，此方法将返回 false。要逐步搜索容器中的图，请在 while 循环中将 hasNext 方法与 next 方法结合使用。

注意

如果当前结果是当前图搜索队列中的最后一个结果，并且 AutoCloseModel 属性为 true，则此方法会在打开下一个图之前关闭当前图。虽然这会增加搜索时间，但在搜索引用许多其他图的图时可以减少内存消耗。如果您的图没有引用许多其他图，为了加快搜索速度，请将 AutoCloseModel 属性设置为 false 或使用 find 方法。

next

result = next(result) 返回 hasNext 方法创建的结果队列中的下一个搜索 result。搜索结果包含结果图。将此 result 对象添加到报告或报告器中会为图添加一个图报告器。

示例

全部折叠

查找 Stateflow 图

此示例使用:

打开实时脚本

创建一份包含 sldemo_fuelsys 模型中所有 Stateflow 图图像的报告。每个图使用单独的章节。

import mlreportgen.report.*
import slreportgen.report.*
import slreportgen.finder.*
 
model_name = "sldemo_fuelsys";
load_system(model_name);
rpt = slreportgen.report.Report("output","pdf");

add(rpt, TitlePage(Title=sprintf("%s Charts",model_name)));
add(rpt, TableOfContents);
chapter = Chapter("Root System");
add(chapter, Diagram(model_name));
add(rpt,chapter);

chapter = Chapter("Charts");
finder = ChartDiagramFinder(model_name); 
results = find(finder);
for result = results
    section = Section(Title=result.Name);
    add(section,result);
    add(chapter,section);
end
add(rpt, chapter);

close(rpt);
close_system(model_name);
rptview(rpt);

版本历史记录

在 R2017b 中推出

另请参阅

slreportgen.finder.ChartDiagramFinder 类

描述

创建对象

描述

输入参量

Container — 要搜索的图容器 路径 | 句柄 | 图 ID | 图对象

属性

Container — 要搜索的图容器 路径 | 句柄 | 图 ID | 图对象

属性：

SearchDepth — 系统图深度搜索 Inf (默认) | 正整数

属性：

IncludeMaskedSubsystems — 搜索封装子系统 true (默认) | false

属性：

IncludeReferencedModels — 搜索模型参考 true (默认) | false

属性：

IncludeSimulinkLibraryLinks — 搜索 Simulink® 库链接 true (默认) | false

属性：

IncludeUserLibraryLinks — 搜索用户库链接 true (默认) | false

属性：

IncludeCommented — 包括注释掉的图 false (默认) | true

IncludeVariants — 包括图变体 "Active" (默认) | "All" | "ActivePlusCode" | ...

属性：

SortType — 查找器结果的排序方法 "none" (默认) | "alphabetical" | "numBlocks" | "depth"

属性：

Properties — 要查找的对象的属性 元胞数组

属性：

AutoCloseModel — 是否关闭模型 true (默认) | false

方法

公共方法

示例

查找 Stateflow 图

版本历史记录

另请参阅

主题

`Container` — 要搜索的图容器
路径 | 句柄 | 图 ID | 图对象

`Container` — 要搜索的图容器
路径 | 句柄 | 图 ID | 图对象

`SearchDepth` — 系统图深度搜索
`Inf` (默认) | 正整数

`IncludeMaskedSubsystems` — 搜索封装子系统
`true` (默认) | `false`

`IncludeReferencedModels` — 搜索模型参考
`true` (默认) | `false`

`IncludeSimulinkLibraryLinks` — 搜索 Simulink^® 库链接
`true` (默认) | `false`

`IncludeUserLibraryLinks` — 搜索用户库链接
`true` (默认) | `false`

`IncludeCommented` — 包括注释掉的图
`false` (默认) | `true`

`IncludeVariants` — 包括图变体
`"Active"` (默认) | `"All"` | `"ActivePlusCode"` | ...

`SortType` — 查找器结果的排序方法
`"none"` (默认) | `"alphabetical"` | `"numBlocks"` | `"depth"`

`Properties` — 要查找的对象的属性
元胞数组

`AutoCloseModel` — 是否关闭模型
`true` (默认) | `false`