find_system
모델, 블록, 선, 포트 및 주석 찾기
구문
설명
는 불러온 모델과, 그 모델의 객체 중 하나 이상의 Objects
= find_system(Name,Value
)Name,Value
쌍 인수로 지정된 기준을 충족하는 객체를 반환합니다. 이 구문을 사용하여 검색 제약 조건을 지정하고 특정 파라미터 값을 검색할 수 있습니다. 파라미터와 값 쌍 앞에 검색 제약 조건을 지정하십시오.
는 지정된 모델에서 지정된 조건을 충족하는 객체를 반환합니다.Objects
= find_system(Model
,Name,Value
)
예제
불러온 모델, 라이브러리 및 해당 블록 찾기
예제를 엽니다. 그런 다음 vdp
모델을 불러옵니다.
load_system('vdp')
불러온 모델, 라이브러리 및 그에 속한 블록을 모두 찾습니다.
find_system
ans = 13x1 cell
{'vdp' }
{'vdp/Callback Button'}
{'vdp/Constant' }
{'vdp/Mu' }
{'vdp/Product' }
{'vdp/Scope' }
{'vdp/Square' }
{'vdp/Sum' }
{'vdp/Sum1' }
{'vdp/x1' }
{'vdp/x2' }
{'vdp/Out1' }
{'vdp/Out2' }
특정 모델과 그에 속한 블록 찾기
예제를 엽니다. 그런 다음 vdp
및 ex_sldemo_clutch
모델을 불러옵니다.
load_system({'vdp','ex_sldemo_clutch'})
vdp
모델과 그에 속한 블록을 찾습니다.
find_system('vdp')
ans = 13x1 cell
{'vdp' }
{'vdp/Callback Button'}
{'vdp/Constant' }
{'vdp/Mu' }
{'vdp/Product' }
{'vdp/Scope' }
{'vdp/Square' }
{'vdp/Sum' }
{'vdp/Sum1' }
{'vdp/x1' }
{'vdp/x2' }
{'vdp/Out1' }
{'vdp/Out2' }
불러온 모델, 서브시스템, 라이브러리 찾기
예제를 엽니다. 그런 다음 vdp
모델을 불러옵니다.
load_system('vdp')
불러온 모델, 서브시스템, 라이브러리를 모두 찾습니다. 서브시스템 이름은 해당 서브시스템을 독립적으로 불러올 수 있는 경우에만 반환됩니다.
find_system('type','block_diagram')
ans = 1x1 cell array
{'vdp'}
서브시스템의 자식 검색하기
예제를 엽니다. 그런 다음 ex_sldemo_clutch
모델을 불러옵니다.
load_system('ex_sldemo_clutch')
ex_sldemo_clutch
모델에서 Unlocked
서브시스템의 자식에 해당하는 모든 Goto 블록의 이름을 반환합니다.
find_system('ex_sldemo_clutch/Unlocked','SearchDepth',1,'BlockType','Goto')
ans = 2x1 cell
{'ex_sldemo_clutch/Unlocked/Goto' }
{'ex_sldemo_clutch/Unlocked/Goto1'}
여러 기준을 사용하여 검색하기
예제를 엽니다. 그런 다음 vdp
모델을 불러옵니다.
load_system('vdp')
vdp
모델에서 다음 두 가지 조건을 충족하는 블록을 찾습니다.
블록이 Integrator 블록입니다.
초기 조건의 값이 0입니다.
find_system('vdp','BlockType','Integrator','InitialCondition','0')
ans = 1x1 cell array
{'vdp/x2'}
선 및 주석 찾기
예제를 엽니다. 그런 다음 vdp
모델을 불러옵니다.
load_system('vdp')
find_system
함수를 사용하여 vdp
모델에서 선을 찾습니다. 검색에 선을 포함하려면 'FindAll'
을 'on'
으로 지정하십시오.
l = find_system('vdp','FindAll','on','type','line')
l = 18×1
389.0072
388.0065
387.0063
385.0054
384.0057
383.0067
382.0065
381.0072
380.0071
379.0065
⋮
find_system
함수를 사용하여 vdp
모델에서 주석을 찾습니다. 검색에 주석을 포함하려면 'FindAll'
을 'on'
으로 지정하십시오.
an = find_system('vdp','FindAll','on','type','annotation')
an = 3×1
392.0056
391.0059
390.0065
특정 블록 파라미터 값 검색하기
예제를 엽니다. 그런 다음 vdp
및 f14
모델을 불러옵니다.
models={'vdp','f14'}; load_system(models)
vdp
및 f14
모델에서 값이 3
인 Block Dialog
상자 파라미터가 있는 블록을 모두 찾습니다.
find_system(models,'BlockDialogParams','3')
ans = 3x1 cell
{'vdp/Square' }
{'f14/Aircraft...' }
{'f14/Controller/q (rad//sec)'}
정규 표현식을 사용하여 검색하기
예제를 엽니다. 그런 다음 ex_sldemo_clutch
및 vdp
모델을 불러옵니다.
load_system({'ex_sldemo_clutch','vdp'})
현재 불러온 모델의 최상위에서 3
으로 시작하는 블록 파라미터 대화 상자 파라미터 값을 가진 블록을 모두 찾습니다.
find_system('SearchDepth','1','regexp','on','BlockDialogParams','^3')
ans = 2x1 cell
{'vdp/Square' }
{'ex_sldemo_clutch/w'}
정규 표현식을 사용하여 부분 일치 검색하기
정규 표현식을 사용하여 검색할 경우 일치시킬 문자형 벡터의 일부를 지정하여 그 문자형 벡터가 포함된 모든 객체를 반환할 수 있습니다.
ex_sldemo_clutch
모델에서 Integrator 블록을 모두 찾습니다.
load_system('ex_sldemo_clutch'); ports=find_system('ex_sldemo_clutch','regexp','on','blocktype','Integrator')
ports = 3x1 cell
{'ex_sldemo_clutch/Locked/Engine//Vehicle...'}
{'ex_sldemo_clutch/Unlocked/Engine...' }
{'ex_sldemo_clutch/Unlocked/Vehicle...' }
서브시스템에서 라이브러리 링크 업데이트하기
라이브러리 링크에 해당하는 단일 서브시스템이 포함되어 있는 myModel
이라는 모델이 있다고 가정하겠습니다. 마지막으로 모델이 열린 이후 Gain 블록이 라이브러리의 해당 서브시스템에 추가되었습니다.
모델을 엽니다. 'FollowLinks'
를 'off'
로 설정한 상태로 find_system
을 사용합니다. 이 명령은 라이브러리 링크를 따라 해당 서브시스템까지 들어가지 않고, 최상위 수준에 있는 서브시스템만 반환합니다.
open_system('myModel') find_system(bdroot,'LookUnderMasks','all','FollowLinks', 'off')
ans = 'myModel' 'myModel/Subsystem'
'FollowLinks'
를 'on'
으로 설정한 상태로 find_system
을 사용합니다. find_system
이 라이브러리 링크를 업데이트하고 해당 서브시스템의 블록을 반환합니다.
find_system(bdroot,'LookUnderMasks','all','FollowLinks','on')
Updating Link: myModel/Subsystem/Gain Updating Link: myModel/Subsystem/Gain ans = 'myModel' 'myModel/Subsystem' 'myModel/Subsystem/Gain'
값을 핸들로 반환하기
함수를 호출할 때 해당 함수가 작용하는 모델이나 블록을 지정해야 하고 이러한 함수 호출을 여러 번 수행해야 할 때는 파일 경로 대신 핸들을 사용하여 모델이나 블록을 지정합니다.
find_system
함수를 여러 번 호출할 때 vdp model
을 핸들로 지정합니다.
예제를 엽니다. 그런 다음 vdp
모델을 불러옵니다.
load_system('vdp')
vdp
모델의 핸들을 가져옵니다.
h = get_param('vdp','Handle')
h = 152.0001
vdp
모델에서 값이 0
인 블록 파라미터 대화 상자 파라미터를 찾습니다. 검색할 모델을 vdp
모델의 핸들로 지정합니다.
find_system(h,'BlockDialogParams','0')
ans = 8×1
279.0001
279.0001
287.0001
329.0001
332.0001
332.0001
334.0001
334.0001
vdp
모델에서 3
으로 시작하는 블록 파라미터 대화 상자 파라미터 값을 가진 블록 파라미터를 찾습니다. 검색할 모델을 vdp
모델의 핸들로 지정합니다.
find_system(h,'regexp','on','BlockDialogParams','^3')
ans = 290.0001
vdp
모델에서 블록 이름에 문자형 벡터 'port'
가 포함된 블록을 찾습니다. 검색할 모델을 vdp
모델의 핸들로 지정합니다.
find_system(h,'regexp','on','blocktype','port')
ans = 2×1
332.0001
334.0001
사용자 지정 함수를 사용하여 검색 필터링하기
vdp
모델에서 Inport 블록과 Outport 블록 이외의 블록을 찾으려면 사용자 지정 필터 함수와 함께 MatchFilter 인수를 사용하십시오.
이 예제의 사용자 지정 함수는 nonInOutBlocks.m
파일에 정의되어 있습니다.
function match = nonInOutBlocks(handle) match = true; if strcmp(get_param(handle,'Type'),'block') blockType = get_param(handle,'BlockType'); if strcmp(blockType,'Inport') || strcmp(blockType,'Outport') match = false; end end end
함수 핸들을 MatchFilter
인수의 값으로 제공합니다.
load_system('vdp'); blks = find_system('vdp','MatchFilter',@nonInOutBlocks);
내장 필터 함수를 사용하여 Variant 블록 찾기
slexVariantSubsystems
모델을 불러옵니다.
model = 'slexVariantSubsystems';
load_system(model);
VSS_LINEAR_CONTROLLER = VariantExpression with properties: Condition: 'VSS_MODE==1'
VSS_NONLINEAR_CONTROLLER = VariantExpression with properties: Condition: 'VSS_MODE==2'
VSS_MODE = 2
assignin('base','VSS_MODE',2);
Simulink.match.activeVariants
함수를 사용하여 모델 컴파일 후 시뮬레이션에서 활성 상태인 Variant 블록을 찾습니다.
set_param(model,'SimulationCommand','update'); find_system(model,'MatchFilter',@Simulink.match.activeVariants);
Simulink.match.codeCompileVariants
함수를 사용하여 모델 컴파일 후 생성된 C 코드의 일부가 되는 Variant 선택지를 찾습니다.
slexVariantSubsystems([],[],[],'compileForCodegen'); find_system(model,'MatchFilter',@Simulink.match.codeCompileVariants); slexVariantSubsystems([],[],[],'term');
Simulink.match.allVariants
함수를 사용하여 블록의 상태가 Variant에 따라 활성이든 비활성이든 상관없이 모든 블록을 찾습니다.
find_system(model,'MatchFilter',@Simulink.match.allVariants);
Simulink.match.legacy.filterOutCodeInactiveVariantSubsystemChoice
함수를 사용하여 시뮬레이션에서 활성 상태이거나 편집 시 생성 코드의 일부가 되는 Variant Subsystem 선택지 블록을 찾습니다. 편집 시 필터의 제한 사항에 대한 자세한 내용은 MatchFilter 항목을 참조하십시오.
find_system(model, ... 'MatchFilter',@Simulink.match.legacy.filterOutCodeInactiveVariantSubsystemChoices);
Simulink.match.legacy.filterOutInactiveVariantSubsystemChoices
함수를 사용하여 편집 시 활성 Variant Subsystem 선택지 블록을 찾습니다. 편집 시 필터의 제한 사항에 대한 자세한 내용은 MatchFilter 항목을 참조하십시오.
find_system(model, ... 'MatchFilter', @Simulink.match.legacy.filterOutInactiveVariantSubsystemChoices);
Simulink.match.variantAssemblySubsystems
함수를 사용하여 slexVariantAssemblySubsystemWithMaskInLabel
모델에서 모든 Variant Assembly Subsystem 블록을 찾습니다.
load_system('slexVariantAssemblySubsystemWithMaskInLabel'); find_system('slexVariantAssemblySubsystemWithMaskInLabel','MatchFilter',@Simulink.match.variantAssemblySubsystems);
입력 인수
Model
— 검색할 모델
경로 이름 | 경로 이름으로 구성된 셀형 배열 | 핸들 | 핸들로 구성된 벡터
검색할 모델로, 전체 모델 경로 이름, 모델 경로 이름으로 구성된 셀형 배열, 핸들 또는 핸들로 구성된 벡터로 지정됩니다.
예: 'MyModel/Subsystem1'
예: {'vdp','ex_sldemo_clutch'}
이름-값 인수
선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN
으로 지정합니다. 여기서 Name
은 인수 이름이고 Value
는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 합니다.
R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name
을 따옴표로 묶으십시오.
예: 'SearchDepth','0','LookUnderMasks','none','BlockType','Goto'
는 불러온 모델에서 마스크 처리된 서브시스템은 제외하고 Goto 블록을 검색합니다.
find_system
함수를 사용할 경우 Name,Value
쌍 인수는 다음을 포함할 수 있습니다.
검색 조건 옵션과 값 쌍으로 지정된 검색 제약 조건(예:
'CaseSensitive','on'
)파라미터 이름과 값 쌍으로 지정된 파라미터 값(예:
'BlockType','Gain'
)
검색 조건 인수 쌍과 파라미터 값 인수 쌍은 어떠한 순서로도 지정할 수 있지만, 검색 조건 인수 쌍이 파라미터 값 인수 쌍 앞에 와야 합니다.
블록 파라미터 목록은 Block-Specific Parameters 항목을 참조하십시오.
BlockDialogParams
— 블록 파라미터에서 지정된 값을 검색하는 검색 조건 옵션
문자형 벡터 | string형 스칼라
블록 대화 상자 파라미터에서 지정된 값을 검색하는 옵션으로, 'BlockDialogParams'
와 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 이 쌍은 다른 검색 제약 조건 쌍 뒤에 와야 합니다.
CaseSensitive
— 일치할 경우 대/소문자를 고려하는 검색 조건 옵션
'on'
(디폴트 값) | 'off'
일치할 경우 대/소문자를 고려하는 옵션으로, 'CaseSensitive'
와 함께 'on'
또는 'off'
가 쉼표로 구분되어 지정됩니다.
FindAll
— 모델 내의 선, 포트, 주석을 포함시키는 검색 조건 옵션
'off'
(디폴트 값) | 'on'
모델의 선, 포트, 주석을 검색에 포함하는 옵션으로, 'FindAll'
과 함께 'on'
또는 'off'
가 쉼표로 구분되어 지정됩니다. 이 옵션을 'on'
으로 설정할 경우 find_system
은 Model
인수를 전체 모델 경로 이름, 모델 경로 이름으로 구성된 셀형 배열, 핸들 또는 핸들로 구성된 벡터로 지정하는지 여부에 관계없이 핸들로 구성된 벡터를 반환합니다.
Type
— 블록 파라미터에서 특정 유형을 검색하는 검색 조건 옵션
'block'
(디폴트 값) | 'line'
| 'port'
| 'annotation'
특정 유형의 결과만 반환하는 옵션으로, 'Type'
과 함께 다음 옵션 중 하나가 쉼표로 구분되어 지정됩니다.
'block'
'line'
'port'
'annotation'
모델에서 선, 포트 또는 주석을 찾으려면 먼저 FindAll
의 값을 'on'
으로 지정한 다음 유형을 지정해야 합니다. 예를 들어 myModel
이라는 모델에서 주석을 찾으려면 명령줄에 다음 명령을 입력하십시오.
find_system('myModel','FindAll','on','Type','annotation')
FirstResultOnly
— 첫 번째 결과만 반환하는 검색 조건 옵션
'off'
(디폴트 값) | 'on'
첫 번째 결과만 반환하고 검색을 중지하는 옵션으로, 'FirstResultOnly'
와 함께 'on'
또는 'off'
가 쉼표로 구분되어 지정됩니다.
LookInsideSubsystemReference
— 참조된 서브시스템 내부를 탐색하는 검색 조건 옵션
'on'
(디폴트 값) | 'off'
모델 내의 참조된 서브시스템의 내부를 탐색하여 자식 블록을 나열하는 옵션으로, 'LookInsideSubsystemReference'
와 함께 'on'
또는 'off'
가 쉼표로 구분되어 지정됩니다.
FollowLinks
— 링크를 따라 라이브러리 블록으로 가는 검색 조건 옵션
'off'
(디폴트 값) | 'on'
링크를 따라 라이브러리 블록으로 가는 옵션으로, 'FollowLinks'
와 함께 'on'
또는 'off'
가 쉼표로 구분되어 지정됩니다. 검색할 모델을 지정하지 않은 경우 find_system
은 'FollowLinks'
를 'on'
으로 설정했든 'off'
로 설정했든지에 상관없이 불러온 라이브러리를 검색 결과에 포함합니다. 'FollowLinks'
를 'LookUnderMasks'
와 함께 사용하여 서브시스템 내의 라이브러리 링크를 업데이트할 수 있습니다. 서브시스템에서 라이브러리 링크 업데이트하기 항목을 참조하십시오.
IncludeCommented
— 주석 처리된 블록을 포함시키는 검색 조건 옵션
'off'
(디폴트 값) | 'on'
주석 처리된 블록을 검색에 포함하는 옵션으로, 'IncludeCommented'
와 함께 'on'
또는 'off'
가 쉼표로 구분되어 지정됩니다.
LoadFullyIfNeeded
— 부분적으로 불러온 모델을 불러오는 검색 조건 옵션
'on'
(디폴트 값) | 'off'
부분적으로 불러온 모델을 불러오는 옵션으로, 'LoadFullyIfNeeded'
와 함께 'on'
(모델을 불러옴) 또는 'off'
(불러오기를 비활성화함)가 쉼표로 구분되어 지정됩니다. 예를 들어, 불러오기 경고를 방지하려면 이 옵션을 사용합니다.
LookUnderMasks
— 마스크 내부를 검색하는 검색 조건 옵션
'graphical'
(디폴트 값) | 'none'
| 'functional'
| 'all'
마스크 내부를 검색하는 옵션으로, 'LookUnderMasks'
와 함께 다음 옵션 중 하나가 쉼표로 구분되어 지정됩니다.
'none'
— 마스크 처리된 서브시스템을 검색에서 건너뜁니다.'all'
— 마스크 처리된 서브시스템을 모두 검색에 포함합니다.'functional'
— 파라미터, 설명, 도움말 문자열, UI 요소 없이 아이콘 그리기 명령 또는 마스크 초기화 명령이 있는 마스크 처리된 서브시스템을 검색에 포함합니다.'graphical'
— 작업 공간, 대화 상자, 도움말 문자열, UI 요소 없이 아이콘 그리기 명령만 있는 마스크 처리된 서브시스템을 검색에 포함합니다.
참고
옵션 'none'
은 이전 옵션 'off'
를 대체합니다. 옵션 'all'
은 이전 옵션 'on'
을 대체합니다.
RegExp
— 검색 표현식을 정규 표현식으로 처리하는 검색 조건 옵션
'off'
(디폴트 값) | 'on'
검색 표현식을 정규 표현식으로 처리하는 옵션으로, 'RegExp'
와 함께 'on'
또는 'off'
가 쉼표로 구분되어 지정됩니다. 'RegExp'
를 'on'
으로 설정하면 검색할 때 검색 표현식을 정규 표현식으로 처리합니다. MATLAB® 정규 표현식에 대한 자세한 내용은 정규 표현식 항목을 참조하십시오.
SearchDepth
— 검색 심도를 제한하는 검색 조건 옵션
양의 정수 문자형 벡터 또는 string형 스칼라
검색 심도를 지정된 수준으로 제한하는 옵션으로, 'SearchDepth'
와 함께 양의 정수 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 예를 들어, 불러온 모델만 검색하려면 '0'
을, 모델 계층 구조의 최상위 수준의 블록과 서브시스템을 검색하려면 '1'
을, 모델 계층 구조의 최상위 수준과 그 자식을 검색하려면 '2'
를 지정하는 식입니다. 디폴트는 모든 수준을 검색하는 것입니다.
Variants
— Variant를 검색하는 검색 조건 옵션
'ActiveVariants'
(디폴트 값) | 'AllVariants'
| 'ActivePlusCodeVariants'
참고
Variants
인수는 제거될 예정입니다. MatchFilter
를 대신 사용하십시오. 자세한 내용은 호환성 관련 고려 사항 항목을 참조하십시오.
Variant를 검색하는 옵션으로, 'Variants'
와 함께 다음 옵션 중 하나가 쉼표로 구분되어 지정됩니다.
'ActiveVariants'
— Variant Subsystem에서 활성 Variant 선택지만 검색합니다.'AllVariants'
— Variant Subsystem에서 모든 Variant 선택지를 검색합니다.'ActivePlusCodeVariants'
— 시뮬레이션에서 활성 상태이면서 생성 코드의 일부가 되는 모든 Variant 선택지를 Variant Subsystem에서 검색합니다.
이 검색 제약 조건은 Variant 제어 모드가 expression
또는 label
로 설정된 Variant Subsystem 블록에만 적용됩니다. 모든 유형의 Variant 블록에 대해 동작하도록 하려면 find_system
함수를 MatchFilter
옵션과 함께 사용하십시오.
MatchFilter
— 검색에서 요소를 일치시키고 필터링하는 검색 조건 옵션
함수 핸들
검색에서 블록, 모델, 선, 포트, 주석 등의 요소를 일치시키고 필터링하는 옵션으로, 함수 핸들로 지정됩니다. 요소를 검색에 포함할지 검색에서 건너뛸지를 결정하려면 MatchFilter
를 사용하십시오.
이 인수를 통해 다음이 가능합니다.
사용자 지정 필터 함수로 요소를 필터링할 수 있습니다.
필터가 일치하지 않을 때 요소가 처리되는 것을 방지할 수 있습니다.
내부적으로 결과를 필터링하도록 블록, 선 또는 주석에 복합 필터를 적용할 수 있습니다.
명명된 함수는 MATLAB 프로그램 파일 내에서 정의해야 합니다. 이 함수는 요소의 핸들을 입력으로 받아 두 개의 출력을 반환합니다.
function [match, prune] = func(element)
입력
element
는 처리 중인 컴포넌트의 핸들(예: 블록 핸들)입니다.첫 번째 출력
match
는 논리값입니다.false
인 경우 요소를 검색에서 건너뜁니다.두 번째 출력
prune
은 선택적 논리값으로,element
가 서브시스템인 경우에만 적용됩니다. 디폴트 값은false
입니다. 이 값이true
로 설정된 경우 검색에서 전체 서브시스템이 제외됩니다.
Variant: Simulink®는 Variant 블록을 찾기 위해 다음과 같이 내장된 일치 필터 함수를 제공합니다.
컴파일 후 시간 필터 함수:
Simulink.match.activeVariants
— 모델 컴파일 후 시뮬레이션에서 활성 상태인 블록을 찾는 필터 함수.Simulink.match.codeCompileVariants
— 모델 컴파일 후 생성 코드의 일부가 되는 블록을 찾는 필터 함수.Simulink.match.allVariants
— 블록의 상태가 Variant에 따라 활성이든 비활성이든 상관없이 모든 블록을 찾는 필터 함수.Simulink.match.variantAssemblySubsystems
— 모든 Variant Assembly Subsystem 블록을 찾는 필터 함수.
참고
정확한 결과를 얻으려면 Simulink.match.activeVariants
필터와 Simulink.match.codeCompileVariants
필터를 사용하기 전에 먼저 모델을 컴파일해야 합니다. 모델이 컴파일되지 않았으면 필터는 모델의 모든 블록을 반환합니다.
이러한 필터의 컴파일 전/후 결과를 비교한 예를 보려면 Use find_system with Built-In MatchFilter Options for Variant Blocks 항목을 참조하십시오.
Variant Subsystem 블록에 대한 편집 시 필터 함수:
Simulink.match.legacy.filterOutCodeInactiveVariantSubsystemChoices
— 시뮬레이션에서 활성 상태이거나 생성 코드의 일부가 되는 Variant Subsystem 선택지 블록을 찾는 필터 함수입니다. 이 함수는Variants
인수의'ActivePlusCodeVariants'
옵션과 유사한 결과를 낳습니다.Simulink.match.legacy.filterOutInactiveVariantSubsystemChoices
— 활성 Variant Subsystem 선택지 블록을 찾는 필터 함수입니다. 이 함수는Variants
인수의'ActiveVariants'
옵션과 유사한 결과를 낳습니다.
편집 시 필터의 제한 사항:
필터는 CompiledVariantInfo 블록 파라미터의 컴파일 후 블록 활성 상태 정보를 사용하지 않습니다.
필터는 다음 블록 파라미터 설정을 가진 Variant Subsystem 블록에만 적용됩니다.
Variant 제어 모드가
표현식
또는레이블
로 설정됨Variant Subsystem 외부에 조건 전파가
off
로 설정됨
이 필터는
find_system
,find_mdlrefs
,Simulink.FindOptions
의 컨텍스트 내에서 사용할 때만 블록 핸들이 Variant Subsystem의 활성 선택지 내에 있는지 식별할 수 있습니다.
모든 유형의 Variant 블록에 대해 동작하도록 하려면 모델 컴파일 후 Simulink.match.codeCompileVariants
또는 Simulink.match.activeVariants
필터를 사용하십시오.
출력 인수
Objects
— 일치하는 객체
경로 이름으로 구성된 셀형 배열 | 핸들로 구성된 벡터
검색된 일치하는 객체로, 경로 이름으로 구성된 셀형 배열 또는 핸들로 구성된 벡터로 반환됩니다.
검색된 객체는 다음 조건이 모두 충족되면 경로 이름으로 구성된 셀형 배열로 반환됩니다.
검색 조건 옵션
FindAll
이 디폴트 값인'off'
로 설정되어 있습니다.Model
을 경로 이름 또는 경로 이름으로 구성된 셀형 배열로 지정했거나, 모델을 지정하지 않았습니다.
검색된 객체는 다음 조건 중 하나 이상이 충족되면 핸들로 구성된 벡터로 반환됩니다.
FindAll
값을'on'
으로 설정했습니다.Model
을 핸들 또는 핸들로 구성된 벡터로 지정했습니다.
버전 내역
R2006a 이전에 개발됨R2022b: Variants
인수 제거에 대한 경고
향후 릴리스에서 Variants
인수가 제거될 예정이기 때문에 다음 경고가 추가되었습니다.
find_system
함수를Variants
인수 없이 사용할 경우, 이 함수는 Variant Subsystem 블록의 비활성 선택지를 검색에서 건너뛰면 경고를 생성합니다.모델의 Variant Subsystem 블록에 두 개의 Variant 선택지
Linear Controller
와Nonlinear Controller
가 있다고 가정해 보겠습니다.Nonlinear Controller
블록은 활성 선택지입니다.다음 명령은 비활성
Linear Controller
블록을 건너뛰고 경고를 생성합니다.blocks = find_system('sldemo_variant_subsystems/Controller')
Warning: Using find_system without the 'Variants' argument skips inactive Variant Subsystem blocks in the search. This behavior will change in a future release to look at all choices of the Variant Subsystem. To find blocks thatare active in simulation or code generation, compile the model and use the built-in variant filters with the 'MatchFilter' option. blocks = 12×1 cell array {'sldemo_variant_subsystems/Controller' } {'sldemo_variant_subsystems/Controller/sensor1' } {'sldemo_variant_subsystems/Controller/sensor2' } {'sldemo_variant_subsystems/Controller/sensor3' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/sensor1' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/sensor2' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/sensor3' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/1-D Lookup Table'} {'sldemo_variant_subsystems/Controller/Nonlinear Controller/Add' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/Out1' } {'sldemo_variant_subsystems/Controller/Out1' }
값이
'AllVariants'
로 설정된Variants
인수를 사용하면 함수는 경고를 생성합니다.blocks = find_system('sldemo_variant_subsystems/Controller',... 'Variants','AllVariants')
Warning: 'Variants' will be removed. Instead of using 'Variants' with value set to 'AllVariants', use 'MatchFilter' with value set to @Simulink.match.allVariants. blocks = 19×1 cell array {'sldemo_variant_subsystems/Controller' } {'sldemo_variant_subsystems/Controller/sensor1' } {'sldemo_variant_subsystems/Controller/sensor2' } {'sldemo_variant_subsystems/Controller/sensor3' } {'sldemo_variant_subsystems/Controller/Linear Controller' } {'sldemo_variant_subsystems/Controller/Linear Controller/sensor1' } {'sldemo_variant_subsystems/Controller/Linear Controller/sensor2' } {'sldemo_variant_subsystems/Controller/Linear Controller/sensor3' } {'sldemo_variant_subsystems/Controller/Linear Controller/Add' } {'sldemo_variant_subsystems/Controller/Linear Controller/Discrete↵Transfer Fcn'} {'sldemo_variant_subsystems/Controller/Linear Controller/Out1' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/sensor1' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/sensor2' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/sensor3' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/1-D Lookup Table' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/Add' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/Out1' } {'sldemo_variant_subsystems/Controller/Out1' }
R2022a: 모든 Variant 블록을 찾는 새로운 내장 일치 필터
내장 일치 필터인 Simulink.match.allVariants
를 사용하여, 블록의 상태가 Variant에 따라 활성이든 비활성이든 상관없이 Variant 모델에 있는 모든 블록을 찾을 수 있습니다. 이 필터가 AllVariants
대신 권장되는 대체 옵션입니다.
제거될 예정임 | 권장되는 대체 옵션 |
---|---|
find_system(model,'Variants', ... 'AllVariants'); | find_system(model,'MatchFilter', ... @Simulink.match.allVariants); |
R2021a: Variant 블록이 있는 모델에서 Variants
인수와 MatchFilter
인수의 디폴트 동작이 변경됨
Variants
:find_system
함수를Variants
인수를 지정하지 않고 사용할 경우, 현재 이 함수는 기본적으로 Variant Subsystem 블록의 활성 Variant 선택지만 검색에 포함합니다.그 외 Variant Source, Variant Sink, Variant Subsystem 같은 다른 Variant 블록에서 Variant Subsystem 외부에 조건 전파 파라미터가
on
으로 설정된 경우 이 함수는 모든 선택지를 검색에 포함합니다.모델의 Variant Subsystem에 두 개의 Variant 선택지
Linear Controller
와Nonlinear Controller
가 있는 경우를 가정해 보겠습니다.다음 명령은 모델에서 활성 Add 블록만 반환합니다.
add_blocks = find_system('sldemo_variant_subsystems/Controller',... 'BlockType','Sum')
add_blocks = 1×1 cell array {'sldemo_variant_subsystems/Controller/Nonlinear Controller/Add'}
MatchFilter
:find_system
함수를MatchFilter
인수와 함께 사용할 경우, 이 함수는 기본적으로 활성 및 비활성 Variant 선택지에 필터를 적용합니다.모델의 Variant Subsystem에 두 개의 Variant 선택지
Linear Controller
와Nonlinear Controller
가 있는 경우를 가정해 보겠습니다. 필터 함수findAddBlocks
는 모델에서 모든 Add 블록을 찾습니다.function match = findAddBlocks(handle) match = strcmp(get_param(handle, 'Type'), 'block') &&... strcmp(get_param(handle, 'BlockType'), 'Sum'); end
다음 명령은 모델에서 활성 및 비활성 Add 블록을 반환합니다.
add_blocks = find_system('sldemo_variant_subsystems','MatchFilter',... @findAddBlocks)
add_blocks = 2×1 cell array {'sldemo_variant_subsystems/Controller/Linear Controller/Add' } {'sldemo_variant_subsystems/Controller/Nonlinear Controller/Add'}
R2021a: Variants
인수는 제거될 예정임
향후 릴리스에서 Variants
인수는 find_system
에서 제거될 예정입니다. Variants
인수를 사용한 함수 호출은 여전히 작동하지만 경고가 발생합니다.
find_system
함수에 Variants
인수를 사용하면 검색 결과가 일관되지 않습니다. find_system
함수는 편집 시 동작입니다. 하지만 모든 유형의 Variant 블록을 갖고 있는 모델에서 어떤 블록이 활성 상태인지 아닌지 결정하려면 모델을 컴파일해야 합니다.
시뮬레이션 또는 코드 생성 중에 활성 상태인 Variant 블록을 찾으려면, 모델을 컴파일하고 find_system
함수를 MatchFilter
인수와 함께 사용하십시오.
다음 표에는 Variants
인수의 각기 다른 값에 대해 권장되는 대체 옵션이 나와 있습니다.
제거될 예정임 | 권장되는 대체 옵션 |
---|---|
find_system(model,'Variants', ... 'ActiveVariants'); | set_param(model,'SimulationCommand','update'); find_system(model,'MatchFilter', ... @Simulink.match.activeVariants); |
find_system(model,'Variants', ... 'ActivePlusCodeVariants'); | model([], [], [], 'compileForCodegen'); activeBlks= find_system(model,'MatchFilter', ... @Simulink.match.codeCompileVariants); model([], [], [], 'term'); |
find_system
함수를 사용할 때 MatchFilter
인수와 Variants
인수를 모두 지정할 수는 없습니다.
다음 명령은 오류를 생성합니다.
find_system(bdroot,'MatchFilter',@Simulink.match.activeVariants,... 'Variants','ActiveVariants');
R2020b: 검색 중에 MatchFilter
를 사용하여 요소를 필터링함
검색 중에 모델 요소를 일치시키고 필터링하려면, 사용자 지정 필터 함수를 정의하고 함수 핸들을 MatchFilter
이름-값 인수에 값으로 전달합니다.
시뮬레이션에서 활성 상태이거나 생성 코드의 일부가 되는 Variant 블록을 찾으려면, 모델을 컴파일한 후에 내장 일치 필터 함수 Simulink.match.activeVariants
, Simulink.match.codeCompileVariants
, Simulink.match.allVariants
를 사용합니다.
MATLAB 명령
다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.
명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)