Creating Watchlists with or without Live Plots

You can create watchlists with or without live plots to observe variables during the execution. The values of these variables are then collected into the result category of the behavior experience.

If a watchlist has the live plot option, the variables of the watchlist are plotted in a plot window during the simulation.

Important: Before R2022x FD01 (FP.2205), watchlists and live plots were separate probes. If you work with old scenarios, such probes may still be present in your scenarios. For more information, see About Watchlist and Live Plot Probes Created Before R2022x FD01 (FP.2205).

This task shows you how to create watchlists with or without live plots and to add or remove signals from existing watchlists.

Tip: You can add signal operator probes on signals in watchlists. See Creating and Handling Signal Operator Probes On Signals in Watchlists.

See Also
About Behavior Experience
About Probes
Working with the Scenario Window
  1. Select a scenario in the tree.
  2. From the Scenario section of the action bar, click Edit Probes and Excitations .
    The Scenario window appears and displays the model structure, from the function or logical component to the dynamic behavior.
  3. To create a new watchlist with or without a live plot, expand a behavior and right-click an input or an output, and then select:
    • To create a watchlist without the live plot option, select Add to a new watchlist .
    • To create a watchlist with the live plot option, select Add to a new watchlist (with activated live plot) .
    • The variable is automatically added to a new Watchlist category of the Scenario window.

      In this example, both commands are given to add damper.phi_rel to both a new watchlist without and with the live plot option:



      Note: You cannot see from the header if the live plot option of the watchlist is activated, you must look in the tree.
    • In the tree, a Watchlist with and without the live plot option appears in the following locations:

    Tip: You can create multiple watchlists. For example, you can create multiple watchlists with the live plot option activated to monitor multiple variables in multiple plots.
  4. To activate or clear the live plot option of a watchlist, in the tree, right-click the watchlist and then click Activate Live Plot.

    Tip: You can multiselect watchlists to activate or clear the live plot option of them all.

    The live plot option of the watchlist is activated or cleared.
  5. To add a new variable to an existing watchlist, click the corresponding star in the watchlist column.

    Tip: When you pause over the star, a tooltip tells the variable name and the name of the current watchlist.
    Important: If you change or delete a shared watchlist, it is also changed or deleted in all other scenarios where it is used. To create a probe that is not shared, you must copy it. For more information about copying probes, see Copying and Pasting Excitations and Probes between Scenarios.

    The new variable is added to the watchlist column and the star is filled. The variable is also added to the watchlist nodes in the tree.
  6. To remove a variable from a watchlist, click the corresponding star.

    Tip: When you pause over the star, a tooltip tells the variable name and the name of the current watchlist.
    Important: If you change or delete a shared watchlist, it is also changed or deleted in all other scenarios where it is used. To create a probe that is not shared, you must copy it. For more information about copying probes, see Copying and Pasting Excitations and Probes between Scenarios.

    The variable is removed from the watchlist and the star is empty. You can then click the star again to restore the variable.

    The variable is also removed from the watchlist nodes in the tree.

  7. To remove a watchlist, right-click the watchlist in the tree and select Delete.

    Note: For a shared watchlist, you can work with the icon in the Scenario category or the icon in the Probes category, they are the same.
    Important: If you change or delete a shared watchlist, it is also changed or deleted in all other scenarios where it is used. To create a probe that is not shared, you must copy it. For more information about copying probes, see Copying and Pasting Excitations and Probes between Scenarios.

After the next computation, the corresponding watchlist nodes are created under the Result category to display the result:

Note: The icon of the watchlist result is the same for a watchlist with the live plot option as a watchlist without the live plot option.