In this section:
Introduction
The Machine Learning flow provides a set of widgets that display Violations to Fix recommendations made by the DTP machine learning feature.
Installation
The Machine Learning flow is installed as part of the Process Intelligence Pack. See the Process Intelligence Pack Installation instructions for details. After installing the pack, deploy the widgets and report to your DTP environment.
- If you have not already done so, install the Process Intelligence Pack.
- Open Extension Designer and click the Services tab.
- Expand the Process Intelligence Engine service category. You can deploy assets under any service category you wish, but we recommend using the Process Intelligence Engine category to match how Parasoft categorizes the assets. You can also click Add Category to create your own service category (see Working with Services for additional information).
- You can deploy the artifact to an existing service or add a new service. The number of artifacts deployed to a service affects the overall performance. See Extension Designer Best Practices for additional information. Choose an existing service and continue to step 6 or click Add Service.
- Specify a name for the service and click Confirm.
- The tabbed interface helps you keep artifacts organized within the service. Organizing your artifacts across one or more tabs does not affect the performance of the system. Click on a tab (or click the + icon to add a new tab) and click the vertical ellipses menu.
- Choose Import > Local > Flows > Workflows > Process Intelligence > Machine Learning and click anywhere in the open area to add the artifact to the service.
- Click Deploy to finish deploying the artifact to your DTP environment.
- Return to DTP and refresh your dashboard. You will now be able to add the related widgets.
Adding and Configuring the Widgets
After deploying the artifact, the following widgets will be available in DTP under the Machine Learning category:
- Violations to Fix - Bar Chart (Large, Medium, Small)
- Violations to Fix - Pie
- Violations to Fix - Percentage
See Adding Widgets for instructions on adding widgets to the dashboard.
Violations to Fix - Bar Chart (Large, Medium, Small)
These widgets show the distribution of violations based on the confidence that a violation should be fixed. The Large widget is 3X2, the medium widget is 3X1, and the small widget is 2X1. See About the Dashboard Grid for additional information about widget sizes.
Each bar represents violations grouped by the fix percentage. The Y-axis shows the number of violations in the target build at either a liner or algorithmic scale (see Configuration). The X-axis shows the prediction percentage from 0% to 100%.
Actions
You can hover your pointer over a bar to see additional info in the tooltip. The widget does not link to any other DTP interface.
Configuration
You can configure the following settings:
| Title | Enter a new title to replace the default title that appears on the dashboard. |
|---|---|
| Filter | Choose Dashboard Settings to use the dashboard filter or choose a filter from the menu (see Configuring Filters for more information about filters in DTP). |
| Target Build | Choose the build containing the data you want to see. Default is Latest Build. |
| Y-Axis Scale | Choose Linear to set the Y-axis scale to show the actual number of violations in the build along the Y-axis. Choose Log to set the Y-axis scale to show the number of violations as a logarithmic scale along the Y-axis. This option allows smaller values to be more easily visible alongside larger values and improves readability when the build contains a large number of violations. |
Violations to Fix - Pie
This widget shows the number of violations that are recommended to be fixed based on a user-defined threshold. Violations are categorized as To Fix or To Review based on the percentage threshold.
Actions
You can hover your pointer over a segment of the pie chart to see additional info in the tooltip. The widget does not link to any other DTP interface.
Configuration
| Title | Enter a new title to replace the default title that appears on the dashboard. |
|---|---|
| Filter | Choose Dashboard Settings to use the dashboard filter or choose a filter from the menu (see Configuring Filters for more information about filters in DTP). |
| Target Build | Choose the build containing the data you want to see. Default is Latest Build. |
| Percentage Threshold | Specify a single float value between 0 and 1.0 to determine the threshold for categorizing violations as To Fix. If a violation's fix percentage is greater than or equal to this value, the violation will be categorized as To Fix in the widget, and if the violation's fix percentage is less than this value, it will be categorized as To Review. The default value is 0.5. |
Violations to Fix - Percentage
This widget shows the percentage of violations that are recommended to be fixed based on a user-defined threshold. Violations are categorized as To Fix or To Review based on the percentage threshold.
Actions
The widget does not link to any other DTP interface.
Configuration
| Title | Enter a new title to replace the default title that appears on the dashboard. |
|---|---|
| Filter | Choose Dashboard Settings to use the dashboard filter or choose a filter from the menu (see Configuring Filters for more information about filters in DTP). |
| Target Build | Choose the build containing the data you want to see. Default is Latest Build. |
| Percentage Threshold | Specify a single float value between 0 and 1.0 to determine the threshold for categorizing violations as To Fix. If a violation's fix percentage is greater than or equal to this value, the violation will be categorized as To Fix in the widget, and if the violation's fix percentage is less than this value, it will be categorized as To Review. The default value is 0.5. |
