Main Content

find_system

시스템, 블록, 선, 포트 및 주석 찾기

페이지 내 모두 축소

구문

Objects = find_system
Objects = find_system(System)
Objects = find_system(Name,Value)
Objects = find_system(System,Name,Value)

설명

예제

Objects = find_system은 불러온 시스템과 그 시스템의 블록을 서브시스템까지 포함하여 반환합니다.

예제

Objects = find_system(System)은 지정된 시스템과 그 시스템의 블록을 반환합니다.

예제

Objects = find_system(Name,Value)는 불러온 시스템과, 그 시스템의 객체 중 하나 이상의 Name,Value 쌍 인수로 지정된 기준을 충족하는 객체를 반환합니다. 이 구문을 사용하여 검색 제약 조건을 지정하고 특정 파라미터 값을 검색할 수 있습니다. 파라미터와 값 쌍 앞에 검색 제약 조건을 지정하십시오.

예제

Objects = find_system(System,Name,Value)는 지정된 시스템에서 지정된 조건을 충족하는 객체를 반환합니다.

예제

모두 축소

라이브 스크립트 열기

불러온 모든 시스템의 이름과 그 시스템의 블록의 이름을 반환합니다. 

load_system('vdp')
find_system
ans = 15x1 cell
    {'vdp'                     }
    {'vdp/Constant'            }
    {'vdp/More Info'           }
    {'vdp/More Info/Model Info'}
    {'vdp/Mu'                  }
    {'vdp/Mux'                 }
    {'vdp/Product'             }
    {'vdp/Scope'               }
    {'vdp/Square'              }
    {'vdp/Sum'                 }
    {'vdp/Sum1'                }
    {'vdp/x1'                  }
    {'vdp/x2'                  }
    {'vdp/Out1'                }
    {'vdp/Out2'                }

vdp를 포함하여 불러온 시스템과 라이브러리가 반환됩니다.

라이브 스크립트 열기

vdp 시스템과 그 시스템의 블록을 반환합니다.

load_system({'vdp','ex_sldemo_clutch'})
find_system('vdp')
ans = 15x1 cell
    {'vdp'                     }
    {'vdp/Constant'            }
    {'vdp/More Info'           }
    {'vdp/More Info/Model Info'}
    {'vdp/Mu'                  }
    {'vdp/Mux'                 }
    {'vdp/Product'             }
    {'vdp/Scope'               }
    {'vdp/Square'              }
    {'vdp/Sum'                 }
    {'vdp/Sum1'                }
    {'vdp/x1'                  }
    {'vdp/x2'                  }
    {'vdp/Out1'                }
    {'vdp/Out2'                }
라이브 스크립트 열기

불러온 모델, 서브시스템, 라이브러리의 이름을 반환합니다. 서브시스템 이름은 해당 서브시스템을 독립적으로 불러올 수 있는 경우에만 반환됩니다.

load_system('vdp');
find_system('type','block_diagram')
ans = 1x1 cell array
    {'vdp'}
라이브 스크립트 열기

ex_sldemo_clutch 시스템에서 잠기지 않은 서브시스템의 자식에 해당하는 모든 Goto 블록의 이름을 반환합니다. 

load_system('ex_sldemo_clutch');
find_system('ex_sldemo_clutch/Unlocked','SearchDepth',1,'BlockType','Goto')
ans = 2x1 cell
    {'ex_sldemo_clutch/Unlocked/Goto' }
    {'ex_sldemo_clutch/Unlocked/Goto1'}

Copyright 2020 The MathWorks, Inc.

라이브 스크립트 열기

vdp 시스템을 검색하여 이득 값이 1로 설정된 모든 Gain 블록의 이름을 반환합니다.

load_system('vdp');
find_system('vdp','BlockType','Gain','Gain','1')
ans = 1x1 cell array
    {'vdp/Mu'}
라이브 스크립트 열기

vdp 시스템에서 모든 선과 주석의 핸들을 가져옵니다. 'FindAll'과 함께 사용하면 이 함수는 시스템 검색이 어떻게 지정되었는지에 상관없이 핸들을 반환합니다. 

load_system('vdp');
L = find_system('vdp','FindAll','on','type','line')
L = 19×1

   34.0004
   33.0004
   32.0004
   31.0004
   30.0004
   29.0004
   28.0004
   27.0004
   26.0004
   25.0004
      ⋮


A = find_system('vdp','FindAll','on','type','annotation')
A = 2×1

   36.0004
   35.0004

vdp 및 ex_sldemo_clutch 시스템에서 값이 0인 블록 대화 상자 파라미터를 찾습니다.

