Comparing Models

This section describes the model Compare functionality available in Kiuwan's Models Management.

Introduction

The compare functionality in Kiuwan's Model Management helps you to find changes between different version of a model (in different versions) or different models. These changes can be found in the model indicators or rules configuration.
By default, the loaded model will be compared with its previous version if it is available, but you can choose any previous version available or any version of the models available to your account.
The compare functionality is available in the following sections:

Summary
Indicators
Rules

Enabling the compare mode

To enter the compare mode, click on the "Compare" link under toolbar in any of the previous sections.

Compare sections

All the compare sections contain a model chooser, where you can select which model you want to compare the loaded model with:

The model chooser has two sides:

The left part shows the currently loaded model and its version, as selected in the top right versions drop down menu. You can change this version with the version selector. This model-version will be represented by the pink color.
The right part, initially, shows the same model in its previous version if it is possible. This part lets you to choose the model and version you want to compare with, using the "Name" and "Version" drop-down menus. This model-version will be represented by the turquoise color. Note: when you compare a model with itself, you can only select previous versions of the currently selected.

Compare in Summary section

The Summary Compare shows the differences in the summary section between the compared models. It contains the following parts:

Changes in the relative weights of languages and characteristics indicators.
Changes in rules. Total number of rules. Language, characterics and priorities distributions.
Changes in metrics. Total number of metrics and categories distribution.

Indicators

This part shows two comparison charts:

By language: compared weights distribution by language. All languages are represented by a column chart showing the differences between the two models.

By characteristic: compared weights distribution by characteristic. All characteristics are represented by a column chart showing the differences between the two models.

Move the mouse over the charts to view the details of the chart node.

Rules

Shows a description of the number of rules and three comparison charts:

Number of rules: compared number of rules in relation to the selected model, that is, indicates whether the selected model has more/less/equal number of rules than the model to compare with.

By language: compared number of rules distribution by language. All languages are represented by a column chart showing the differences between the two models.

By characteristic: compared number of rules distribution by characteristic. All characteristics are represented by a column chart showing the differences between the two models.

By priority: compared number of rules distribution by priority. All priorities are represented by a column chart showing the differences between the two models.

Move the mouse over the charts to view the details of the chart node.

Metrics

Shows a description of the number of metrics and a comparison chart:

Number of metrics: compared number of metrics in relation to the selected model, that is, indicates whether the selected model has more/less/equal number of metrics than the model to compare with.

By metric category: compared number of metrics distribution by metric category. All categories are represented by a column chart showing the differences between the two models.

Move the mouse over the charts to view the details of the chart node.

Compare in Indicators section

The Indicators Compare shows the differences in indicators between the compared models. It contains the following parts:

Changes in the value of the Global Indicator.
Changes in the Characteristics. Differences in the characteristics weights values.
Changes in the Technologies. Differences in the languages weights values.
Changes in the Source code. Differences in the priority values and repair difficulty values for each technology.

This image shows the screen of Compare:
No53
Icon

Not defined means that a item wasn't in that model/version.
No changes means that a item wasn't modified in that model/version.

Global

Shows if there are differences in the Global indicator between the compared models.

Characteristics

At the beginning of this section you can see if there were any changes in the characteristics weights relative values.

The following table shows the differences between the characteristics relative weights values in the compared models. This table shows if a value is bigger, smaller or equal.

Technologies

At the beginning of this section you can see if there were any changes in the technologies weights relative values.

The following table shows the differences between the language relative weights values in the compared models. This table shows if a value is bigger, smaller or equal.

Source code

At the beginning of this section, you can see if there were any changes in the priority weight values or in the effort time values.

The following two tables show the differences between the priority weight values and effort assigned times in the compared models. You can check the differences in the priorities by CQM category and effort by language using the drop-down menus in the first column of each table.

Compare in Rules section

The Rules Compare section shows the differences found between rules contained in the compared models. It contains the following parts:

New rules. This tab shows the rules that have been added, that is, items that the left model contains, but not the right one.
Removed rules. This tab shows the rules that have been removed, that is, items that the right model contains, but not the left one.
Modified rules. This tab shows the rules present in both models but have been modified, that is, items that both models contains, but with a different configuration or version.

This image shows the rules compare section:

Filters in the Rules Compare
These filters are the same you can find in the Rules Management (OLD) section. Note that the "Active" filter is always active in the "New rules" tab and "Modified rules" tab, and it is always inactive in the "Removed rules" tab. When working with the "Current" version of a model, the same edit options allowed in the rules section are available in the "New rules" and "Modified rules" tab. Note that the changes affect the currently loaded model, not the model you are comparing with.