Graph settings

In this window you can control the style and the layout of the plot.

This manual refers to LiveGraph version 1.1.X.
While version 2.0.X is similar in general, there are several key improvements.
We are working on the manual for version 2.0.X. and will make it available as soon as possible.

Highlight data points

This is a hidden setting. When you move the mouse over the plot window, LiveGraph paints small circles around the data points in the vicinity of the mouse cursor. This is called data point highlighting. At the same time as points are highlighted in the plot window, the rows corresponding to the data series on which the points are highlighted are also highlighted in the data series settings window. In addition, when you press the left mouse button while the mouse cursor is over the plotter area, a small pop-up window will be displayed with a list of all data series on which points are highlighted at that moment. This feature helps you read the graph when there are many series plotted together.

This feature uses functionality available in Java version 1.6 and later. If you are using Java 1.5 this feature may not be available or it may cause error messages being displayed in the main window.
In addition, this feature is unfortunately relatively computationally expensive. Despite various optimisations employed, locating the points in the vicinity of the mouse cursor is a computationally expensive task. For modern desktop PCs this does not present any real challenge you will hardly notice the calculations. However, if you are using an older computer, the extra load on the processor may be annoying and you might want to switch data points highlighting off.

Because the reasons for turning data point highlighting off are of such permanent nature and do not quickly go, we did not include an option for turning this feature on and off in the user interface (after all, a concise interface is one of LiveGraph's hallmarks). However, you can still change this setting by editing the graph settings file:
First, save your current graph settings using the menu in the main application window. Then, open the .lggs file where you just saved the settings with your favourite text editor. Find the entry with the key "HighlightDataPoints" and change its value from 1 to 0; save the file. Now you can load you LiveGraph graph settings from the modified file and the data point highlighting will be disabled. If you want to switch the feature back on, reverse the procedure.

Viewport

Here you can select the visible data area for the plot. For instance, if you select minX = 0 and maxX = 20, LiveGraph will plot all data points for which the X-coordinate value is between 0 and 20. Similarly, setting minY = y' and maxY = y'' results in only the points with the Y-coordinate value y being plotted such that y'yy''. If you select auto, LiveGraph will automatically find the smallest (or largest) values available. So, if you set all four boundaries to auto, you will be able to see the complete graph.

Note, in order to apply the changes after you have edited a value in one of the fields, you need to press the Enter-key or to move the cursor out of the field by clicking on any other field or button in the graph settings window.

Vertical grid

Here you specify whether and how a vertical data grid should be drawn in order to make the reading of the graph easier.

"Do not display a grid" switches the grid off.

"Grid aligned on dataset indices" will show a grid aligned on dataset indices. For example, if you choose grid size to be 10, you will see a vertical line every 10 data sets. Note that if you choose a data series for the X-axis (see below), it might be the case that the X-coordinates do not correspond to the dataset indices. In such case the vertical grid lines will be spaced at different intervals from one another.

"Grid aligned on X-axis units" aligns the grid according to the X-axis. This way the grid lines will always be equi-spaced. For instance, if you choose this option and set the grid size to 100, a vertical grid line will be shown every 100 units along the X-axis.

"Grid size" specifies the intervals at which vertical grid linen should be drawn. A value S here will cause a grid line to be drawn every S units (or datasets, depending on the above option).
Note that a grid is not of much use if the distance between the grid lines is less than a pixel. LiveGraph will help you by adjusting your settings in case they would cause the grid lines to be too close to each other.

"Grid colour" specifies the colour to use for the vertical grid lines.

Horizontal grid

Here you specify whether and how a horizontal data grid should be drawn in order to make the reading of the graph easier.

"Do not display a grid" switches the grid off.

"Display a horizontal grid" will cause the grid to be drawn.

"Grid size" specifies the intervals at which horizontal grid lines should be drawn. A value S here will cause a grid line to be drawn every S units along the Y-axis.
Note that a grid is not of much use if the distance between the grid lines is less than a pixel. LiveGraph will help you by adjusting your settings in case they would cause the grid lines to be too close to each other.

"Grid colour" specifies the colour to use for the horizontal grid lines.

X axis

Here you configure the x-axis of the plot.

If "Use dataset number" is selected, all data series will be plotted against the dataset numbers. This means that for each data point, the Y-coordinate value will be its data value and the X-coordinate value will be the index of the corresponding dataset in the original data file (i.e. the row number of the data point in the file).

If "Use data series" is selected, all data will be plotted against the data series specified in the drop-down box "Series". This means that for each data point, the Y-coordinate will be its data value and the X-coordinate will be the data value of the specified series from the same dataset.

The option "Use data series transformed into [0...1]" is similar to the option "Use data series", only the X-coordinates are additionally transformed into the interval [0…1] such that the smallest value in the data series specified to act as the X-axis is mapped to 0, the largest value is mapped to 1 and all other values are linearly mapped to the values in-between. This means that for each data point, the Y-coordinate will be its data value and the X-coordinate will be the value x’ = fx + s, where x is the data value of the specified series from the same dataset, and f and s are such that min( x’ ) = 0 and max( x’ ) = 1.

The option "Use data series scaled by set value" is similar to the option "Use data series", only the X-coordinates are additionally scaled by the value specified in the field "Value". This means that for each data point, the Y-coordinate will be its data value x’ = fx, where x is the data value of the specified series from the same dataset, and f is the value specified in the field "Value".

The drop-down selector "Series" lets you specify the data series to use as the X-axis if one of the options "Use data series", "Use data series transformed into [0...1]" or "Use data series scaled by set value" is selected.

The field "Value" lets you specify the scale value which is used when the option "Use data series scaled by set value" is selected.
Note, in order to apply the changes after you have edited a value in this field, you need to press the Enter-key or to move the cursor out of the field by clicking on any other field or button in the graph settings window.