FailureModelParameters

R2026b

Event failure model parameters

Since R2026b

expand all in page

Description

FailureModelParameters objects represent the parameters of a failure model in Safety Analysis Manager fault tree document events. Use FailureModelParameters objects to specify how the failure model calculates the unavailability and failure frequency at the event.

Creation

To create a FailureModelParameters object, get the Parameters property of a FailureModel object.

Properties

expand all

This property is read-only.

Unavailability of the event, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "constant".

This property is read-only.

Event frequency, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "constant".

This property is read-only.

Failure rate associated with the event, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "rate", "time-at-risk", or "dormant".

This property is read-only.

Repair rate associated with the event, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "rate".

Event exposure time, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "time-at-risk".

This property is read-only.

Mean time to failure of the event, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "mttf".

This property is read-only.

Mean time to repair of the event, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "mttf" or "dormant".

This property is read-only.

Inspection interval of the artifact that contains the event, represented as a Parameter object.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "dormant".

Whether the event is active, specified as a numeric or logical 0 (false) or 1 (true), a string scalar, or character vector.

Use a string scalar or character vector to define the status based on the value of a MATLAB® expression. Use variables defined in the base workspace. If you define an expression, the expression must evaluate to a scalar value of data type logical.

Example: myParams.Active = 1 activates the event.

Example: myParams.Active = "x > 3" activates the event if the base workspace variable x is greater than 3.

Dependencies

To use this property, set the Type property of the containing FailureModel object to "logical".

Data Types: logical | char | string

Examples

collapse all

Create a fault tree document in the Safety Analysis Manager and retrieve the FaultTree object.

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

Add two basic events to the tree.

myTopGate = myFaultTree.Gates(1);
event1 = createEvent(myTopGate);
event2 = createEvent(myTopGate);

Retrieve the failure model from event1.

myFailureModel = event1.FailureModel;

Retrieve the failure model parameters.

myFailureParameters = myFailureModel.Parameters;

Version History

Introduced in R2026b

See Also

Apps

Objects