이 페이지는 기계 번역을 사용하여 번역되었습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

Fault

모델에서 결함 생성 또는 수정

R2023b 이후

설명

Fault 객체는 모델 요소의 출력에서 잡음과 같은 결함을 나타냅니다. Fault 객체를 사용하여 모델에 결함 주입을 수행합니다. 객체 속성을 설정하여 결함을 수정할 수 있습니다.

생성

Fault 객체를 생성하려면:

• Simulink.fault.addFault 함수를 사용합니다.

• 모델에서 대화형으로 결함을 생성한 다음, Simulink.fault.findFaults 함수를 사용하여 연결된 Fault 객체를 가져옵니다.

속성

Name — 결함의 이름

string형 스칼라 | 문자형 벡터

결함의 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

데이터형: char | string

Description — 결함 설명

'' (디폴트 값) | string형 스칼라 | 문자형 벡터

결함에 대한 설명으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

데이터형: char | string

ModelElement — 모델 요소의 경로

문자형 벡터

이 속성은 객체 생성 후 읽기 전용입니다. 이 속성을 지정하려면 Simulink.fault.addFault 함수를 사용할 때 modelElement 인수를 정의하십시오.

모델 요소의 경로 또는 핸들로, 문자형 벡터로 표현됩니다. Simulink^® 모델에서 이 인수는 블록 출력 또는 입력 포트의 경로입니다. Simscape™ 블록에서 이 인수는 결함 가능 모델 하위 요소에 대한 경로입니다. System Composer™ 모델에서 이 인수는 컴포넌트의 출력 또는 입력 포트의 경로입니다.

예: 'myModel/Sine Wave/Outport/1'

데이터형: char

Type — 모델 요소 유형

읽기 전용: 'Simulink' | 'Simscape' | 'System Composer'

읽기 전용 속성입니다.

결함이 포함된 모델 요소 유형으로, 'Simulink', 'Simscape' 또는 'System Composer'로 표현됩니다.

데이터형: enumeration

IsActive — 결함이 활성화되어 있는지 여부

읽기 전용: 1 | 0

읽기 전용 속성입니다.

결함이 활성 상태인지 여부로, 1(true) 또는 0(false)으로 표현됩니다. 이 속성은 결함이 활성화되어 있고, 모델 요소가 활성화되어 있으며, 결함 시뮬레이션이 켜져 있는 경우에만 1을 반환합니다. 각 모델 요소에 대해 활성 결함을 하나만 지정할 수 있습니다.

데이터형: logical

IsTriggered — 결함이 주입되었는지 여부

읽기 전용: 1 | 0

읽기 전용 속성입니다.

결함이 주입되었는지 여부로, 1(true) 또는 0(false)으로 표현됩니다. 현재 시간 스텝에서 결함이 주입된 경우 이 속성은 1을 반환합니다. 그렇지 않으면, 0을 반환합니다.

데이터형: logical

HasBehavior — 결함이 동작을 가지고 있는지 여부

읽기 전용: 1 | 0

읽기 전용 속성입니다.

결함에 할당된 동작이 있는지 여부로, 1(true) 또는 0(false)으로 표현됩니다.

결함에 동작을 추가하려면 addBehavior 함수를 사용하십시오. 동작을 삭제하려면 deleteBehavior 함수를 사용하십시오.

데이터형: logical

TriggerType — 결함 트리거 유형

"Always On" | "Timed" | "Conditional" | "Manual" | "Behavioral"

결함 트리거 유형으로, "Always On", "Timed", "Conditional", "Manual" (R2024a 이후) 또는 "Behavioral"로 지정됩니다. TriggerType을 "Conditional"로 지정하는 경우 Simulink.fault.addConditional 함수를 사용하여 조건을 만든 다음 Fault 객체의 Conditional 속성을 새 Conditional 객체로 설정합니다.

결함에 동작이 할당된 경우에만 이 속성을 조정할 수 있습니다. 동작을 추가하려면 addBehavior 함수를 사용합니다. Simscape 블록의 결함에 대해서만 이 속성을 "Behavioral"로 설정할 수 있습니다.

데이터형: enumeration

Persistent — 결함 트리거를 되돌릴 수 있는지 여부

false 또는 0 | true 또는 1

결함 트리거를 되돌릴 수 있는지 여부로, 숫자형 또는 논리형 0 (false) 또는 1 (true)로 지정됩니다. 이 속성이 true인 경우 조건이 먼저 충족될 때 결함이 주입된 다음 시뮬레이션이 끝날 때까지 계속해서 주입됩니다. 이 속성이 false인 경우 조건식이 충족될 때만 결함이 주입됩니다.

