Data file settings

In this window you select the options related to the file from which LiveGraph will read its data.

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.

Data file

This option specifies the name of the data file. Click the button "Open…" and select the file with the data you want to plot. Note that the selected file must conform to the LiveGraph file format. After you have selected the file, there might be a slight delay while the file is being opened.

The LiveGraph file format is compatible with common CSV files, so you can select any CSV file here. Note, however, that the LiveGraph format specifies that the first data line contains column headings. So, if you attempt to load a non-LiveGraph CSV file, the very first data-set might not be displayed correctly. To avoid this problem add an empty data line at the beginning of the CSV file (i.e. a line containing only value delimiters; the number of the value delimiters must be N-1, where N is the number of data columns (data series) in the file).

Show all data

If this option is selected, LiveGraph will plot each data series complete: from the beginning to the end of the data file. This means that each plotted series will start with its first value as specified in the data file. Note that because the screen resolution and the desktop size are limited, not every data point can be explicitly plotted in a long data series. In the version 1.1 LiveGraph samples not more than 500 data points from each data series. It is always ensured that the sampling points are uniformly distributed along each data series (i.e. they are sampled as equal intervals).

The value 500 was chosen because a larger setting would not achieve any noticeable improvement on modern screens, but it would cause overlapping artifacts on older screen. If this default setting is not appropriate for your purposes, please contact us via the request-forum and we will add a mechanism to adjust this setting to one of the next versions.

Show tail data

This option is useful when only the most resent data points are of interest. When this option is active, LiveGraph shows only the end of the data series. In the LiveGraph version 1.1 the last 500 data point of each series will be sampled under this setting.

The value 500 was chosen because a larger setting would not achieve any noticeable improvement on modern screens, but it would cause overlapping artifacts on older screen. If this default setting is not appropriate for your purposes, please contact us via the request-forum and we will add a mechanism to adjust this setting to one of the next versions.

Do not cache data

If this option is active LiveGraph, does not cache the contents of the data file in memory. This can lead to significant performance losses during data updates. However, this can be useful when updates are very rare.

This option prevents LiveGraph from keeping the data file stream constantly open, which might be disturbing if you want to modify or delete the file between the updates. If you have modified the contents of the data file and you want LiveGraph to reload the whole file, you need to make sure that this option is selected.

Update frequency

Use this slider to tell LiveGraph how often it should read from the data file to see whether it was changed. Values between 1 second and 1 hour are possible. During each update LiveGraph will update the plots using the most recent data it finds in the data file.

If you shift this slider to the very right, LiveGraph will not perform any updates automatically. You can use the "Update now"- button to perform a manual update at any time.

If you feel that the provided range is not sufficient, contact us via the request-forum and we will widen the range in the next release.

File info

In this field LiveGraph will display the file description annotations it finds in the data stream.