load_system({'vdp','f14'})
find_system({'vdp','f14'},'BlockDialogParams','0')
ans =

  32×1 cell array

    {'vdp/More Info'                                              }
    {'vdp/More Info/Model Info'                                   }
    {'vdp/Scope'                                                  }
    {'vdp/x2'                                                     }
    {'vdp/Out1'                                                   }
    {'vdp/Out1'                                                   }
    {'vdp/Out2'                                                   }
    {'vdp/Out2'                                                   }
    {'f14/Aircraft↵Dynamics↵Model'                              }
    {'f14/Aircraft↵Dynamics↵Model/Vertical Velocity↵w (ft//sec)'}
    {'f14/Aircraft↵Dynamics↵Model/Vertical Velocity↵w (ft//sec)'}
    {'f14/Aircraft↵Dynamics↵Model/Pitch Rate↵q (rad//sec)'      }
    {'f14/Aircraft↵Dynamics↵Model/Pitch Rate↵q (rad//sec)'      }
				.
				.
				.
라이브 스크립트 열기

현재 불러온 시스템의 최상위에서 3으로 시작하는 블록 대화 상자 파라미터 값을 가진 블록을 모두 찾습니다. 

load_system({'ex_sldemo_clutch','vdp'});
find_system('SearchDepth','1','regexp','on','BlockDialogParams','^3')
ans = 4x1 cell
    {'vdp/Scope'         }
    {'vdp/Scope'         }
    {'vdp/Square'        }
    {'ex_sldemo_clutch/w'}
라이브 스크립트 열기

정규 표현식을 사용하여 검색할 경우 일치시킬 문자형 벡터의 일부를 지정하여 그 문자형 벡터가 포함된 모든 객체를 반환할 수 있습니다. ex_sldemo_clutch 모델에서 Inport 블록과 Outport 블록을 모두 찾습니다. 

load_system('ex_sldemo_clutch');
find_system('ex_sldemo_clutch','regexp','on','blocktype','port')
ans = 39x1 cell
    {'ex_sldemo_clutch/Friction...'                               }
    {'ex_sldemo_clutch/Friction...'                               }
    {'ex_sldemo_clutch/Friction...'                               }
    {'ex_sldemo_clutch/Friction Mode Logic/Tin'                   }
    {'ex_sldemo_clutch/Friction Mode Logic/Tfmaxs'                }
    {'ex_sldemo_clutch/Friction Mode Logic/Break Apart...'        }
    {'ex_sldemo_clutch/Friction Mode Logic/Break Apart...'        }
    {'ex_sldemo_clutch/Friction Mode Logic/Break Apart...'        }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup...'             }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup FSM/lock'       }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup FSM/unlock'     }
    {'ex_sldemo_clutch/Friction Mode Logic/Lockup FSM/locked'     }
    {'ex_sldemo_clutch/Friction Mode Logic/Requisite Friction/Tin'}
    {'ex_sldemo_clutch/Friction Mode Logic/Requisite Friction/Tf' }
    {'ex_sldemo_clutch/Friction Mode Logic/locked'                }
    {'ex_sldemo_clutch/Friction Mode Logic/lock'                  }
    {'ex_sldemo_clutch/Friction Mode Logic/unlock'                }
    {'ex_sldemo_clutch/Friction Mode Logic/Tf'                    }
    {'ex_sldemo_clutch/Locked/Tin'                                }
    {'ex_sldemo_clutch/Locked/w'                                  }
    {'ex_sldemo_clutch/Unlocked/Tfmaxk'                           }
    {'ex_sldemo_clutch/Unlocked/Tin'                              }
    {'ex_sldemo_clutch/Unlocked/we'                               }
      ⋮

이 예제에서 myModel에는 라이브러리 링크에 해당하는 단일 서브시스템이 포함되어 있습니다. 마지막으로 모델이 열린 이후 Gain 블록이 라이브러리의 해당 서브시스템에 추가되었습니다.

모델을 엽니다. 'FollowLinks'를 'off'로 설정한 상태로 find_system을 사용합니다. 이 명령은 라이브러리 링크를 따라 해당 서브시스템까지 들어가지 않고, 최상위 수준에 있는 서브시스템만 반환합니다.

open_system('myModel')
find_system(bdroot,'LookUnderMasks','on','FollowLinks', 'off')
ans = 

    'myModel'
    'myModel/Subsystem'

'FollowLinks'를 'on'으로 설정한 상태로 find_system을 사용합니다. find_system이 라이브러리 링크를 업데이트하고 해당 서브시스템의 블록을 반환합니다.

