Customization > Extensibility Through Profiles, Stereotypes, Tag Definitions and Scripts > PTC profiles > MBRE profile > MBRE traceability matrix > MBRE Traceability matrix (MBRE profile)
  
MBRE Traceability matrix (MBRE profile)
An MBRE Traceability Matrix presents MBRE traceability information in a matrix format, that is, how models items are linked through Constrain, Fulfill or Validate relationships.
Create an MBRE Traceability Matrix from the Model or a Package: right-click the Model or Package, point to New, point to MBRE, and then click MBRE Traceability Matrix.
On creating an MBRE Traceability Matrix, you select its type. The type determines which relationships are shown on the MBRE Traceability Matrix, that is, Constrain, Fulfill or Validate relationships. After creating an MBRE Traceability Matrix, you can change the type of relationships it shows - in Modeler, right-click the MBRE Traceability Matrix, point to Set, and then click Matrix Type.
When you open a Traceability Matrix, Modeler creates a matrix that can be generated as HTML for viewing in your Internet browser, or generated as a Microsoft Excel spreadsheet for viewing in Microsoft Excel. To specify how Traceability Matrices are opened for a model: in the Packages pane, right-click the Model, point to Tools > Options, click Matrix/Table Generation Format, and then select HyperTextMarkupLanguage_HTML or Excel_XLS.
When you open a Traceability Matrix, Modeler populates that matrix with data from the model. A row is created for each valid Use Case that is scoped to an Analyzed Package. A column is created for each valid item that is scoped to an Analyzed Package. Rows and columns are created for linked items in other Packages as required. A cell containing an X indicates that the two associated items are linked using a Constrain, Fulfill or Validate relationship as appropriate. Each time you open the Traceability Matrix, Modeler creates the matrix using the latest data from the model.
You can customize the content and presentation of a MBRE Traceability Matrix:
You can specify the Packages that are searched for items.
By default, a new MBRE Traceability Matrix searches for valid items in the Package that owns the MBRE Traceability Matrix. To specify which Packages are searched for valid items: right-click the MBRE Traceability Matrix, point to Links, and then click Analyzed Packages. Select the Packages you want to search, or Unlink All Packages to search all Packages in the model for valid items.
You can change the relationship type that is shown in the MBRE Traceability Matrix:
To change the relationship type: right-click the MBRE Traceability Matrix, point to Set, and then click Matrix Type.
You can choose whether to show the scope of row and column items.
On the Traceability Matrix tab of the MBRE Traceability Matrix's Property Pages, set the tagged value of the rowItemsShowScope tag definition to TRUE to show row item scoping, or FALSE to show only the row item names. Set the tagged value of the columnItemsShowScope tag definition to TRUE to show column item scoping, or FALSE to show only the column item names.
You can change the row and column labels.
On the TraceabilityMatrix tab of the MBRE Traceability Matrix's Property Pages, set the tagged value of the rowLabel tag definition to the row items label you want, and set the tagged value of the columnLabel tag definition to the column items label you want.
The MBRE Traceability Matrix is based on the Custom Matrix. For additional information about how Custom Matrices can be customized, including changing which items are included in the matrix, see Overview of Custom Matrices.
An MBRE Traceability Matrix is a UML Text Diagram that is stereotyped by the MBRETraceabilityMatrix stereotype from the MBRE profile, but you cannot view the Text Diagram in Modeler.
An MBRE Traceability Matrix is an editable matrix. For more information on editable matrices, see Editing Matrices.
The following sections provide information about how an MBRE Traceability Matrix is used in the model.
Owned by
Model (UML item)
Package (UML item)
Creates or shows these items
Any model item or diagram can appear on an MBRE Traceability Matrix.
MBRE Properties
The MBRE Traceability Matrix is based on the Custom Matrix. For information about how the following SysML Properties can be used to customize an MBRE Traceability Matrix, click here.
analyzedPackages—shows the Packages that are searched for valid items. To specify the Packages that are searched: right-click the MBRE Traceability Matrix, point to Links, and then click Analyzed Packages. To search all Packages in the model, click the Unlink All button.
cellDisplayProperty—specifies the property of the relationship to display in intersection cells. When blank, the default value, an X is displayed in intersection cells.
columnItemsRole—specifies the role to use for finding items from the columnItemsStartPoint.
columnItemsShowScope—specifies whether the scoping of column items is shown after the item name. Set to TRUE to show item scoping, or FALSE to show only item names.
columnItemsStartPoint—specifies the start point for finding column items.
columnLabel—specifies the label for the column items.
columnToRowIntersectionRole—specifies the role to use for column item to row item intersections.
matrixType—shows the relationship type being used for the MBRE Traceability Matrix. To change the relationship type: right-click the MBRE Traceability Matrix, point to Set, and then click Matrix Type.
rowItemsRole—specifies the role to use for finding items from the rowItemsStartPoint.
rowItemsShowScope—specifies whether the scoping of row items is shown after the item name. Set to TRUE to show item scoping, or FALSE to show only item names.
rowItemsStartPoint—specifies the start point for finding row items.
rowLabel—specifies the label for the row items.
rowToColumnIntersectionRole—specifies the role to use for row item to column item intersections.