ChangeInformation

R2026b

Detected changes in Safety Analysis Manager

Since R2024b

Description

ChangeInformation objects represent detected changes in Safety Analysis Manager spreadsheets. Use ChangeInformation objects to get information on the affected element in your spreadsheet and the changed artifact associated with the affected element. You must have Requirements Toolbox™ to use ChangeInformation objects.

Creation

To create a ChangeInformation object:

• Use the getChanges function on a Safety Analysis Manager spreadsheet, spreadsheet row, or spreadsheet cell.

• Use the getChanges function on a Safety Analysis Manager fault tree document, event, gate, or failure model. (since R2026b)

Properties

AffectedElement — Affected element

Read-only: SpreadsheetRow object | SpreadsheetCell object | Event | FailureModel

This property is read-only.

Affected element in the Safety Analysis Manager document, represented as a SpreadsheetRow, SpreadsheetCell object.

Type — Type of change

Read-only: 'linkCreated' | 'linkChanged' | 'linkedArtifactChanged' | 'linkOrLinkedArtifactRemoved'

This property is read-only.

Type of change from the baseline, represented as one of these options:

Type Value	Description
'linkCreated'	The affected element in the Safety Analysis Manager document has a new link.
'linkChanged'	The affected element in the Safety Analysis Manager document has a changed link.
'linkedArtifactChanged'	The artifact that the affected element in the Safety Analysis Manager document links to has changed.
'linkOrLinkedArtifactRemoved'	The affected element in the Safety Analysis Manager document has a deleted link, or the link links to a deleted artifact.

Data Types: char

Relation — Relation between affected element and changed artifact

Read-only: [] | slreq.Link object

This property is read-only.

Relation between the affected element and the changed artifact, represented as either an empty array or a slreq.Link object. The property is [] when the ChangedArtifact property is a slreq.Link object.

ChangedArtifact — Changed artifact

Read-only: slreq.Link object | structure | ...

This property is read-only.

Changed artifact, represented as one of these options:

Relation Value	ChangedArtifact Value
[]	slreq.Link object
slreq.Link object	If the changed artifact is the link destination, the value of ChangedArtifact is a link destination structure that contains these fields: domain artifact id summary reqSet sid If the changed artifact is the link source, the value of ChangedArtifact is a link source structure that contains these fields: domain artifact id

For more information on link sources and destinations, see Create and Store Links (Requirements Toolbox). To retrieve the changed artifact as an object, use the slreq.structToObj (Requirements Toolbox) function on the value of this property.

Object Functions

accept	Accept detected change in Safety Analysis Manager document
navigate	Navigate to elements in Safety Analysis Manager documents and changed artifacts

Examples

Get Detected Changes in Spreadsheet

This example shows how to get detected changes in Safety Analysis Manager spreadsheets. You make a change to the fault linked to two cells in the spreadsheet, then detect and return the change information in the linked cells. The model represents a fuel control system for a gasoline engine, and is a modified version of the model in Evaluate Fault Combinations on a Fault-Tolerant Fuel System.

Open the project.

openProject("EvaluateFaultsFuelSystemProject/");

Next, open the sldemo_fuelsys_fault_analyzer model and the FuelSysFMEA.mldatx spreadsheet. Create the faults and the links between the faults and the spreadsheet by using the fuelSysFaultSetupProject function.

mdl = "sldemo_fuelsys_fault_analyzer";
open_system(mdl);
FMEAName = safetyAnalysisMgr.openDocument("FuelSysFMEA.mldatx");
fuelSysFaultSetupProject

Get the fault on the third input port of the To Controller subsystem by using the Simulink.fault.findFaults function.

myFault = Simulink.fault.findFaults(...
mdl,ModelElement=mdl + "/To Controller/Inport/3");

Set the trigger time of the fault to 10 by changing the Fault object property values. Save the fault information by using the Simulink.fault.save function.

myFault.StartTime = 10;
Simulink.fault.save(mdl)

Detect the changes to the linked fault in the FuelSysFMEA.mldatx spreadsheet by using the detectChanges function.

detectChanges(FMEAName)

Each artifact that links to the fault detects the change. Get the detected changes from each linked artifact as an array of ChangeInformation objects.

myChanges = getChanges(FMEAName);

You can access the object of the linked spreadsheet artifact, or the linked changed artifact. In this example, the fault is linked to two artifacts. To retrieve the Fault object from a ChangeInformation object, get the structure for one of the changes by retrieving the ChangedArtifact property of the ChangeInformation object.

myStruct = myChanges(1).ChangedArtifact;

Then use the slreq.structToObj function on the structure.

myFault = slreq.structToObj(myStruct);

Version History

Introduced in R2024b

R2026b: Detect changes in fault tree document artifacts

Use the ChangeInformation object to detect changes in FaultTreeDocument, Event, Gate, and FailureModel objects.