Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page

Table of Contents
maxLevel3

The Results Player displays numerical values from a CSV file directly in composite structure diagrams, such as Internal Block Diagram, Parametric, etc. This allows you to review the simulation results, specific time steps, and display results of an external simulation (for example, a SSP export).


The Results Player when a file is loaded.

Understanding the UI components of the Results Player

The following table explains the UI components of the Results Player:

IconNameDescription

Image Removed

Load/Unload File 

Selects a CSV export file to load/Deselects the CSV export file.

Image Removed

BeginningStops the play and jumps to the first step.

Image Removed

Step BackwardJumps to the previous step.

Image Removed

PlayStarts automatic playback of time values in real-time.

Image Removed

Step Forward Jumps to the next step.

Image Removed

EndStops the play and jumps to the last step.

Image Removed

Playback speedControls the playback speed.

Image Removed

SliderDisplays the current position and allows you to manually scroll through the values.

Image Removed

Time indicatorShows the current step and allows you to manually enter the desired time value.

Image Removed

Time Series ChartGenerates the Time Series Chart.

Image Removed

Export to InstanceGenerates the Instance.

Launching the Results Player

You can launch the Results Player both through the Containment tree and the composite structure diagram.

To launch the Results Player


  • In the Containment tree, right-click the composite structure diagram and select Tools> Results Player.



  • In the composite structure diagram, right-click anywhere and select Tools>Results Player.


Loading CSV export file

You must load the CSV export file to be able to use the Results Player. You can load the CSV export file either manually or automatically after simulation terminates.

To load the CSV export file manually


  1. Click on the Load File command in the Results Player.

    Image Added

  2. In the Open dialog, select the CSV file.

    Image Added

Note
titlePrerequisites
  • The CSV file must be comma-delimited.
  • The first column must contain time values. Time units can be specified in parentheses; otherwise, seconds are used. Supported time units are ns, µs, ms, s, min, h, d, mo, y. 
  • Other column headers must have property paths specified in dot notation, such as engine.valveTrain.speed. Unrecognized columns are ignored.

You must load the CSV export file to be able to use the Results Player. You can load the CSV export file either manually or automatically after simulation terminates.


Info

You can drag and drop the CSV file from the file system on the Result Player. Also, you can drag and drop the CSV file from the Containment tree on the Result Player and the composite diagram.

To load the CSV export file manually

Click on the Load File command in the Results Player.
Image Removed
In the Open dialog, select the CSV file and click Open.
Image Removed

To load a CSV export file automatically when a simulation terminates.


  1. In the Specification of CSV export dialog, set the Load in Player property to true.



Info

SysML properties are mapped to CSV file headers depending on the diagram where the file is loaded. For example, if the file has information on a System, then it must be loaded in a diagram displaying the System structure. It cannot be loaded in other level diagrams (such as Controller or Water Tank). 

Block Definition Diagram showing System, Controller and Water Tank. 

Generating a Time Series Chart

You can generate a Time Series Chart with help of Results Player. To learn more, refer Time Series Chart.

To generate a Time Series Chart

  • Click Image Removed icon present on the Result Player.
  • From the contextual menu, select the required values and click OK.
    Image Removed
    The generated Time Series Chart is displayed for the selected values. You can also, change/update the values by clicking Image Removed icon in the Time Series Chart. Also, 
    Image Removed

    Understanding the UI components of the Results Player


    The following table explains the UI components of the Results Player:

    IconNameDescription

    Image Added

    Load/Unload File 

    Selects a CSV export file to load/Deselects the CSV export file.

    Image Added

    BeginningStops the play and jumps to the first step.

    Image Added

    Step BackwardJumps to the previous step.

    Image Added

    PlayStarts automatic playback of time values in real-time.

    Image Added

    Step Forward Jumps to the next step.

    Image Added

    EndStops the play and jumps to the last step.

    Image Added

    Playback speedControls the playback speed.

    Image Added

    SliderDisplays the current position and allows you to manually scroll through the values.

    Image Added

    Time indicatorShows the current step and allows you to manually enter the desired time value.
    Time Series Chart
    Generating an Instance