Dependency Analysis

EHANDBOOK-NAVIGATOR allows you to determine dependencies between inputs and outputs of functions, calibration parameters and measurement variables.

The service works for ASCET block diagram models, Simulink models, C-Code derived models and wherever applicable it works across the hierarchy levels as well (i.e., connections in a sub-hierarchy are followed if it is a block diagram). Both highlighting and hiding of blocks and connections are supported. Highlighted blocks and connections are displayed in red, whereas hidden blocks and connections are displayed in gray.

Furthermore, Dependency Analysis Service works in both forwards and backwards direction, depending on whether an input or an output port of the block is selected as shown in the image below.

dep_analy_service

The Dependency Analysis Service provides improved readability and assists you in obtaining a better understanding of dependencies in function models. Using this feature, it is possible to find

  • Measurement variables that are influenced by certain calibration parameters, constants or system constants.

  • Calibration parameters, constants or system constants that influence a certain measurement variable.

Either an input or an output of a block can be highlighted or hidden in a single instance. Selection of multiple blocks or multiple inputs/outputs in a single instance is not possible. Multiple instances of highlighting and hiding on the same block are permitted.

Dependency Analysis Service is a visual aid. It does not influence the functioning of the model.
Dep_Analy

  1. Highlighted elements

Dep_Analy_hide

  1. Hidden elements

If you are using EHANDBOOK-NAVIGATOR in Basic Mode, only a dummy interactive model is available for performing dependency analysis.

There are four tasks that enable you to analyze the dependencies. They are:

  • Highlighting/hiding elements connected to the inputs of a block.

  • Highlighting/hiding elements connected to the outputs of a block.

  • Highlighting/hiding elements connected to the port labels.

  • Remove highlighting/hiding of blocks/labels.

Highlighting/Hiding Inputs of a Block

Highlight_input

  1. Input port selected

  2. Context menu

Highlighting or hiding the inputs of a block allows you to understand which other blocks, such as calibration parameters, constants and system constants, influence that block. The interactive model must be open in the Model Viewer to highlight/ hide elements connected to the inputs of a block.

To highlight/hide elements connected to an input:

  • Right-click the block that contains the required input port.
    A context menu (2) displays the inputs and outputs for the block.

  • Select the input port. The selected port is emphasized in red (1).

  • Select Highlight connected elements to highlight the elements connected to the selected input port, or select Hide connected elements to hide the elements connected to the selected input port.

Highlighting/Hiding Outputs of a Block

Highlight_output

  1. Output port selected

  2. Context menu

Highlighting or hiding the outputs of a block allows you to understand which other blocks, e.g. measurement variables, are influenced by that block. The interactive model must be open in the Model Viewer to highlight/hide elements connected to the inputs of a block.
To highlight/hide elements connected to an output:

  • Right-click the block that contains the required output port.
    A context menu (2) displays the inputs and outputs for the block.

  • Select the output port. The selected port is emphasized in red (1).

  • Select Highlight connected elements to highlight the elements connected from the selected output, or select Hide connected elements to hide the elements connected from the selected output.

Highlighting or Hiding Elements Connected to the Port Labels

Highlight_portlabels

  1. Port label selected

  2. Context menu

Highlighting or hiding the elements connected to the port allows you to understand which other blocks or elements, such as calibration parameters, constants and system constants, influence that port. The interactive model must be opened in the Model Viewer to highlight/hide elements connected to the port.
To highlight/hide elements connected to the port labels:

  • Right-click on the input or output port label.
    A context menu (2) displays for the selected input or output port.

  • Select Highlight connected elements to highlight the elements connected to the selected port, or select Hide connected elementsto hide the elements connected to the selected port.

Remove Highlighting or Hiding of Elements

Clear_highlighting

  1. Remove highlighting

This operation clears the highlighting or hiding information completely from the entire model and restores the model to its initial state. You can initiate the operation from the toolbar or from the Model Viewer menu or from the context menu displayed when you right-click in the Model Viewer.
To clear highlighting/hiding of elements:

  • Click Remove Highlighting (1) from the toolbar.
    <Or>

  • On the Model Viewer menu, select Remove Highlighting.
    <Or>

  • Right-click in the Model Viewer and select Remove Highlighting in the context menu.
    <Or>

  • Press <Ctrl+R>.
    The highlighting/hiding of the elements is cleared from the model.

The icon in the toolbar, the Model Viewer menu entry and the context menu entry are enabled only if elements and connections are hidden or highlighted in the interactive model.

Cease of Signal Flow Highlighting or Hiding

