CDP Studio - Analyze Mode Manual
Introduction to Analyze Mode
Control systems run functions in parallel and functions can be distributed over different applications running on different hardware units.
The Analyze mode allows you to plot any value in the system in real-time across all functions (components and operators) and applications regardless of the hardware distribution.
This enables a system-wide overview and analysis of the system. Being able to see value changes in relation to each other in real-time is paramount when testing and fault finding for developers and service engineers.
Several values can be plotted in a single graph and in multiple graph windows.
There is a seamless integration of real-time and historical data and historical data can be plotted off-line.
The plot setup and configuration are automatically stored with the project and reloaded for ease of use.
Overview of nice to know functions
Feature | Description |
---|---|
Autofit x-axis | Action button “<->” autofits the x-axis for multi-variable plots |
Autofit y-axis | Action button “vertical line” to Autofit the y-axis |
Precise axis scaling | Click on the maximum number and type the new max value (x-axis: seconds, hh:mm:ss.ms or use units) |
Quick zoom | Select the axis and use the mouse scroll wheel (default x-axis) |
Box zoom | Ctrl-left click and drag |
Undo zoom | Right-click |
Alias names in legend | Right-click on legend name and select "Set Alias…" |
Pan plot | Left-click and drag (pause plot is automatically enabled) |
Rename plot title | Click on title name |
Rename Tabs | Double-click on tab name |
Undock graph | Click-drag-drop the graph tab |
Specific plot configurations can be saved and loaded; plot data can be saved to CSV format and loaded to view historical data or view offline.
Analyze Mode
The Analyze mode consists of a Graph view, a Project tree and a Resource tree. The Graph view can contain several Graph pages. Graph pages can be detached from graphview and opened in separate windows.
In Analyze mode you can plot any resource value in your system. To see realtime values, the system must be running and connected to CDP Studio. When offline, you are still able to set up the graphs, but the values won't update until you are connected to the system.
Each Graph consists of a Legend and a Plot area. The Legend shows the value name and its corresponding plot colour. The Graph visualizes the values in a given time window. Each Graph has autoscale, pause/resume and close action buttons.
Adding Items to Graph
The items to plot can be selected from the Configure mode or Analyze mode.
To add an item from Configure mode:
- Open Configure mode
- Navigate to the item in the Block Diagram or Table Editor
- Right-click on the item and select “Add to plot...”->”<tab name>”->”<Plot title>” (e.g. “Add to plot->Tab1->Untitled”)
To add an item from Analyze mode:
- Open Analyze mode
- Select a component from Project tree to analyze
- Right click on a value from Resource tree
- Select Add to Plot... from the context menu
To add multiple items to a Graph:
- Open Analyze mode
- Select a component from Project tree to analyze
- Select multiple resources while holding down Ctrl or Shift key
- Drag resources into the Graph and
- drop them.
Altering Items in a Legend
To remove the resource from the Graph:
- right-click on the resource name in the Legend
- select "Remove"
Each item can also be temporarily hidden using a checkbox in front of a resource name in the legend.
An alternative text (alias) can be set to be shown in legend instead of the default name by selecting "Set Alias...". Setting an alias to empty restores the default name on the legend.
Show and Hide the Legends
The graph legends can be shown or hidden in the following way:
- Click on the options menu
- Select the Show Legend menu item:
The legend can also be toggled on or off by using the key-combination assigned to this action (default 'Ctrl+Shift+L').
Note: The Show Legend preference is stored as a global setting whenever it changes.
Undocking the Graph page
To open a Graph page in a separate windows drag and drop the tab of the Graph page out of the tabbar.
To reattach the Graph page click the "Reattach" button.
How to Scale the Axes
To scale the graph axes, use the Auto-fit x-axis and Auto-fit y-axis buttons or enter values directly, see Precise Axis Adjustment. It is also possible to use the scroll wheel on your mouse. You may first click at the x-axis and/or y-axis to select which axis to scale. Move the mouse cursor into to graph-area before using the scroll-wheel on the mouse to scroll the selected axis. If none or both axes are selected, both axes will be scaled. By right-clicking in the graph, you will undo the last scaling.
Scaling done on the x-axis (time) will affect all plots/graphs in the current Tab.
Auto-fit When Multiple Data Sources Are Available
Sometimes multiple data sources are available for plotted values. The source can be real-time data when connected to the system but also data from a logger in the system or a previously saved plot. See the Historic Data page for details about logging, saving and loading plot data.
In this case, clicking the Auto-fit x-axis button will pop up a menu asking which data source to use for scaling the horizontal axis. The Fit Current Selection will fit all data from current active data sources to the plot area. Selecting any other option will first activate this data source for all plotted values and then scale to fit all data from that source.
How to Zoom in the Graph
By holding the Ctrl-key while dragging the mouse over the wanted graph-area, you will block-zoom the marked area. This can be done several times to zoom into details. By right-clicking in the graph, you will undo the last zooming.
Note: If an axis is selected, zooming will be restricted to that axis.
Precise Axis Adjustment
The minimum and maximum values of the y-axis can be set by clicking on them: To set the maximum value for the y-axis, click on the topmost axis-value. The whole text becomes selected. Type in a new value, and hit Enter. The maximum value will now be set to what was typed in.
Similarly, selecting the bottom y-axis value makes it possible to set the minimum value.
Note: The Tab key will toggle between selecting the minimum value and the maximum value once one of them is selected.
The x-axis start-time can be set by clicking it and typing in the time in the time-format hh:mm:ss.ms. The date can be changed in a similar way; select it and type in the wanted date.
The x-axis range can also be adjusted by clicking the rightmost label and typing the wanted timespan. Values are in seconds if unit is omitted, otherwise the following units can be used:
Unit | Description | Example |
---|---|---|
ms | milliseconds | 30 ms |
s | seconds | 10 s |
min | minutes | 42 min |
h | hours | 3 h |
d | days | 4 d |
The plus sign can be omitted when inserting values. Spaces between a value and unit is ignored, so 1h and 1 h is interpreted as the same.
How to Pan the Graph
You can click and drag the graph to pan it to any direction.
When you drag the graph to the right, the graph will also automatically pause.
To resume the graph, press space or click at the resume/play button in top right corner.
Rename Tabs
Tabs can be renamed so they are easier to find. To rename a tab, either double-click the text in the tab, or right-click the tab and select 'Rename Tab' from the context-menu.
Save and Load Tab Configurations
Tab configurations can be saved and loaded from the options menu By selecting Save Configuration, all the current tab configurations can be stored to a single file. A single tab configuration can be saved by right-clicking the tab and selecting Save Tab Configuration. A previously saved tab configuration file can be loaded by clicking the options menu and selecting Load Configuration.
Extracting/Saving Data
The Analyze mode is capable of exporting data to CSV format and CDP Compact Datastore format. See the Historic Data page for details.
Viewing Historic Data
The Analyze mode is capable of showing historic data if the system contains a logger or by loading CDP Compact Datastore file. See the Historic Data page for details.
Get started with CDP Studio today
Let us help you take your great ideas and turn them into the products your customer will love.