CutSet

R2026b

Set of events causing failure represented at gate

Since R2026b

expand all in page

Description

CutSet objects represent cutsets in Safety Analysis Manager fault tree documents. Each cutset is the combination of gates and events that contribute to a failure at a gate.

Creation

To create CutSet objects, use the evaluate function on a FaultTreeDocument object. Then get the CutSets property of a Gate object in the fault tree document.

Properties

expand all

This property is read-only.

Elements that contribute to the cutset at the gate, represented as a heterogeneous array of Event and Gate objects.

This property is read-only.

Whether the associated element must be active for the cutset at the gate to occur, represented as a 1 or 0 value of data type logical, or an array of logical values. If the cutset includes only one element, then States is a scalar. Otherwise, States is an array.

Data Types: logical

This property is read-only.

Probability that the cutset occurs at the gate, represented as a positive double between 0 and 1.

Data Types: double

This property is read-only.

Frequency of the cutset at the gate, represented as a double.

Data Types: double

Examples

collapse all

Create a cutset by evaluating a fault tree document that contains at least one fault tree. Create a fault tree document that contains seven basic events and three gates below the top-level gate. Specify the probability of failure and event frequency for each event.

myTreeDoc = safetyAnalysisMgr.newDocument("fault-tree");
myFaultTree = myTreeDoc.FaultTrees(1);

myTopGate = myFaultTree.Gates(1);
event1 = createEvent(myTopGate);
event1.FailureModel.Parameters.Q.Value = 0.05;
event1.FailureModel.Parameters.W.Value = 0.05;
event2 = createEvent(myTopGate);
event2.FailureModel.Parameters.Q.Value = 0.1;
event2.FailureModel.Parameters.W.Value = 0.05;
gate1 = createGate(myTopGate);
gate2 = createGate(myTopGate,Type="and");
gate22 = createGate(gate2);

event3 = createEvent(gate1);
event3.FailureModel.Parameters.Q.Value = 0.1;
event3.FailureModel.Parameters.W.Value = 0.1;
event4 = createEvent(gate1);
event4.FailureModel.Parameters.Q.Value = 0.02;
event4.FailureModel.Parameters.W.Value = 0.01;
event5 = createEvent(gate2);
event5.FailureModel.Parameters.Q.Value = 0.2;
event5.FailureModel.Parameters.W.Value = 0.01;
event6 = createEvent(gate22);
event6.FailureModel.Parameters.Q.Value = 0.2;
event6.FailureModel.Parameters.W.Value = 0.2;
event7 = createEvent(gate22);
event7.FailureModel.Parameters.Q.Value = 0.15;
event7.FailureModel.Parameters.W.Value = 0.15;

To generate the cutsets, evaluate the fault tree document.

evaluate(myTreeDoc)

To retrieve the cutsets that activate the top-level gate, get the array of CutSet objects from the CutSets property of the top-level gate.

myCutSets = myTopGate.CutSets

myCutSets = 

  1×6 CutSet array with properties:

    Elements
    States
    Q
    W

Version History

Introduced in R2026b

See Also

Apps

Objects

Functions