Cease_signalflow_highlight

  1. Unknown block highlighted in Orange

When highlighting/hiding the connected elements, the signal flow highlighting stops at complex blocks where the internals are unknown (C-Code scripts, ESDL) or hidden hierarchy. This helps you to better understanding of the interactive model. If necessary, you can continue the signal flow highlighting manually from these blocks.
These blocks where the signal flow highlighting/hiding stops is highlighted in Orange by EHANDBOOK-NAVIGATOR.

Changing the Color of Signal Flow Highlighting or Hiding

Pref_changecolor

  1. Color to highlight the connected elements

  2. Color to hide the connected elements

EHANDBOOK-NAVIGATOR allows you to change the default color of the signal flow highlighting/hiding. The default colors are red for highlighting and grey for hiding.

To change the color of signal flow highlighting/hiding:

  • Go to the menu, File and click Preferences.
    Preferences dialog box is displayed.

  • Click on the color of Highlighting of connected elements in the Model Viewer → Dependency Analysis to change the highlight color and click on the color of Hiding of connected elements in the Model Viewer → Dependency Analysis to change the hide color.
    A color pattern is opened.

  • Select or define the color and click OK.

  • Click Apply to apply the selected color.

  • Click Apply and Close. The selected color is applied.

Propagation of the Signal Flow Highlighting or Hiding for Unknown Blocks

While highlighting or hiding dependencies in interactive models, signal flow information is ceased due to unknown blocks like C-Code, ESDL, hidden (hierarchy) or solvers as shown in the image below.

Signal_flow_preferences

  1. Unknown blocks which are ceased by signal flow

  2. Bus Creator or Bus Selector blocks

In such cases, you can propagate the signal flow highlighting in forward and backward direction over unknown blocks which have 1 input and 1 output. This is possible by enabling the option in the Preferences window. You can propagate the signal flow over the Bus Creator or Bus Selector Blocks by selecting the check box Propagate dependency over Bus Creator or Bus Selector Blocks (Simulink only).

Signal_flow_preferences_BusSelector

  1. Checkbox to enable for the propagation of the signal flow highlighting/ hiding for unknown blocks

  2. Checkbox to enable for the propagation of the signal flow highlighting/ hiding for Bus Creator or Selector Blocks.

When you enable the option(1), then the signal flow for unknown blocks will be highlighted or hidden.When you enable the option(2), then the signal flow for Bus Creator or Bus Selector Blocks will be highlighted or hidden.

To enable the checkbox for the propagation of the signal flow highlighting/hiding for unknown blocks and Bus Creator or Bus Selector Blocks:

  • Go to the Window menu, click Preferences.
    Preferences dialog box is displayed.

  • Select the checkbox, Propagate dependency over blocks with unknown internal details and 1 input and 1 output and Propagate dependency over Bus Creator or Bus Selector blocks (Simulink only) in the Model Viewer → Dependency Analysis to enable the option. By default, this option is disabled.

  • Click Apply.

  • Click Apply and Close.
    The propagation of the signal flow highlighting/hiding for unknown blocks is enabled and the propagation of the signal flow highlighting/hiding for Bus Creator or Bus Selector Blocks is enabled.

Now, when you click on Highlight connected elements or Hide connected elements, the propagation of the signal flow over unknown blocks and Bus Creator/ Selector Blocks are continued.

Signal_flow_preferences_continuation

Signal Flow Highlighting for C-code Based Interactive Models

In C-code based interactive models, signal and control flow highlighting can be performed in forward and backward directions.

To highlight the signal flow for inputs in c-code based interactive models, rightclick on the required entity and then select Highlight inputs and click Signal flow based on your requirement. The highlighting of signals is color coded. The entities/ports/connections which are impacting are highlighted in red, by default.

Similarly, to highlight the signal flow for outputs, right-click on the required entity and then select Highlight outputs and click Signal flow. The entities/ ports/connections which are impacted are highlighted.

Sel_signalflow_ccode

The image below displays the entities/ports/connections which are impacting the selected entity are highlighted.

Signalflow_Ccode

The same can be performed for highlighting the Signal flow and control flow where it highlights for both the signal flow and the control flow path which are impacting or impacted by the entity, based on the inputs/outputs selected.

Signal and control flow highlighting cannot be triggered for hierarchy connectors.

Signal Flow Highlighting for C-code based interactive models is not supported in Basic Mode of EHANDBOOK-NAVIGATOR.

Highlighting of Connections in Interactive Models and Function Overview Diagrams

