User manual

On these pages we provide help on using the LiveGraph data plotter and analysis application. If you are interested in using the plotter with your own software you should read the developer manual. If you have read these pages and still have unanswered questions, please get in touch with us via the forums on the LiveGraph project page on SourceForge.

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.

Installation

Download the distribution you need from the download page. You will normally obtain a ZIP archive. Unpack the archive using your favourite tool to a directory of your preference on your system. LiveGraph does not require any installation, so you are now ready to go.

Java

Please note that LiveGraph is a Java application and it requires the Java Runtime Environment in order to function. LiveGraph requires Java 6 or later to run (running LiveGraph with Java 5 may work, however, this is not officially supported and not all functions will be available). You can download the latest version of Java from Sun.

Starting LiveGraph

After you unpack the distribution archive you will see a few files including a file called LiveGraph.1.1.Complete.jar or something very similar. (The exact name of the .jar file may vary depending on your distribution; without loss of generality we will refer to the file as LiveGraph.jar below; you need to adjust the name for your distribution.)
On most MS Windows and on many Linux systems you can just double-click the file LiveGraph.jar in order to start LiveGraph.

If you wish, you can create a link or a shortcut for LiveGraph in your start menu folder or on your desktop. Use the LiveGraph icon (file LiveGraph.ico in your distribution) for this purpose.

For other operating systems, or if you want to use any command line parameters, you need to start LiveGraph from the command line.
For this, start the terminal window appropriate for your operating system and change into the directory where you unpacked LiveGraph. In order to start LiveGraph, type

       > java –jar LiveGraph.jar

If you would like to pass any command line parameters, add them at the end. For example:

       > java –jar LiveGraph.jar –dfs myFileSetts.lgdfs

LiveGraph expects 0, 2, 4 or 6 additional command line parameters. The syntax is the following:

       > java –jar LiveGraph.jar [-dfs "{data file settings file}"]
                                 [-gs "{graph settings file}"]
                                 [-dss "{data series settings file}"]

For example:

       > java –jar LiveGraph.jar -dfs myDataFileSetts.lgdfs -gs myGraphSetts.lggs
                                                            -dss myDataSeriesSetts.lgdss

After you started LiveGraph five GUI windows will appear.

Using LiveGraph

In this section we describe LiveGraph’s graphical user interface (GUI). LiveGraph has 5 windows:

LiveGraph plotter GUI (click to enlarge)
Fig. 1: LiveGraph GUI - The three settings and
the plot window (main window not depicted)

Click image to enlarge

The main window is used to access other windows and to present information messages to the user It can also be used for exporting the plots to image files.

The data file settings window is used for options related to the data file from which LiveGraph will read the data.

The graph settings window is used for options which define how the data plot should be presented.

The data series settings window is used for controlling the display of each data column of the data file.

Finally, the plot window is used to display the graphs on the screen.

Detailed information on the various settings can be found in the subsections on the corresponding GUI window.