find_system
查找系统、块、行、端口和注释
描述
例子
查找加载的系统及其块
返回所有加载的系统及其块的名称。
load_system (“vdp”) find_system
ans =15 x1细胞{vdp的}{‘vdp /常数’}{' vdp /更多信息'}{vdp /信息/模型信息的}{的vdp /亩}{的vdp / Mux} {vdp /产品的}{vdp /范围的}{vdp /平方的}{vdp /总和的}{的vdp / Sum1} {vdp / x1的}{vdp / x2的}{vdp /着干活的}{' vdp / Out2 '}
返回已加载的系统和库,包括vdp
.
找到特定的系统及其块
返回vdp
系统及其块。
load_system ({“vdp”,“ex_sldemo_clutch”}) find_system (“vdp”)
ans =15 x1细胞{vdp的}{‘vdp /常数’}{' vdp /更多信息'}{vdp /信息/模型信息的}{的vdp /亩}{的vdp / Mux} {vdp /产品的}{vdp /范围的}{vdp /平方的}{vdp /总和的}{的vdp / Sum1} {vdp / x1的}{vdp / x2的}{vdp /着干活的}{' vdp / Out2 '}
返回已加载模型、子系统和库的名称
返回加载的模型、子系统和库的名称。只有当子系统可以独立加载时,才返回子系统名称。
load_system (“vdp”);find_system (“类型”,“block_diagram”)
ans =1 x1单元阵列{' vdp '}
搜索子系统的子节点
返回所有Goto块的名称,它们是unlock子系统的子模块ex_sldemo_clutch
系统。
load_system (“ex_sldemo_clutch”);find_system (“ex_sldemo_clutch /解锁”,“SearchDepth”, 1“BlockType”,“转到”)
ans =2 x1细胞{“ex_sldemo_clutch /解锁/ Goto”}{' ex_sldemo_clutch /解锁/ Goto1 '}
The MathWorks, Inc.版权所有2020
多条件搜索
搜索的vdp
系统,并返回所有的增益块的名称获得值设置为1
.
load_system (“vdp”);find_system (“vdp”,“BlockType”,“获得”,“获得”,' 1 ')
ans =1 x1单元阵列{' vdp /μ'}
返回行和注释作为句柄
中所有行和注释的句柄vdp
系统。与“FindAll”
,函数返回句柄,而不管您如何指定要搜索的系统。
load_system (“vdp”);L = find_system (“vdp”,“FindAll”,“上”,“类型”,“行”)
L =19×134.0009 33.0009 32.0009 31.0010 30.0010 29.0010 28.0009 27.0033 26.0009 25.0009
一个= find_system (“vdp”,“FindAll”,“上”,“类型”,“注释”)
一个=2×136.0009 - 35.0009
搜索特定块参数值
查找值为的任何块对话框参数0
在vdp
而且ex_sldemo_clutch
系统。
load_system ({“vdp”,“f14”find_system ({})“vdp”,“f14”},“BlockDialogParams”,' 0 ')
ans = 32×1单元阵列{' vdp /更多信息'}{vdp /信息/模型信息的}{vdp /范围的}{vdp / x2的}{vdp /着干活的}{vdp /着干活的}{的vdp / Out2}{的vdp / Out2} {f14 /飞机↵↵动态模型的}{' f14 /飞机↵动力学↵模型/垂直速度↵w(英国《金融时报》/ /秒)”}{' f14 /飞机↵动力学↵模型/垂直速度↵w(英国《金融时报》/ /秒)”}{' f14 /飞机↵动力学↵模型/俯仰速率↵q (rad / /秒)”}{' f14 /飞机↵动力学↵模型/俯仰速率↵q (rad / /秒 )' } . . .
使用正则表达式搜索
使用以。开头的块对话框参数值查找当前加载系统的顶层的所有块3.
.
load_system ({“ex_sldemo_clutch”,“vdp”});find_system (“SearchDepth”,' 1 ',“正则表达式”,“上”,“BlockDialogParams”,' ^ 3 ')
ans =4 x1细胞{' vdp /范围'}{vdp /范围的}{vdp /平方的}{' ex_sldemo_clutch / w '}
正则表达式搜索部分匹配
在使用正则表达式进行搜索时,可以指定想要匹配的字符向量的一部分,以返回包含该字符向量的所有对象。中的所有导入和输出块ex_sldemo_clutch
模型。
load_system (“ex_sldemo_clutch”);find_system (“ex_sldemo_clutch”,“正则表达式”,“上”,“blocktype”,“端口”)
ans =39 x1细胞{' ex_sldemo_clutch /摩擦……'}{“ex_sldemo_clutch /摩擦……'}{“ex_sldemo_clutch /摩擦……'} {'ex_sldemo_clutch/摩擦模式逻辑/Tin'} {'ex_sldemo_clutch/摩擦模式逻辑/Tfmaxs'} {'ex_sldemo_clutch/摩擦模式逻辑/Break Apart…'} {'ex_sldemo_clutch/摩擦模式逻辑/分离…'} {'ex_sldemo_clutch/摩擦模式逻辑/分离…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…'} {'ex_sldemo_clutch/摩擦模式逻辑/锁定…”}{' ex_sldemo_clutch /摩擦模式逻辑/禁售FSM /锁'}{' ex_sldemo_clutch /摩擦模式逻辑/ FSM锁定/解锁”}{' ex_sldemo_clutch /摩擦模式逻辑/禁售FSM /锁’}{' ex_sldemo_clutch /摩擦模式逻辑/必要的摩擦/锡'}{' ex_sldemo_clutch /摩擦模式逻辑/必要的摩擦/ Tf '} {ex_sldemo_clutch /摩擦模式逻辑锁的}{ex_sldemo_clutch /摩擦模式逻辑锁的}{ex_sldemo_clutch /摩擦模式逻辑/解锁的}{ex_sldemo_clutch /摩擦模式逻辑/ Tf的}{' ex_sldemo_离合器/锁定/Tin'} {' ex_sldemo_离合器/锁定/w'} {' ex_sldemo_离合器/解锁/Tfmaxk'} {' ex_sldemo_离合器/解锁/Tin'} {' ex_sldemo_离合器/解锁/we'}
更新子系统中的库链接
在这个例子中,myModel
包含一个子系统,它是一个库链接。在模型最后一次打开后,一个获得块被添加到库中相应的子系统中。
打开模型。使用find_system
与“FollowLinks”
设置为“关闭”
.该命令不跟随库链接进入子系统,只返回顶层的子系统。
open_system (“myModel”) find_system (bdroot“LookUnderMasks”,“上”,“FollowLinks”,“关闭”)
ans = 'myModel' 'myModel/子系统'
使用find_system
与“FollowLinks”
设置为“上”
.find_system
更新库链接并返回子系统中的块。
find_system (bdroot“LookUnderMasks”,“上”,“FollowLinks”,“上”)
更新链接:myModel/子系统/增益ans = 'myModel' 'myModel/子系统' 'myModel/子系统/增益'
返回值作为句柄
提供系统find_system
作为一个句柄。搜索值为的块对话框参数0
.如果你给get_param
对于相同的块,那么使用块句柄比指定完整的块路径作为字符向量更有效。
load_system (“vdp”);sys = get_param (“vdp”,“处理”);find_system (sys,“BlockDialogParams”,' 0 ')
ans =8×13.0013 4.0013 8.0011 13.0011 14.0011 14.0011 15.0011 15.0011
输入参数
系统
- - - - - -系统搜索
路径名|路径名称的单元格数组|处理|向量的处理
指定为完整的系统路径名、系统路径名的单元格数组、句柄或句柄向量。
例子:“MyModel / Subsystem1”
例子:{“vdp”、“ex_sldemo_clutch”}
名称-值参数
指定可选参数对为Name1 = Value1,…,以=家
,在那里的名字
参数名称和价值
对应的值。名-值参数必须出现在其他参数之后,但对的顺序并不重要。
在R2021a之前,名称和值之间用逗号隔开,并括起来的名字
在报价。
例子:‘SearchDepth’,‘0’,‘LookUnderMasks’,‘没有’,‘BlockType’,“转到”
在负载系统(不包括屏蔽子系统)中搜索Goto块。
当您使用find_system
函数,名称,值
对实参可以包括搜索约束以及形参名称和值对。可以以任何顺序指定搜索约束,但它们必须在参数名称和值对之前。
看到屏蔽一些参数获取块参数的列表。
BlockDialogParams
- - - - - -选项以搜索块对话框参数的指定值
特征向量|字符串标量
选项来搜索块对话框参数的指定值,指定为逗号分隔的对“BlockDialogParams”
和字符向量或字符串标量。这个对必须遵循其他搜索约束对。
CaseSensitive
- - - - - -选项在匹配时考虑大小写
“上”
(默认)|“关闭”
选项在匹配时考虑大小写,指定为逗号分隔的对,由“CaseSensitive”
而且“上”
用于区分大小写的搜索或“关闭”
.
FindAll
- - - - - -选项在系统中包含行、端口和注释
“关闭”
(默认)|“上”
选项在搜索中的系统中包含行、端口和注释,指定为逗号分隔的对,由“FindAll”
而且“上”
或“关闭”
.当此选项设置为“上”
,find_system
返回句柄向量,无论如何指定句柄系统
论点。
FirstResultOnly
- - - - - -选项只返回第一个结果
“关闭”
(默认)|“上”
选项只返回第一个结果,然后停止搜索,该结果指定为逗号分隔的对,由“FirstResultOnly”
而且“上”
或“关闭”
.
LookInsideSubsystemReference
- - - - - -选项查看所引用子系统的内部
“上”
(默认)|“关闭”
选项查看模型中引用子系统的内部,并列出指定为逗号分隔对的子块“LookInsideSubsystemReference”
而且“上”
或“关闭”
.
FollowLinks
- - - - - -选项跟随链接进入库块
“关闭”
(默认)|“上”
选项跟随链接进入库块,指定为逗号分隔的对,由“FollowLinks”
而且“上”
或“关闭”
.如果不指定要搜索的系统,find_system
在结果中包含已加载的库,无论您是否设置“FollowLinks”
来“上”
或“关闭”
.您可以使用“FollowLinks”
与“LookUnderMasks”
更新子系统中的库链接。看到更新子系统中的库链接.
IncludeCommented
- - - - - -选项包含注释块
“关闭”
(默认)|“上”
选项在搜索中包含注释块,指定为逗号分隔的对,由“IncludeCommented”
而且“上”
或“关闭”
.
LoadFullyIfNeeded
- - - - - -选项来加载任何部分加载的模型
“上”
(默认)|“关闭”
选项来加载任何部分加载的模型,指定为逗号分隔的对“LoadFullyIfNeeded”
而且“上”
加载模型或“关闭”
禁用加载。例如,使用此选项可以防止负载警告。
LookUnderMasks
- - - - - -在遮罩下搜索的选项
“图形”
(默认)|“没有”
|“功能”
|“所有”
|“上”
|“关闭”
在掩码下搜索的选项,指定为逗号分隔的对,由“LookUnderMasks”
其中一个选项是:
“图形”
—搜索包括没有工作区和对话框的屏蔽子系统。“没有”
—搜索跳过被屏蔽的子系统。“功能”
—搜索包含没有对话框的被屏蔽子系统。“所有”
—搜索包括所有被屏蔽子系统。“上”
—搜索包括所有被屏蔽子系统。“关闭”
—搜索跳过被屏蔽子系统。
正则表达式
- - - - - -选项将搜索表达式视为正则表达式
“关闭”
(默认)|“上”
选项将搜索表达式视为指定为逗号分隔对的正则表达式“正则表达式”
而且“上”
将搜索表达式视为正则表达式或“关闭”
.了解更多关于MATLAB的知识®正则表达式,请参阅正则表达式.
SearchDepth
- - - - - -选项来限制搜索深度
正整数字符向量或字符串标量
选项将搜索深度限制为指定的级别,该级别指定为逗号分隔的对“SearchDepth”
和正整数字符向量或字符串标量。例如,指定' 0 '
为了只搜索加载的系统,' 1 '
对于顶层系统的块和子系统,' 2 '
对于顶层系统及其子系统,等等。默认是搜索所有级别。
变体
- - - - - -搜索变量的选项
“ActiveVariants”
(默认)|“AllVariants”
|“ActivePlusCodeVariants”
请注意
的变体
参数将被删除。使用MatchFilter
代替。有关更多信息,请参见兼容性的考虑.
选项用于搜索变量,指定为逗号分隔的对,由“变异”
其中一个选项是:
“ActiveVariants”
-只搜索活跃的变种选择不同的子系统.“AllVariants”
-搜索所有的变量选择不同的子系统.“ActivePlusCodeVariants”
-搜索所有的变量选择不同的子系统在模拟中是活跃的,是生成代码的一部分。
此搜索约束仅适用于不同的子系统块具有变量控制方式设置为表达式
或标签
.使用find_system
函数与MatchFilter
选项可以操作所有类型的变量块。
MatchFilter
- - - - - -选项来匹配和过滤搜索中的元素
函数处理
选项来匹配和筛选搜索中的元素,如块、系统、行、端口和注释,指定为函数句柄。使用MatchFilter
确定在搜索中是否应包括或跳过元素。
论点:
允许您使用自定义筛选函数筛选元素
避免在过滤器不匹配时处理元素
在块、行或注释上应用复杂过滤器,以便在内部筛选结果
命名函数必须在MATLAB程序文件中定义。函数接受元素的句柄作为输入,并返回两个输出。
函数[匹配,修剪]= func(元素)
输入
元素
正在处理的块的句柄。第一个输出,
匹配
,为逻辑值。如果假
,搜索跳过元素。第二个输出,
修剪
,是一个可选逻辑值,仅适用于元素
是一个子系统。默认值为假
.如果该值设置为真正的
,整个子系统将从搜索中删除。
示例:使用MatchFilter
找出所有非轮廓尺寸而且外港块在一个模型中使用你自己定义的过滤器函数,nonInOutBlocks
.
函数match = nonInOutBlocks(handle) match = true;如果比较字符串(get_param(句柄,“类型”),“块”blockType = get_param(句柄,“BlockType”);如果比较字符串(blockType“尺寸”)| |...比较字符串(blockType“输出港”)匹配= false;结束结束结束
load_system (“vdp”);黑色= find_system (“vdp”,“MatchFilter”@nonInOutBlocks)
变体:动态仿真模块®提供这些内置的匹配过滤器函数,以查找在模拟中活动的变量块或生成的代码的一部分。
Simulink.match.activeVariants
-筛选功能,查找模型编译后仿真中活跃的块。Simulink.match.codeCompileVariants
- Filter函数,查找模型编译后生成的代码的一部分。Simulink.match.allVariants
-过滤功能,以找到所有的块,无论块是活跃的或不活跃的,由于变体。
请注意
为了得到正确的结果,你必须编译模型使用前Simulink.match.activeVariants
而且Simulink.match.codeCompileVariants
过滤器。如果没有编译模型,这些筛选器将返回模型中的所有块。
有关比较这些过滤器的预编译和后编译时结果的示例,请参见使用find_system与内置匹配过滤器选项的变体块.
示例:使用Simulink.match.activeVariants
筛选以查找模型中的活动变量。
目录(fullfile (matlabroot,“例子”,“simulink_variants”,“主要”));模型=“sldemo_variant_subsystems”;load_system(模型);assignin (“基地”,“VSS_MODE”2);set_param(模型,“SimulationCommand”,“更新”);activeBlks = find_system(模型,“MatchFilter”, @Simulink.match.activeVariants);
示例:使用Simulink.match.codeCompileVariants
过滤器来查找作为生成的C代码一部分的变量选择。
目录(fullfile (matlabroot,“例子”,“simulink_variants”,“主要”));load_system (“sldemo_variant_subsystems”);assignin (“基地”,“VSS_MODE”2);sldemo_variant_subsystems ([], [], [],“compileForCodegen”);activeBlks = find_system (“sldemo_variant_subsystems”,“MatchFilter”, @Simulink.match.codeCompileVariants);sldemo_variant_subsystems ([], [], [],“术语”);
示例:使用Simulink.match.allVariants ()
筛选器来查找模型中的所有块。
find_system (“sldemo_variant_subsystems”,“MatchFilter”, @Simulink.match.allVariants);
输出参数
版本历史
之前介绍过的R2006aR2022b:拆卸的警告变体
论点
作为移除的一部分变体
参数将在未来的版本中引入以下警告:
当您使用
find_system
函数没有变体
参数时,该函数在跳过不活动的选项时生成警告不同的子系统在搜索期间阻塞。考虑一个模型不同的子系统有两种不同选择的块,
线性控制器
而且非线性控制器
.的非线性控制器
Block是主动选择。该命令跳过非活动
线性控制器
阻塞并生成警告。块= find_system (“sldemo_variant_subsystems /控制器”)
警告:使用不带' variables '参数的find_system会跳过搜索中未激活的变量子系统块。这个行为将在未来的版本中更改,以查看Variant子系统的所有选择。要找到模拟或代码生成中活动的块,编译模型并使用内置的带有'MatchFilter'选项的变量过滤器。块= 12×1单元阵列{sldemo_variant_subsystems /控制器的}{' sldemo_variant_subsystems /控制器/ sensor1 '} {' sldemo_variant_subsystems /控制器/ sensor2 '} {' sldemo_variant_subsystems /控制器/ sensor3 '} {sldemo_variant_subsystems /控制器/非线性控制器的}{' sldemo_variant_subsystems /控制器/非线性控制器/ sensor1 '} {' sldemo_variant_subsystems /控制器/非线性控制器/ sensor2 '} {' sldemo_variant_subsystems /控制器/非线性控制器/ sensor3 '}{' sldemo_variant_子系统/控制器/非线性控制器/1-D查找表'}{' sldemo_variant_子系统/控制器/非线性控制器/Add'} {' sldemo_variant_子系统/控制器/非线性控制器/Out1'} {' sldemo_variant_子系统/控制器/Out1'}
当您使用
变体
参数,其值设置为“AllVariants”
时,该函数会产生一个警告。块= find_system (“sldemo_variant_subsystems /控制器”,“变异”,“AllVariants”)
警告:“变体”将被删除。不要使用值设置为' allvariables '的' variables ',而要使用值设置为@ simulink .match. allvariables的'MatchFilter'。块= 19×1单元阵列{sldemo_variant_subsystems /控制器的}{' sldemo_variant_subsystems /控制器/ sensor1 '} {' sldemo_variant_subsystems /控制器/ sensor2 '} {' sldemo_variant_subsystems /控制器/ sensor3 '} {sldemo_variant_subsystems /控制器/线性控制器的}{' sldemo_variant_subsystems /控制器/线性控制器/ sensor1 '} {' sldemo_variant_subsystems /控制器/线性控制器/ sensor2 '} {' sldemo_variant_subsystems /控制器/线性控制器/ sensor3 '}{“sldemo_variant_subsystems /控制器/线性控制器/添加”}{' sldemo_variant_subsystems /控制器/线性控制器/离散↵转移Fcn '} {sldemo_variant_subsystems /控制器/线性控制器/着干活的}{sldemo_variant_subsystems /控制器/非线性控制器的}{' sldemo_variant_subsystems /控制器/非线性控制器/ sensor1 '}{‘sldemo_variant_subsystems /控制器/非线性控制器/ sensor2} {' sldemo_variant_subsystems /控制器/非线性控制器/ sensor3 '}{' sldemo_variant_子系统/控制器/非线性控制器/1-D查找表'}{' sldemo_variant_子系统/控制器/非线性控制器/Add'} {' sldemo_variant_子系统/控制器/非线性控制器/Out1'} {' sldemo_variant_子系统/控制器/Out1'}
R2022a:新的内置匹配过滤器,以找到所有的变体块
你可以使用内置的匹配过滤器,Simulink.match.allVariants
,以查找变量模型中的所有块,而不管该块是由于变量而激活的还是非激活的。此过滤器建议替换为AllVariants
选择。
要删除 | 建议更换 |
---|---|
find_system(模型,“变异”,...“AllVariants”); |
find_system(模型,“MatchFilter”,...@Simulink.match.allVariants); |
R2021a:默认行为已更改变体
而且MatchFilter
参数在模型中的变量块
变体
:当你使用find_system
函数而不指定变体
参数时,该函数当前只包含选择的活动变量不同的子系统块在默认情况下。对于其他变量块,如变异来源,变体水槽,或不同的子系统块的在变量子系统外部传播条件参数设置为
在
,该函数包含搜索中的所有选项。考虑一个模型不同的子系统它有两种不同的选择,
线性控制器
而且非线性控制器
.该命令只返回活动的添加模型中的块。
add_blocks = find_system (“sldemo_variant_subsystems /控制器”,...“BlockType”,“和”)
add_blocks = 1×1 cell array {' sldemo_variant_子系统/控制器/非线性控制器/Add'}
MatchFilter
:当你使用find_system
函数与MatchFilter
参数时,该函数在默认情况下对活动和非活动变量选择应用筛选器。考虑一个模型不同的子系统它有两种不同的选择,
线性控制器
而且非线性控制器
.滤波器的功能findAddBlocks
发现所有的添加模型中的块。函数match = findAddBlocks(句柄)match = strcmp(get_param(句柄),“类型”),“块”) & &...比较字符串(get_param(句柄,“BlockType”),“和”);结束
该命令返回活动和非活动添加模型中的块。
add_blocks = find_system (“sldemo_variant_subsystems”,“MatchFilter”,...@findAddBlocks)
add_blocks = 2×1 cell array {' sldemo_variant_子系统/控制器/线性控制器/Add'} {' sldemo_variant_子系统/控制器/非线性控制器/Add'}
R2021a:变体
参数将被删除
的变体
参数将被删除find_system
在未来的版本中。函数调用变体
论点继续工作与警告。
使用find_system
函数与变体
参数会产生不一致的搜索结果。的find_system
函数是一个编辑时操作,但是要确定一个块在具有所有类型的变量块的模型中是否处于活动状态,您需要编译模型。
为了找到在模拟或代码生成期间活动的变量块,编译模型并使用find_system
函数与MatchFilter
论点。
的不同值的建议替换变体
论点。
要删除 | 建议更换 |
---|---|
find_system(模型,“变异”,...“ActiveVariants”); |
set_param(模型,“SimulationCommand”,“更新”);find_system(模型,“MatchFilter”,...@Simulink.match.activeVariants); |
find_system(模型,“变异”,...“ActivePlusCodeVariants”); |
模型 ([], [], [],“compileForCodegen”);activeBlks = find_system(模型,“MatchFilter”,...@Simulink.match.codeCompileVariants);模型 ([], [], [],“术语”); |
当您使用find_system
函数时,不能同时指定MatchFilter
而且变体
参数。
该命令会产生一个错误。
find_system (bdroot“MatchFilter”, @Simulink.match.activeVariants...“变异”,“ActiveVariants”);
R2020b:在搜索过程中过滤元素MatchFilter
要在搜索期间匹配和筛选模型元素,您可以定义一个自定义筛选函数,并将函数句柄作为值传递给MatchFilter
名称-值参数。
要找到模拟中活动的变量块或生成代码的一部分,您可以使用内置的匹配筛选函数,Simulink.match.activeVariants
,Simulink.match.codeCompileVariants
,Simulink.match.allVariants
,在编译模型后。
MATLAB命令
你点击了一个对应于这个MATLAB命令的链接:
在MATLAB命令窗口中输入命令来运行该命令。Web浏览器不支持MATLAB命令。
您也可以从以下列表中选择网站:
如何获得最佳的网站性能
选择中国网站(中文或英文)以获得最佳的网站表现。其他MathWorks国家网站没有针对从您的位置访问进行优化。