This feature highlights the lines, connected edges in Red color based on the selection in the interactive models (ASCET, Simulink, and C-code models) and Function Overview diagrams. This feature helps you to know the end to end connections for the selected line/edge. When a user clicks on a line/edge, the clicked line is highlighted in Red color. If the user clicks on a junction point, all the connected edges and lines are highlighted. When the user clicks on another line/edge/junction point, the previously highlighted line/edge/junction point is deselected. This feature works even for Virtual connections and all edges/lines highlighting.

Navigation and Exploration of ASCET Based Interactive

Models with Module Methods Navigation and exploration of ASCET based interactive models with module methods supports all operations with respect to expandable entities such as Navigate- in, Navigate-out, Model Exploration and so on. Module methods are also known as self classes in ASCET based interactive models.

On expanding a self class, it generates imported, arguments, exported and return connections.

Module_method

If you are using EHANDBOOK-NAVIGATOR in Basic Mode, then a dummy model is displayed in Model Viewer. The same dummy model is displayed whenever you try to access a model in Basic Mode.

Earlier to EHANDBOOK-NAVIGATOR 5.0, you could able to view the Function Overview diagram or Interactive models in a different window. Now EHANDBOOKNAVIGATOR supports to navigate from Function Overview to Interactive models in the same window through Seamless function wallpaper. It helps to make the connections for Function Overviews and Function Specifications (ASCET/Simulink) or Function Implementation (C-Code) continuously which means that you can navigate in the function wallpaper by means of connections from Function Overviews to Function Specifications (ASCET/Simulink)/Function Implementation (C-Code) or vice-versa in a single window. The Seamless function wallpaper operation can be done by expanding the seamless_function_wallpaper_icon icon which is available at the top left corner of every Function Overview block or the Function Specifications (ASCET/Simulink) or Function Implementation (C-Code) block. It is also possible to navigate in a seamless function wallpaper via click navigation, i.e. Navigate in and Navigate out.

seamless_function_wallpaper

  1. Function Overview entry in the TOC

  2. Function Implementation (C-Code) entry in the TOC

  3. Function Specifications (ASCET/Simulink) entry in the TOC

  4. Function Overview diagram in the Model Viewer

  5. Expand icon

  6. Function Implementation (C-Code) diagram in the Model Viewer

  7. Function Specifications (ASCET/Simulink) diagram in the Model Viewer

In general, it helps you to:

  • Navigate in/out to switch between Function Overviews and Function Specifications (ASCET models/Simulink models)/Function Implementation (CCode based models) diagrams.

  • Expand/collapse Function Overviews and integrate contained Function Specifications/Function Implementation diagrams. It provides virtual connections between Function Overviews and Function Specifications/ Function Implementation blocks.

  • Enables the signal flow highlighting.

Seamless Function Wallpaper Operation

To operate the Seamless function wallpaper:

  • Click on Function Overviews or Function Specifications (ASCET/Simulink) or Function Implementation (C-Code) entry in the TOC in the Document Explorer.
    The selected diagram is displayed in the Model Viewer.

  • Click seamless_function_wallpaper_icon icon to expand the corresponding block.
    If a Function Block is expanded, you can view all the interactive models of that Function.
    If a Function Specification (ASCET/Simulink) Block or Function Implementation (C-Code) Block is expanded, you can view all the ports and connections which are connected to that model.

You can view the virtual connections which are connected in the model in Auto Layout mode only. The connections are not shown in the Default Layout mode.

Viewing the Function Overview Diagram Through an Interactive Model

Seamless function operator helps to view the Function Overview diagram, Interactive models, and connections in a single window. In the same way, you can also view the Function Overview diagram from the Interactive models.Navigate out feature helps to view the Function Overview diagram from the Interactive models in the Model Viewer.

To view the Function Overview diagram:

  • Click Navigator_out_icon in the toolbar.

  • Right-click on an interactive model.
    A context menu is displayed.

  • Click Navigator_out_icon_menu
    A Function Overview diagram is displayed.

Signal Flow Highlighting or Hiding in the Seamless Function Wallpaper

Highlight connected elements/Hide connected elements of an input/output of a block in the Seamless function wallpaper helps you to view the highlighted/ hidden elements or ports of multiple blocks in a single window. When you click Highlight connected elements/Hide connected elements of a port of a function block, the signal flow highlighting/hiding crosses the interface of the function block and it ceases at the simple element of the interactive block encountered in that path. It also highlights/hides the ports, if they are impacted.

seamless_function_wallpaper_hiding