find_system(bdroot,'LookUnderMasks','on','FollowLinks','on')
Updating Link: myModel/Subsystem/Gain
Updating Link: myModel/Subsystem/Gain

ans = 

    'myModel'
    'myModel/Subsystem'
    'myModel/Subsystem/Gain'
라이브 스크립트 열기

시스템을 find_system에 핸들로 제공합니다. 값이 0인 블록 대화 상자 파라미터를 검색합니다. 동일한 블록에 get_param을 여러 번 호출하는 경우 블록 핸들을 사용하는 것이 문자형 벡터로 전체 블록 경로를 지정하는 것보다 더 효율적입니다.

load_system('vdp');
sys = get_param('vdp','Handle');
find_system(sys,'BlockDialogParams','0')
ans = 8×1

    3.0006
    4.0006
    8.0006
   13.0006
   14.0006
   14.0006
   15.0006
   15.0006

입력 인수

모두 축소

검색할 시스템으로, 전체 시스템 경로 이름, 시스템 경로 이름으로 구성된 셀형 배열, 핸들 또는 핸들로 구성된 벡터로 지정됩니다.

예: '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 쌍 인수에 검색 제약 조건과 파라미터 이름, 값 쌍을 포함할 수 있습니다. 검색 제약 조건은 어떠한 순서로도 지정할 수 있지만, 파라미터 이름과 값 쌍 앞에 와야 합니다.

블록 파라미터 목록은 Block-Specific Parameters 항목을 참조하십시오.

블록 대화 상자 파라미터에서 지정된 값을 검색하는 옵션으로, 'BlockDialogParams'와 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 이 쌍은 다른 검색 제약 조건 쌍 뒤에 와야 합니다.

일치할 경우 대/소문자를 고려하는 옵션으로, 'CaseSensitive'와 함께 'on'(대/소문자를 구분하여 검색) 또는 'off'가 쉼표로 구분되어 지정됩니다.

시스템 내의 선, 포트, 주석을 검색에 포함하는 옵션으로, 'FindAll'과 함께 'on' 또는 'off'가 쉼표로 구분되어 지정됩니다. 이 옵션이 'on'으로 설정되면 find_system은 System 인수가 어떻게 지정되었는가에 상관없이 핸들로 구성된 벡터를 반환합니다.

첫 번째 결과만 반환하고 검색을 중지하는 옵션으로, 'FirstResultOnly'와 함께 'on' 또는 'off'가 쉼표로 구분되어 지정됩니다.

모델 내의 참조된 서브시스템의 내부를 탐색하여 자식 블록을 나열하는 옵션으로, 'LookInsideSubsystemReference'와 함께 'on' 또는 'off'가 쉼표로 구분되어 지정됩니다.

링크를 따라 라이브러리 블록으로 가는 옵션으로, 'FollowLinks'와 함께 'on' 또는 'off'가 쉼표로 구분되어 지정됩니다. 검색할 시스템을 지정하지 않은 경우 find_system은 'FollowLinks'를 'on'으로 설정했든 'off'로 설정했든지에 상관없이 불러온 라이브러리를 검색 결과에 포함합니다. 'FollowLinks'를 'LookUnderMasks'와 함께 사용하여 서브시스템 내의 라이브러리 링크를 업데이트할 수 있습니다. 서브시스템에서 라이브러리 링크 업데이트하기 항목을 참조하십시오.

주석 처리된 블록을 검색에 포함하는 옵션으로, 'IncludeCommented'와 함께 'on' 또는 'off'가 쉼표로 구분되어 지정됩니다.

부분적으로 불러온 모델을 불러오는 옵션으로, 'LoadFullyIfNeeded'와 함께 'on'(모델을 불러옴) 또는 'off'(불러오기를 비활성화함)가 쉼표로 구분되어 지정됩니다. 예를 들어, 불러오기 경고를 방지하려면 이 옵션을 사용합니다.

마스크 내부를 검색하는 옵션으로, 'LookUnderMasks'와 함께 다음 옵션 중 하나가 쉼표로 구분되어 지정됩니다.

  • 'graphical' — 작업 공간과 대화 상자를 갖지 않는 마스크 처리된 서브시스템을 검색에 포함합니다.

  • 'none' — 마스크 처리된 서브시스템을 검색에서 건너뜁니다.

  • 'functional' — 대화 상자를 갖지 않는 마스크 처리된 서브시스템을 검색에 포함합니다.

  • 'all' — 마스크 처리된 서브시스템을 모두 검색에 포함합니다.

  • 'on' — 마스크 처리된 서브시스템을 모두 검색에 포함합니다.

  • 'off' — 마스크 처리된 서브시스템을 검색에서 건너뜁니다.