결함에 동작이 할당되고 TriggerType 속성이 "Conditional"로 설정된 경우에만 이 속성을 조정할 수 있습니다. 동작을 추가하려면 addBehavior 함수를 사용합니다. 조건을 만들려면 Simulink.fault.addConditional 함수를 사용합니다. 점 표기법을 사용하여 Conditional 객체를 Fault 객체에 할당합니다.

데이터형: logical

StartTime — 결함이 트리거되는 시점

숫자형 스칼라

시뮬레이션 중에 결함이 트리거되는 시점으로, 숫자형 스칼라로 지정됩니다.

결함에 동작이 할당되었고 TriggerType 속성이 "Timed"인 경우에만 이 속성을 조정할 수 있습니다. 동작을 추가하려면 addBehavior 함수를 사용합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Conditional — 결함에 할당된 조건

Conditional 객체

결함에 할당된 조건으로, Conditional 객체로 지정됩니다.

결함에 동작이 할당되었고 TriggerType 속성이 "Conditional"인 경우에만 이 속성을 조정할 수 있습니다. 동작을 추가하려면 addBehavior 함수를 사용합니다. 조건을 만들려면 Simulink.fault.addConditional 함수를 사용합니다. 이 속성에 Conditional 객체를 할당하십시오.

TriggerActive — 수동 트리거 상태

false 또는 0 | true 또는 1 | []

R2024a 이후

수동 트리거의 상태로, 숫자형 또는 논리형 0(false) 또는 1(true)로 지정됩니다. 결함에 동작이 할당되었고 TriggerType 속성이 "Manual"인 경우에만 이 속성을 조정할 수 있습니다. 그렇지 않으면 속성은 빈 값을 반환합니다. 동작을 추가하려면 addBehavior 함수를 사용합니다. 상태가 0인 경우 수동 트리거가 꺼집니다. 상태가 1이면 수동 트리거가 켜져 있습니다.

데이터형: logical

객체 함수

activate	Set fault as active fault
addBehavior	결함에 신호 동작 추가
deleteBehavior	결함에 연결된 동작 삭제
getAssociatedModel	Retrieve name of model fault
getBehavior	Get path of associated Fault Subsystem block
getFaultInfoFile	Get name of fault information file
getFaultModel	결함 모델의 이름 가져오기
openBehavior	결함 동작 및 결함 모델 열기

예제

모델에 결함 추가

fault_analyzer_intro 모델을 엽니다.

openExample("faultanalyzer/FaultAnalyzerIntroExample")

Sine Wave 블록의 출력 포트에 결함을 추가합니다.

fault = Simulink.fault.addFault(...
"fault_analyzer_intro/Sine Wave/Outport/1");

동작에 결함 추가

fault_analyzer_intro 모델을 엽니다.

openExample("faultanalyzer/FaultAnalyzerIntroExample")

Sine Wave 블록의 출력 포트에 결함을 추가합니다.

myFault = Simulink.fault.addFault(...
"fault_analyzer_intro/Sine Wave/Outport/1");

결함에 잡음 동작을 할당하고 경로에 있는 myBehaviorModel이라는 결함 모델에 동작을 저장합니다.

addBehavior(myFault,"myBehaviorModel",...
FaultBehavior="mwfaultlib/Add Noise");

동작 없는 결함 찾기

결함 허용 연료 시스템의 결함 조합 평가 예제에서 sldemo_fuelsys_fault_analyzer 모델을 열고 결함을 설정합니다.

openExample("faultanalyzer/EvaluateFaultsForFuelSystemExample")
model = "sldemo_fuelsys_fault_analyzer";
open_system(model)
fuelSysFaultSetup

동작이 없는 두 개의 결함을 서브시스템의 첫 번째 입력 포트 To Controller에 추가합니다.

Simulink.fault.addFault(...
model + "/To Controller/Inport/1",Name="myFault1");
Simulink.fault.addFault(...
model + "/To Controller/Inport/1",Name="myFault2");

동작이 없는 결함을 찾습니다.

myFaults = Simulink.fault.findFaults(...
"fault_analyzer_intro",HasBehavior=false);

버전 내역

R2023b에 개발됨

R2024a: 수동 트리거 지원

시뮬레이션 중에 결함이 주입되는 시점을 수동으로 제어하려면 수동 트리거를 할당하십시오. 모델에서 수동으로 결함 트리거 항목을 참조하십시오.

참고 항목

Conditional

도움말 항목

• 결함 속성 지정
• 프로그래밍 방식으로 결함 추가 및 구성