Intelligence Dashboard Overview

Leverage the Intelligence Dashboard to improve the quality and analysis of your Innoslate project.

As an Innoslate project grows the process of analyzing it and pinpointing project issues becomes more intricate. In the software domain, many tools exist to maintain performance such as compilers, static code analysis tools, and even automatic graders. Esteemed professors from prestigious research institutions, such as the Naval Postgraduate School and Stevens Institute of Technology, developed structured models of system architecture known as heuristics. These heuristics are integrated into Innoslate through the Intelligence Dashboard feature.

Innoslate's Intelligence Dashboard leverages these heuristics to assess projects in Innoslate and generate a model score across 6 key categories: Action, Asset, Conduit, Input/Output, Requirements, and Global. Each category is scored and labeled by the entity class name, except for Global. A 7th category, the Overall Analysis score, uses all 6 categories scores to provide a comprehensive score 'Pass Rate' of the project.

The Intelligence Dashboard's scoring is determined as a percentage score. The 6 categories are individually determined by the number of successful passes out of the total entity heuristics tested. By combining the tests passed from the 6 categories and dividing by the total tests run, you can calculate the Overall Analysis 'Pass Rate' Score for your Innoslate project.

Within the Intelligence Tool, you have the option to customize the 'settings' (heuristics) to tailor the analysis to your specific needs. Whether it's adjusting Global settings, Action settings, Asset settings, Conduit settings, Input/Output settings, or Requirement settings, you have the flexibility to fine-tune the analysis to meet your project's specific requirements.

Each heuristic in the Intelligence Dashboard serves a specific purpose, such as ensuring consistency in entity names, verifying that actions have proper naming conventions, and confirming that each action is associated with the necessary inputs and outputs. By following these guidelines, you can enhance the clarity and effectiveness of your model.

Overall, the Intelligence Dashboard is a valuable tool for optimizing the quality of your project and streamlining the modeling process. By utilizing the insights and recommendations provided, you can improve the accuracy and efficiency of your Innoslate project.

Navigating to the Intelligence Dashboard

1. From within a project, open the ‘MENU’ drop-down and click the ‘Intelligence’ menu item under the 'Specialized' section.
   
                                
   
   
2. Once in the ‘Intelligence Dashboard’, the analysis will automatically run the first time you open the view. After model changes, you may rerun the analysis by selecting the ‘Run’ button again.

Intelligence Dashboard Overview

Upon opening the ‘Intelligence Dashboard’ and the initial analysis finalizes, the Dashboard opens and will display feature buttons on the top right and the Intelligence Dashboard to display the Widgets. Let's explore these in more detail below.

Feature Buttons

The buttons provided are:

'Help' -to direct you to this Help Center page

'Run' to rerun the Intelligence Analysis (to update the scores, especially helpful if project changes have happened)

'Save Dashboard Layout' will appear when changes are made to the Intelligence Dashboard. Select 'Save' when you'd like to save your desired layout.

'Add Widget' to add a widget back on to the Intelligence Dashboard.

Intelligence Dashboard Widgets

The Intelligence Dashboard presents all available widgets by default, allowing users to easily drag, drop, resize or close them according to their preferences.

The widgets on the Intelligence Dashboard available are:

• Overall Analysis
• Global Analysis
• Action Analysis
• Asset Analysis
• Conduit Analysis
• Input/Output Analysis
• Requirement Analysis
• Bar Analysis

Next, we will explore the features of these widgets and their specific functions and capabilities.

Overall Analysis Widget

The Overall Analysis Widget will provide the overall 'Pass Rate'. Click the widget to expand and see the individual category's scores:

 

When you hover your cursor over the widget, you'll notice icons on the top right. These icons serve specific functions and are explained below:

Lock the Widget so it remains in its place on the Dashboard. Be sure to select 'Save Dashboard Layout' for the lock to take effect.

Maximizes all collapsed heuristics that needs to be addressed 

Remove Widget off the Dashboard. Be sure to select 'Save Dashboard Layout' on the top of the Dashboard for the removal to take effect.

Editing a Widget will make a window popup for you to edit individual heuristics by Category. You may set the heurisitic to be a Warning, Error or Ignore All. After the modfications are selected, select 'Set' to update the analysis. The applicable scores will update to reflect the changes. 

Global Analysis, Action Analysis, Asset Analysis, Conduit Analysis,  Input/Output Analysis & Requirement Analysis Widgets

The Global Analysis, Action Analysis, Asset Analysis, Conduit Analysis, Input/Output Analysis, and Requirement Analysis Widgets all share similar functionalities as detailed below.

Take note of the key components within these widgets on the Intelligence Dashboard: header icons, list of issues categorized by heuristic, expand/collapse buttons for the issues, and the calculation and score displayed in the footer. 

The header icons for these widgets are as follows:

Lock the Widget so it remains in its place on the Dashboard.

  The 'Unignore All' icon will appear when an Issue is ignored. Its purpose is to bring back ignored issues.

Maximizes ALL the issues.

Editing a Widget will make a window popup for you to edit individual heuristics by Category. You may set the heurisitic to be a Warning, Error or Ignore All. After the modfications are selected, select 'Set' to update the analysis. The applicable scores will update to reflect the changes. 

Removes widget off the Dashboard. Be sure to select 'Save Dashboard Layout' on the top of the Dashboard for the removal to take effect.

Issues

During the analysis, if an entity fails to meet the heuristic the heuristic will appear as either an error (red) or a warning (yellow). By default, the heuristics' list of issues are collapsed, allowing you to expand the individual heuristics to identify the entity/entities that require attention. To see all, use 'Maximize' in the widget header.  

When hovering your cursor over the expand/collapse buttons the amount of entities with issues will display in the form of a tooltip for each heuristic. Upon expanding the entities, the Intelligence Dashboard provides the options to either 'Fix' the issue promptly or 'Ignore' it. You may also right click on the entity to fix the issue in Entity View.

Depending on the specific heuristic, the process of fixing an entity may vary, often requiring you to determine the appropriate solution through a window. When an entity is fixed, a 'Fixed Markings' popup will appear in the widget to inform you fixed entities are marked in gray and that the analysis needs to be re-ran with the 'Run' button on the top of the Dashboard to get a new score.

When 'Ignore' is selected, the entity will dissapear from the list. The first time 'Ignore' is selected, the 'Unignore All' Icon will appear on the widget's toolbar.

Calculation and Score

Per Category, the calculation is determined by the number of successful passes out of the total entities the heuristics analyzed. For example, there are 388 entities in a project and there are 5 heurisitcs in the Global Analysis, so we multiply 388 x 5=1940. After the analysis is ran, 387 issues were found in total among the 5 heuristics in the Gloabl Analysis. The score is therefore calculated as 387/1940 = 20% (rounded up from .199).

The Overall Analysis 'Pass Rate' is calculated by dividing the number of Tests Passed by the total number of Tests Run (knowing how this calculation works can be especially useful when certain categories and heuristics are not conducted).

Bar Analysis Widget

The Bar Analysis provides a Bar Chart Analysis of the errors and warnings by Category. Users may interact with the chart and show just errors, or just warnings by clicking on the desired option on the legend.

The header provides the following options for you to utilize.

Lock the Widget so it remains in its place on the Dashboard.

Download a PNG (Opaque or Transparent) of the Bar Analysis.

The below window will popup for you to edit individual heuristics by Category. Select 'Set' after modification. The 'Pass Rate' score will update to reflect the changes. 

Remove Widget off the Dashboard. Be sure to select 'Save Dashboard Layout' for the removal to take effect.