The Results Player by reading the CSV file allows you to check the simulation values, review specific time events, and display results of external simulation for example SSP export. Results player can be opened for composite structure diagrams which include but limited to IBD diagrams, Parametric diagrams, etc.
Opening Results Player
To open 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
CSV export files can be loaded both manually or automatically.
To load the CSV export file manually
- Click on the Load File command in the Results Player.
- In the Open dialog, select the CSV export file.
Prerequisite
- The CSV export file must be a comma-delimited CSV export file.
- The first column must contain time values (time units can be specified in parenthesis, 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. For example "engine.valveTrain.speed".
To load the CSV export file automatically
- In the Specification of CSV export dialog, set the Load in Player property to true. To learn more, refer to CSV export page.
Results Player UI
We need to explain all buttons and their functionality:
- Load/Unload File - Select a file to load with the context of the current diagram.
- Beginning - stops Play and jumps to the first step
- Step Backward - jumps to the previous step
- Play - starts automatic playback of time values in real-time
- Step Forward - jumps to the next step
- End - stops Play and jumps to the last step
- Playback speed - 1 plays file in real-time. Playback can be sped up or slowed down depending on user needs (eg 2 means 2x faster playback and 0.5 2x slower playback).
- Slider - used to display current position and to manually scroll through values
- Time indicator - shows the current step and can be used to manually enter the desired time value
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 "System", then it must be loaded in a diagram displaying the system structure. It cannot be loaded in other level diagrams (like Controller or Water Tank). A screenshot could be attached showing the SysML structure tree with a line drawn to the CSV header (showing both the CSV file structure and how it maps to the SysML model).
- A new property needs to be added to the CSV export page "Load in Player" and briefly explained: CSV export - Cameo Simulation Toolkit 2024x - No Magic Documentation