Model Views

Model Explorer

Image Explorer
  1. Complex Block

  2. Hierarchical Element

  3. Collapse

  4. Expand

  5. Edit Function Overview

  6. Minimize

  7. Maximize

  8. Close

The Model Explorer allows you to explore the models of an EHANDBOOK container. Model Explorer displays the topics in the form of a tree structure. The topics present in the structure contain interactive models. The interactive models are displayed in the Model Viewer. An interactive model consists of Complex blocks and Hierarchical elements. A complex block is a representation of the entire model and hierarchical blocks represents a logical grouping of the model elements for a specific function.

Layout information and Highlighting/Hiding information is retained when you navigate between different elements in Model Explorer

Seamless interconnection exists between Document Explorer, Model Explorer and Model Viewer.

Navigation and selection in the Model Explorer is possible with the keyboard and the mouse.

Keyboard: Press Up arrow/Down arrow keys to move up and down the tree structure. Press Right arrow key to expand and press Left arrow key to collapse the levels within the tree structure. Navigate to the Model Explorer and press Enter to view the content in the Model Viewer.

Mouse: Click Expand button (4) to expand the levels, and Collapse button (3) to collapse the levels in the structure. To view the model in the Model Viewer, click the relevant interactive model.

To close the Model Explorer, click Close (1). Click Maximize (6) or Minimize (5) to maximize or minimize the Model Explorer.

The model views available for selection in the EHANDBOOK-NAVIGATOR depend on the provider of the EHANDBOOK container.

The Model Viewer displays the model of an EHANDBOOK container. The Model Viewer is enabled only when an EHANDBOOK container is loaded. Whenever you select a model from the Model Explorer, the model relevant to the selected topic is displayed in the Model Viewer.

Clicking the model name in Document Explorer or Model Explorer displays the model in the Model Viewer.

If the model names are not available in the source model, then the Model Explorer displays blank names. When you hover the mouse over the blank name, a tool tip displays "No label info available in source model" for the same.

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.

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.

Wrong, incomplete or missing container content in the "Document Explorer" and the "Model Explorer" area in the EHANDBOOK-NAVIGATOR main screen!

Affected container contents will be displayed wrong, incomplete or can be missing in the EHANDBOOK-NAVIGATOR. The following information can be affected:

  • documentation texts

  • documentation structure

  • interactive models

Therefore, always check the container in the EHANDBOOK-NAVIGATOR for wrong, missing or incomplete content by validating that the container content corresponds to the ECU documentation source before you start working.

Before working with a container:

  • Open the container in the EHANDBOOK-NAVIGATOR

  • Validate that the container content corresponds to the ECU documentation sources using the "Document Explorer" and the "Model Explorer".

  • If you find model deviations, wrong, missing or incomplete content, contact the producer of the container to fix this errors.

To identify the cause for the wrong, missing or incomplete content, the producer of the container must check the source files from where the container was created. If the source files are correct and the appearance of the error is reproducible, the producer of the container must contact the local sales representative or the ETAS support to report this error.

Model Viewer

Model Viewer
  1. View Bar

  2. Close

  3. Bookmark

  4. Copy Location

  5. Minimize

  6. Maximize

The Model Viewer is used to explore models interactively. The Model Viewer supports ASCET block diagram models, ASCET State Machines, Simulink models and C-Code derived models. The View Bar (1) of the Model Viewer displays the name of the interactive model currently displayed in the Model Viewer.

Navigation within models and across hierarchies is allowed. The model can be moved from its position by clicking on it and then dragging it to the required position. Scroll button can be used to zoom in and zoom out. To close the Document Viewer, click Close (2). Click Create Bookmark (3) to create a bookmark. Click Click to copy location to the clipboard (4) to copy a specific location and make it easy to paste and click Minimize (5) or Maximize (6) to minimize/maximize the Document Viewer.

Highlighting of the connections

The connections are highlighted in blue when you hover the mouse over any of the connections in the model viewer. It helps you to identify the ports or the connections which are interlinked. The highlighting will be disappeared when you move the mouse. If you want to retain the highlighting, then click on the same connection.

This works for ASCET block diagram models, Simulink models, C-Code derived models and function overview diagrams.

Differentiated Background for Multilevel Hierarchies:

Differentiated Background for Multilevel Hierarchies

When you expand or expand out a block, the blocks are displayed in different background color. This enables you to easily differentiate the multilevel hierarchies in the model.

Differentiated background for multilevel hierarchies are supported for ASCET and Simulink models.

You can modify the layout of the interactive model. Two types of model layouts are provided in the Model Viewer.

