EvalConfig

R2026b

Evaluation configuration for fault tree document

Since R2026b

expand all in page

Description

EvalConfig objects represent the evaluation configuration of Safety Analysis Manager fault tree documents. Use EvalConfig objects to set the document properties to evaluate in a fault tree document.

Creation

To create an EvalConfig object, get the EvalConfig property of a FaultTreeDocument object.

Properties

expand all

Evaluation algorithm to use to evaluate the tree, specified as "exact" or "rare". If this property is "exact", the evaluation calculates the unavailability and failure frequency values in the document without using an approximation. If this property is "rare", the evaluation calculates the unavailability and failure frequencies in the document by using the rare-event approximation. For more information on the rare-event approximation, see [1].

Data Types: enumeration

Mission time of the evaluation, specified as a positive numeric scalar.

Dependencies

To use this property, set the QualitativeOnly property to false.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Unit of time that evaluation uses, specified as "minutes", "hours", "million-hours", or "billion-hours".

Dependencies

To use this property, set the QualitativeOnly property to false.

Data Types: enumeration

Cutset order cutoff, specified as a positive integer.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Cutset probability cutoff, specified as a positive numeric scalar.

The evaluation uses this property only if the Type property is "rare".

Dependencies

To use this property, set the QualitativeOnly property to false.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Whether the evaluation omits the cutset metrics Q and W for each cutset, specified as a numeric or logical 1 (true) or 0 (false).

Data Types: logical

Fault trees in the evaluation of the fault tree document, specified as an array of FaultTree objects. By default, this property includes all of the fault trees in the fault tree document.

Examples

collapse all

To create a new fault tree, create a fault tree document.

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

Get the evaluation configuration by retrieving the EvalConfig object from the fault tree document.

myEvalConfig = myTreeDoc.EvalConfig;

Set the algorithm type to "rare" and the mission time to 100.

myEvalConfig.Type = "rare";
myEvalConfig.MissionTime = 100;

References

[1] Vesely, W.E., F.F. Goldberg, N.H. Roberts, and D.F. Haasl. Fault Tree Handbook. U.S. Nuclear Regulatory Commission, 1981.

Version History

Introduced in R2026b

See Also

Apps

Objects

Functions

Topics