Graph properties

The graph properties are part of the scene object properties dialog, which is located at [Menu bar --> Tools --> Scene object properties]. You can also open the dialog with a double-click on an object icon in the scene hierarchy, or with a click on its toolbar button:

[Scene object properties toolbar button]

In the scene object properties dialog, click the Graph button to display the graph dialog (the Graph button only appears if the last selection is a graph). The dialog displays the settings and parameters of the last selected graph. If more than one graph is selected, then some parameters can be copied from the last selected graph to the other selected graphs (Apply to selection-buttons):

[Graph dialog]

  • Explicit handling: indicates whether the graph should be explicitly handled. If checked, the graph will not be handled when sim.handleGraph(sim.handle_all_except_explicit) is called, but only if sim.handleGraph(sim.handle_all) or sim.handleGraph(graphHandle) is called. This is useful if the user wishes to handle the graph in a child script rather than in the main script (if not checked the graph will be handled twice, once when sim.handleGraph(sim.handle_all_except_explicit) is called in the main script, and once when sim.handleGraph(graphHandle) is called in the child script). Refer also to the section on explicit and non-explicit calls.
  • Object size: size of the graph object. This parameter has no functional effect (i.e. the recorded 3D curves won't be scaled, only the XYZ-planes will).
  • Buffer is cyclic: when selected and the number of elements in each data stream reached the buffer size, then the first elements will be erased in order to be able to record new elements. Otherwise recording stops when the buffer is full.
  • Buffer size: number of elements each data streams can record.
  • Display XYZ planes: turns on and off the display of a graph's XYZ-planes in the scene view.
  • Remove all static streams/curves: clears all static data streams or curves. A static data stream or curve is a "frozen" data stream or curve, that won't change during simulation.
  • Adjust background color: allows adjusting the background color in the time graph or x/y graph view.
  • Adjust grid color: allows adjusting the grid and graduation color in the time graph or x/y graph view.
  • Add new data stream to record: allows selecting a new data stream type and object to record. See the section on data stream types for more details.
  • Data stream recording list: the list displays all data streams that will be recorded. The name of individual data streams, that can be edited, will be displayed as labels in the time graph view.
  • Data transformations: determines how the selected data stream is transformed. Raw uses the original data stream, Derivative uses the time derivative of the data stream (e.g. if the raw data stream is the position of an object, then data will be its velocity), Integral uses the time integral of the data stream (e.g. if the raw data is the velocity of an object, then data will be its position) and Cumulative uses the cumulative value of the data stream. Additionally, the data can be scaled, shifted, and a moving average period specified.
  • Visible: determines whether the selected data stream will be visible in the time graph.
  • Show label: determines whether the selected data stream will be labeled in the time graph.
  • Link points: determines whether the selected data stream individual values (or elements) will be linked and displayed as a line in the time graph.
  • Adjust curve color: allows adjusting the color of the selected data stream, as displayed in the time graph.
  • Duplicate curve to static: when a data stream is selected, clicking this button will duplicate the data stream as a static stream. Static streams or curves (displayed as stippled lines) are not modified or cleared when a new simulation is started and are used to compare results from one simulation run to another. Data streams or curves can also be made static by selecting them in a graph view (except for floating views) then clicking [Popup menu --> Add --> Static duplicate of curve]. Static streams or curves can be cleared with the remove all static streams/curves button.
  • Edit XY graphs: allows editing XY graphs. Refer to the XY graph / 3D curve dialog.
  • Edit 3D curves: allows editing 3D curves. Refer to the XY graph / 3D curve dialog.

  • Recommended topics

  • Graphs
  • Graph data stream types
  • XY graph and 3D curve dialog