Default Layout

The layout designed in the authoring tool (ASCET) is generated.

Default Layout

Auto Layout

Layout algorithms built in EHANDBOOK optimizes the block and connection placements and generates an automatic layout of the ASCET model/Simulink model/Function Overview Diagram.

Auto Layout

ASCET ESDL, C-Code components and CT-blocks are not supported in EHANDBOOK-NAVIGATOR.

Virtual connections are displayed for expanded blocks. Virtual connections are additional connections that show the input and output connections of the hierarchical blocks with its parent blocks.

Virtual connections are shown only when auto layout is applied to the interactive model as they are not part of the default layout.

Scalar calibration parameters in ASCET models are not shown as part of the interactive models in EHANDBOOK-NAVIGATOR as this data might be obsolete during calibration.

Additionally, the Model Viewer supports the following features:
  • Visualization of live values for measurement variables and calibration parameters from a connected INCA experiment.

  • Calculation and highlighting of dependencies between inputs and outputs of functions, calibration parameters and measurement variables.

  • Working with multiple interactive models in parallel.

  • Find in current tab can also be initiated in the Model Viewer. To display the Find in current tab box, Press <CTRL+F> or press <F3>.

  • The zoom level can be adjusted.

Make sure that high screen resolution setting is enabled during installation to view the Model Viewer and the Function Overview Diagrams properly.

Print Diagram

Print Diagram allows you to check and customize the print settings for a model. Print Diagram window is displayed when you invoke the printing action for a model.

Print Diagram
  • Print settings - Allows you to check and edit the general printer settings.

  • Scaling - Allows you to resize the model according to your requirements.

    • Scale 100% - Resizes the model to 100%.

    • Fit to pages - Resizes the model so that the entire model fits to the page/pages.

    • Adjust pages - Removes the empty pages.

    • Scale diagram to - Resizes the model based on the percentage set.

    • Print to - Allows you to Add/Remove pages horizontally or vertically for a model.

    • Pages wide by - Adds/Removes pages in horizontal position.

    • Pages tall - Adds/Removes pages in vertical position.

  • Orientation

    • Portrait - Sets the page orientation to Portrait.

    • Landscape - Sets the page orientation to Landscape.

  • Alignment

    • Center diagram - horizontally - Aligns the model in the center horizontally irrespective of the number of pages.

    • Center diagram - vertically - Aligns the model in the center vertically irrespective of the number of the pages.

  • Print Range - Allows you to select the pages for printing.

  • Copies - Allows you to set the number of copies for printing.

  • Collate - Arranges the printed sheets in a pre-determined sequence.

  • Print Preview - Displays/Hides the preview of the model in the Print Diagram window.

  • Print now - Prints the selected model.

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. The functionalities of Model can be performed on the dummy model available in Basic Mode.

Basic Mode

Context Menu

Interactive Model Context Menu
  1. Context menu

Select the Model Block and then right-click or right-click on the Model block text to view the Interactive Model context menu.

The Context Menu (1) contains the following menu items:

  • Display Value
    Configures the block to display the value of the measurement variable when you start the visualization.

  • Hide Value
    Hides the value of the measurement variable for the model block that is already configured to display the measurement value.

  • Copy
    Allows you to copy text present in the interactive model. This option is active in the context menu, only if text strings are selected in the Model Viewer.

  • Find in EHANDBOOK Files(s)
    Initiates the search in all the loaded EHANDBOOK files for the selected text. This option is active in the context menu, only if a relevant entity (text strings, model blocks) is selected in the Model Viewer.

  • Find in current tab
    Initiates the search in the currently opened tab for the selected text.

  • This option is active in the context menu, only if a relevant entity (text strings, model blocks) is selected in the Model Viewer.

  • Input
    Highlight/hide inputs of the selected block. This option is displayed in the context menu, only if any model blocks is selected in the Model Viewer.

  • Output
    Highlight/hide outputs of the selected block. This option is displayed in the context menu, only if any model blocks is selected in the Model Viewer.

  • Remove Highlighting
    Removes the highlighting/hiding of dependencies. This option is active in the context menu, only if dependencies are highlighted/ hidden.

  • Print…​
    Displays the Print dialog box. In the dialog box, specify the printer and invoke the printing action.

Function/Component Overview Diagram

Function Overview Diagram
  1. Importing Functions

  2. Exporting Functions

Function Overview Diagram feature in EHANDBOOK-NAVIGATOR assists you in obtaining an overview between function components (FCs). ECU software function components are dependent on each other. EHANDBOOK-NAVIGATOR allows you to trace the communication occurring between functions.