검색 표현식을 정규 표현식으로 처리하는 옵션으로, 'RegExp'와 함께 'on'(검색 표현식을 정규 표현식으로 처리함) 또는 'off'가 쉼표로 구분되어 지정됩니다. MATLAB® 정규 표현식에 대한 자세한 내용은 정규 표현식 항목을 참조하십시오.

검색 심도를 지정된 수준으로 제한하는 옵션으로, 'SearchDepth'와 함께 양의 정수 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 예를 들어, 불러온 시스템만 검색하려면 '0'을, 최상위 시스템의 블록과 서브시스템까지 검색하려면 '1'을, 최상위 시스템과 그 자식까지 검색하려면 '2'를 지정하는 식으로 합니다. 디폴트는 모든 수준을 검색하는 것입니다.

참고

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를 사용하십시오.

이 인수를 통해 다음이 가능합니다.

  • 사용자 지정 필터 함수로 요소를 필터링할 수 있습니다.

  • 필터가 일치하지 않을 때 요소가 처리되는 것을 방지할 수 있습니다.

  • 내부적으로 결과를 필터링하도록 블록, 선 또는 주석에 복합 필터를 적용할 수 있습니다.

명명된 함수는 MATLAB 프로그램 파일 내에서 정의해야 합니다. 이 함수는 요소의 핸들을 입력으로 받아 두 개의 출력을 반환합니다.

 function [match, prune] = func(element)

  • 입력 element는 처리 중인 블록의 핸들입니다.

  • 첫 번째 출력 match는 논리값입니다. false인 경우 요소를 검색에서 건너뜁니다.

  • 두 번째 출력 prune은 선택적 논리값으로, element가 서브시스템인 경우에만 적용됩니다. 디폴트 값은 false입니다. 이 값이 true로 설정된 경우 검색에서 전체 서브시스템이 제외됩니다.

예: 사용자가 직접 정의한 필터 함수 nonInOutBlocks에서 MatchFilter를 사용하여 모델에서 Inport가 아니거나 Outport가 아닌 모든 블록 찾기.

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

load_system('vdp');
blks = find_system('vdp', 'MatchFilter', @nonInOutBlocks)

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 항목을 참조하십시오.

예: Simulink.match.activeVariants 필터를 사용하여 모델에서 활성 Variant 찾기.

openExample('simulink_variants/BuiltInMatchFiltersWithfindsystemForVariantBlocksExample');
model='sldemo_variant_subsystems';
load_system(model);
assignin('base','VSS_MODE',2);
set_param(model, 'SimulationCommand', 'update');
activeBlks = find_system(model, 'MatchFilter', @Simulink.match.activeVariants);

예: Simulink.match.codeCompileVariants 필터를 사용하여 C 생성 코드의 일부가 되는 Variant 선택지 찾기.

openExample('simulink_variants/BuiltInMatchFiltersWithfindsystemForVariantBlocksExample');
load_system('sldemo_variant_subsystems');
assignin('base','VSS_MODE',2);
sldemo_variant_subsystems([], [], [], 'compileForCodegen');
activeBlks= find_system('sldemo_variant_subsystems', 'MatchFilter', @Simulink.match.codeCompileVariants);
sldemo_variant_subsystems([], [], [], 'term');

예: Simulink.match.allVariants() 필터를 사용하여 모델에서 모든 블록 찾기.

 find_system('sldemo_variant_subsystems', 'MatchFilter', @Simulink.match.allVariants);

예: Simulink.match.variantAssemblySubsystems() 필터를 사용하여 모델에서 모든 Variant Assembly Subsystem 블록 찾기.

openExample('simulink_variants/ChoicesMaskVariantAssemblySubsystemMaskParamObjectExample');
load_system('slexVariantAssemblySubsystemWithMask')
find_system('slexVariantAssemblySubsystemWithMask', 'MatchFilter', @Simulink.match.variantAssemblySubsystems)

출력 인수

모두 축소

검색 결과 일치하는 객체로, 다음으로 반환됩니다.

  • 경로 이름으로 구성된 셀형 배열(System을 경로 이름 또는 경로 이름으로 구성된 셀형 배열로 지정했거나, 시스템을 지정하지 않은 경우)

  • 핸들로 구성된 벡터(System을 핸들 또는 핸들로 구성된 벡터로 지정한 경우)

버전 내역

R2006a 이전에 개발됨

모두 확장

참고 항목

| | | | | | | |

도움말 항목