Analyzing Events

You can analyze the events.


Before you begin: To have a model to work with, do the following:
  • Create a behavior experience from the Dymola model example Coupled Clutches. See Creating a Behavior Experience from a Model.
    Note: To select the model example Coupled Clutches in the first step, replace step 1 in the reference with the following: In the Dymola Behavior Modeling app, from the Behavior Tools section of the action bar, display the model example flyout by clicking Model Examples , then select Coupled Clutches .
  • Display the Simulation Setup dialog box, see Setting up a Simulation. In the Debug tab, activate the following:
    • Events during simulation to get statistics about events.
    • (optional) Events during initialization to get statistics also about initialization events.
  • Simulate the model. See Simulating and Generating Results.
    Note: The simulation must be finished before analyzing events.
  • Display the Variable Browser. See Simulating and Generating Results on how to display the Variable Browser.
  1. From the Scenario section of the action bar, click Simulation Analysis .

    Tip: You can also, from the Variable Browser, do any of:
    • Under the header, to the right, click Simulation Analysis .
    • Right-click any signal and select Simulation Analysis .
    For information on how to display the Variable Browser, see Simulating and Generating Results.

  2. Click the Event Log tab.
    The Event Log tab contains a list of all event points that happened during the simulation, sorted by time, and the number of events for each event point.

    If the option Events during initialization is activated, also those events are displayed at time 0.

    Notes:
    • The window can be minimized, it is then displayed with the icon on the right side of the screen.
    • If no events occurred, the Event Log tab is not displayed.
  3. To see also the minor events, activate Minor Events.

    By default this option is cleared, to let you concentrate on the main events.

    Note: The model Coupled Clutches used in this scenario generates no minor events.

  4. To see the details of the events for a specific time, expand that time node.

    Tips:
    • You can also double-click a time node to expand it.
    • You can use the Alt and Ctrl keys to select several time nodes, and then use Expand Event to expand them.
    • You can expand all time nodes by right-clicking a node or event line and select Expand All.
    • You can collapse all time nodes by right-clicking a node or event line and select Collapse All.

    The following information appears in the columns:
    • The time of an iteration containing one or several events.
    • The number of iterations.
    • The expression that triggered a specific event.
    • The value of the expression after a specific event.
  5. To search a specific event expression, in the Expression filter field, start entering the event expression.
    The filtering is dynamically applied.
  6. To investigate where a certain event expression appears, including the display of other events, do the following:
    1. Search the event, see previous step.
    2. Right-click the event line and select Highlight Expression.
      The expression for the event is highlighted at all times where it appears.
      Important: Only highlights in expanded nodes are displayed.
    3. In the Expression filter field, remove the expression.
      All event expressions are now displayed. The specific event expression is still highlighted.

    Tip: If you want to do this for an event expression that you see without searching, select it and click Expand Event.

    Important: If you close a node, there is no indication on that node if it contains a highlighted error expression. To check, see next step.
  7. At any time, to display the highlighted error expression and at what times it is used, right-click any node or line and click Expand Highlighted.

    The highlight is remembered until you close the event log window.

  8. To display an overview of the events during the integration in a plot, click Plot Event Overview.
    Time events and state events are plotted in the active plot window, or, if no active plot window exists, in a new plot window.