The Plus Icon icon is available at the top left corner of every Function Overview Diagram if the corresponding function belongs to ASCET or Simulink or C_CODE based models. It helps to make the connections seamlessly in a single window for Function Overviews and Function Specifications (ASCET/Simulink) or Function Implementation (C-Code).

In the function overview diagram the importing functions (1) are displayed on the left and the exported functions (2) are displayed on the right.

Press F3 to initiate a Find in current tab in the function overview diagram. When a label is selected, the properties of the label are displayed in the Properties View.

Make sure that high screen resolution setting is enabled during installation to view the Model Viewer and the Function Overview Diagrams properly.

If you are using EHANDBOOK-NAVIGATOR in Basic Mode, then a dummy Function Overview diagram is displayed. The same dummy Function Overview diagram is displayed whenever you try to access a Function Overview diagram.

Basic Model Function Overview

Component Overview diagram

In AUTOSAR (Classic) based ECU software, the algorithms of the ECU functions are represented by software components. These software components can have ports of different interface types (e.g., Sender/Receiver or Client/Server). The interfaces which type the ports can have additional entries (e.g., Data Elements as part of the Sender/Receiver interface). To establish communication, the ports must be connected via connectors.

When an EHANDBOOK Container contains component information that was based on AUTOSAR (Classic), the dependency between the components can be shown in the overview diagrams.

The communication between components is based on AUTOSAR ports and their connections.

Communication between Function Overview Ports

To show the ports between components and their dependencies, the AUTOSAR (Classic) Add-On for EHANDBOOK-NAVIGATOR is required.

Connected and Non-connected Ports in Function Overview Diagrams

The ports in the Function Overview Diagrams are color coded. This helps you in identifying if the ports have any further connections or not. The connected ports are displayed in Red and non-connected ports are displayed in Grey. When you hover the mouse on the connected ports a hand pointer is displayed. Clicking on the connected ports display further functions, values of that port. The connections to the port are highlighted in green. Clicking on non-connected ports does not perform any action.

Function Overview Ports
  1. Connected ports

  2. Non-connected ports

Normal and Compact Views in the Function Overview Diagrams

Normal and Compact View

There are two types of view that are as listed below: * Normal View * Compact View

*Normal View *displays both connected ports and non-connected ports in the function overview diagram.

To apply normal view to a function overview diagram:

You can perform any one of the following steps:
  1. Open a function overview diagram.
    Click Normal View Icon on the toolbar.
    Normal view is applied on the function overview diagram.
    <Or>

  2. Right-click in the Model Viewer and select Normal View.
    <Or>

  3. Go to View menu and select Normal View.

When you apply normal view to the function overview diagram a text is indicated at the bottom right corner of each function as shown in the image below:

Function Overview Normal View

Compact View displays only the connected ports in the function overview dia- gram. The non-connected ports are hidden in the Compact View.

There is a text indication at the bottom right corner of each function which shows the type of the view that has been applied to the function.

  • The compact view displays non-connected ports when a function is removed using Remove Function option.

  • When you add new functions using Edit Function Overview, the ports of the existing functions which are connected to the newly added functions are displayed.

To apply compact view to a function overview diagram:

You can perform any one of the following steps:
  1. Open a function overview diagram.
    Click Compact View Icon on the toolbar.
    Compact view is applied on the function overview diagram.
    <Or>

  2. Right-click in the Model Viewer and select Compact View.
    <Or>

  3. Go to View menu and select Compact View.

When you apply compact view to the function overview diagram a text is indicated at the bottom right corner of each function as shown in the image below:

Select Normal/Compact View

To apply normal or compact view to a specific function follow the steps below:

  1. Select and Right-click on the function.
    A context menu displays.

  2. Select Normal or Compact View.
    Selected view is applied on the model.

Function Overview Show/Hide Interface

Show and Hide Interface Elements in the Function Overview Diagrams

Show & Hide ToolBar
  1. Show Interface Elements

  2. Hide Interface Elements

Show Interface Elements displays interface elements of all the ports of the cur- rent selected function in the function overview diagram.

To display interface elements of a function overview diagram:

You can perform any one of the following steps:
  1. Open a function overview diagram.
    Click Toolbar Icon on the toolbar.
    Displays interface elements on all ports of the function overview diagram. <Or>

  2. Right-click in the Model Viewer and select Show Interface Elements.
    <Or>

  3. Go to View menu and select Show Interface Elements.

When you apply Show Interface Elements to the function overview diagram port names are displayed in blue color and all the respective interface elements are displayed below each port in a tabular format as shown in the image below:

Function Overview All Interface Elements Displayed
  1. All interface elements are displayed

To view interface elements of a specific port, right click on the port and select Show Interface Elements from the context menu. Only the selected port interface elements are displayed.

Hide Interface Elements hides interface elements of all the ports from the currently selected function in the function overview diagram.

To hide interface elements of a function overview diagram:

You can perform any one of the following steps:
  1. Open a function overview diagram.
    Click Hide Inferface Icon on the toolbar.
    Hides interface elements on all ports of the function overview diagram.
    <Or>

  2. Right-click in the Model Viewer and select Hide Interface Elements.
    <Or>

  3. Go to View menu and select Hide Interface Elements.

When you apply Hide Interface Elements to the function overview diagram all the interface elements are hidden as shown in the image below:

Function Overview All Interface Elements Hidden
  1. All interface elements are hidden

To hide interface elements of a specific port, right click on the port and select Hide Interface Elements from the context menu. Only the selected port interface elements are hidden.

After adding interface elements to the function overview diagram and being connected to INCA Experiment or by loading a measurement file it is possible to display values additionally for the interface elements.

To display all values of a function overview diagram click Show All Values Icon in the status bar and to hide all values of a function overview diagram click Hide All Values Icon in the status bar.

  • To display values on a specific port. You need to keep Function overview dia- gram in a Show Interface Elements mode.

  • You need to load Measurement and Calibration Files or Connect to INCA Experiment. Refer to Visualization of Offline Measurement.

To Show/View info of an interface and interface element follow the steps below:

  1. Click on the Interface element.
    A label pop-up displays.

Interface Element Label Popup
  1. Click Pin Icon To pin and move the label pop-up.
    Label pop-up is pinned as a separate window.

Pinned Interface Element Label Popup

If a Label pop-up is not pinned, then it closes automatically when any other operation is performed in the application or when you click outside the pop-up area.

  1. Click Show Interface Icon. To view info of the parent Interface. A label pop-up displays.

Show Interface Element Label Popups
Two Interface Element Label Popups

The label pop-up gets overlapped on the existing pop-up. To view both existing and latest pop-ups you need to pin and drag the latest pop-up to a different position.

  1. Click Show Interface Icon. To view info of the Interface Element. A label pop-up displays.

Three Interface Element Label Popups

To display or hide values on a specific port of a function overview diagram follow the steps below:

  1. Select and Right-click on the Port.
    A context menu displays.

  2. Select Display or Hide Value. Selected view is applied on the port.

When you apply display value to the selected port a table is displayed containing Name, Unit and Values as shown in the image below:

To view interface element of a specific port, hover the mouse on Show Interface Element and select required Interface Element from the context menu, only the selected port interface element is displayed. To hide interface element of a specific port, hover the mouse on Hide Interface Element and select required Interface Element from the context menu, only the selected port interface element is hidden. To view all the interface elements select Show all Interface Elements and to hide all the interface elements select Hide all Interface Elements.

Display/Hide Values on Specific Port
  1. Display Value

  2. Values are displayed

  3. Show all Interface Elements

  4. Show Interface Element

  5. Hide all Interface Elements

  6. Hide Interface Element

Annotate values to the Function Overview Diagram

The function overview diagrams derived from AUTOSAR (Classic) based ECU software, values can be annotated to the interface elements. Load Measurement and Calibration Files or Connect to INCA Experiment and keep the interface elements in a Display mode.

To display all values of a function overview diagram click Show All Values Icon in the status bar, and to hide all values of a function overview diagram click Hide All Values Icon in the status bar.

Click Play Icon to start the visualization. You can view the live values of the measurement variables and calibration parameters in the interactive model.

INCA Experiment Annotated FO
  1. INCA Experiment Annotated view

You can view the Cursor A & B values. Click Cursor Icons buttons to step forward/backward in time for the Cursors A & B.

INCA Experiment Cursor Annotated FO
  1. Backward

  2. Forward

  3. Measurement and Calibration files Annotated view

Outline View

Outline View
  1. Close

  2. Outline box

  3. Minimize

  4. Maximize

The Outline View provides an overview of the model displayed in the Model Viewer. It shows the holistic view of the parent model. An Outline box(2) indicates which section of the model is in focus in the Model Viewer. Outline view allows you to navigate large models quickly and precisely. To navigate to any section of the model in the Model Viewer, click and drag the Outline box to that section within the Outline view.

To close the Outline View, click Close (1). Click Minimize (3) or Maximize (4) to minimize/maximize the Outline View.