|Prev - Next - Down||SDMetrics - the UML design measurement tool|
<matrix name="matrixname" from_row_type="rowtype" to_col_type="columtype" row_condition="..." col_condition="..." > <description>Description of the matrix.</description> <'matrix definition' ...> </matrix>The attributes in the opening "matrix" tag are:
The matrix definition is an XML element that defines the calculation procedure establishing the relationship from source elements to target elements in the matrix. The available procedures are the same ones that are available for set definitions (see Section 8.2 "Definition of Sets").
The definition below calculates a relation matrix showing UML abstractions for classes, i.e., which classes implement which interfaces:
<matrix name="UMLAbstr" from_row_type="class" to_col_type="interface"> <description>UML abstractions: implementation of interfaces.</description> <projection relation="client" target="abstraction" element="supplier" /> </matrix>The evaluation procedure for this matrix definition is as follows. For a source element in a given matrix row, the projection is evaluated, as described in Section 8.2.1 "Projection". The number of occurrences of each target element in that projection is counted, and entered in the respective column of the relation matrix. This procedure is repeated for all rows of the matrix. Thus, we obtain in every table cell, a count of the number of relationship links from the source element to the target element.
In the context of a relation matrix definition, the set projection attribute recurse is not allowed.
As another example, assume we have defined, for a class, the set "AssEl_out" of elements associated with the class by bidirectional or navigable outgoing associations. We can then simply create a relation matrix showing these associations as follows:
<matrix name="ICAssoc_Cls" from_row_type="class" to_col_type="class"> <description>Import coupling via associations between classes.</description> <projection relset="AssEl_out" /> </matrix>The evaluation procedure for this matrix definition is straightforward. For a source element in a given matrix row, the specified set expression "relset" is evaluated, as described in Section 8.2.1 "Projection". For each target element, the value of the respective column of the relation matrix is the cardinality of the target element in the set. This procedure is repeated for all rows of the matrix.
Continuing the association matrix example from above, we may want to reduce the size of the matrix by dropping empty rows (classes without outgoing associations), and empty columns (classes without incoming associations). Assume we have defined two helper metrics "Num_AssEl_out" and "Num_AssEl_in", to count for a class the number of outgoing and incoming associations, respectively. We add row and column conditions to the matrix definition as follows:
<matrix name="ICAssoc_Cls" from_row_type="class" to_col_type="class" row_condition="Num_AssEl_out>0" col_condition="Num_AssEl_in>0"> <description>Import coupling via associations between classes.</description> <projection relset="AssEl_out" /> </matrix>Then, only classes with one ore more outgoing associations (Num_AssEl_out>0) will be included in the rows of the matrix, which eliminates empty rows. Likewise, the column condition Num_AssEl_in>0 eliminates empty columns.
|Section 8.3.6 "Exempting Approved Rule Violations"||Contents||Section 8.5 "Expression Terms"|