Graphs

Graphs are objects that can be used to record, visualize or export data from a simulation. They are very powerful and flexible. The user can select from a multitude of data types applied to specific objects to record. Data is recorded as a data stream (sequential list of data values) that can be visualized in three different ways:

  • Time graphs: a time graph of a single data stream (time vs data stream).
  • X/Y graphs: a graph that combines two data streams (data stream A vs data stream B).
  • 3D curves: a 3D graph that combines three data streams in time (time vs (data stream A, data stream B, data stream C)).
  • Following figure illustrates the graph functionality:

    [Examples of graph applications (1) time graph, (2) 3D graph, and (3) corresponding x/y graph]


    As are cameras and vision sensors, a graph is a viewable object, which means that you can look at its image content which can be a time graph or an x/y graph (time graphs and x/y graphs are not directly visible in the scene; the graph first has to be associated with a view). See the pages and views section for more details on how to look at a graph. A graph is added to the scene with [Menu bar --> Add --> Graph]. What you see is the three dimensional representation of the graph. If a 3D curve was defined for that graph, that curve is directly visible as can be seen in following figure:

    [A graph object]


    Data streams recorded by a graph can be exported to a *.csv file (Comma Separated Values) that can easily be imported by various applications (e.g. Excel). In the scene, select the graphs you want to export the data from, and select [Menu bar --> File --> Export --> Selected graphs as CSV...]. The unit of exported data streams will be in meters, kilograms, seconds and degrees (or a combination of those). Individual graph curves can also be copied to the clipboard for pasting into applications like Excel for instance: in a graph view (make sure the view is not a floating view, or double-click it to swap it with a regular view), hover over the curve you wish to copy until it gets highlighted, then select [Popup menu --> Add --> Curve to clipboard].

    The graph functionality also allows to easily comparing curves from one simulation to another; to this end, curves can be duplicated to static curves: static curves are then displayed in stippled form in time graph views, x/y graph views or as 3D curves in the scene view, and won't be actualized or modified when another simulation is started. Hover over the curve you wish to duplicate as static curve until it gets highlighted (make sure the view is not a floating view, or double-click it to swap it with a regular view), then select [Popup menu --> Add --> Static duplicate of curve]. You can also duplicate curves to static curves in the graph properties (where static curves can also be removed).


    Recommended topics

  • Related API functions
  • Graph properties
  • Graph data stream types
  • Viewable objects
  • Pages and views