OpenLogViewer User Manual

OpenLogViewer is a cross-platform data log viewing application originally written by Gufi and new developed and maintained by Ben and Fred. Discuss all things OLV here!
Post Reply
User avatar
BenFenner
LQFP144 - On Top Of The Game
Posts: 360
Joined: Wed Jul 09, 2008 3:15 pm

OpenLogViewer User Manual

Post by BenFenner »

Introduction:

OpenLogViewer is a free, open source, cross-platform data-log visualization application that currently supports many CSV data-log formats (including MegaSquirt style), and FreeEMS binary data-logs. OpenLogViewer is currently in its infancy. While in the future it will be amazing, right now it has all of the basics that you need.



Getting Started:

Acquiring OpenLogViewer:

The Application (recommended for all)
In the future there will be executable releases clearly marked for your operating system on the OLV web site to download. However, for now, get the latest development build here: http://builds.freeems.org/openlogviewer/bins/

After downloading the appropriate version of the application, skip to the "Installation From Binaries" step.

The Source Code (recommended for developers only)
Download the source code from the OLV web site: http://olv.diyefi.org/
If you are downloading the source code to build (which should be entirely unnecessary as this site contains the latest builds from source), continue to the "Building and Running From Source" step.
If you downloaded the source just to view it, then you're finished.



Building and Running From Source:

Follow these directions: viewtopic.php?f=32&t=1046



Installation From Binaries:

Executable Jar (Java)

Standalone DMG (Mac OSX)

Debian/Ubuntu

Standalone EXE (Windows)

Zip With Script



Opening a File / Loading a Data-log:
Last edited by BenFenner on Thu Nov 15, 2012 8:31 pm, edited 22 times in total.
User avatar
BenFenner
LQFP144 - On Top Of The Game
Posts: 360
Joined: Wed Jul 09, 2008 3:15 pm

Re: OpenLogViewer User Manual

Post by BenFenner »

Using OpenLogViewer:

Navigating a Data-log:

Keyboard Navigation
  • Go to the beginning of the graph
    • Home
  • Decrease the graph position
    • (left arrow) - fine adjustment, hold for acceleration
    • Ctrl (hold Ctrl and press left arrow) - coarse adjustment
    • Page Up - coarse adjustment
  • Increase the graph position
    • (right arrow) - fine adjustment, hold for acceleration
    • Ctrl (hold Ctrl and press right arrow) - coarse adjustment
    • Page Down - coarse adjustment
  • Go to the end of the graph
    • End
  • Zoom in - coarse adjustment
    • (up arrow)
    • Ctrl + (hold Ctrl and press plus)
    • Ctrl = (hold Ctrl and press equals)
  • Zoom out - coarse adjustment
    • (down arrow)
    • Ctrl - (hold Ctrl and press hyphen)
    • Ctrl − (hold Ctrl and press subtract/minus)
  • Toggle playing the graph - playing will move the graph position forward automatically at a configurable rate
    • Space Bar
Mouse/Pointer Navigation
  • Move to a specific graph location
    • Single Left Click - centers the graph on the location you've clicked
    • Left Click Drag - inertia applies, if the graph is playing it will pause during the drag
  • Zoom in - pointer centered, coarse adjustment
    • Mouse Wheel Forward
  • Zoom out - pointer centered, coarse adjustment
    • Mouse Wheel Backward
On-Screen Button Navigation
Image Zoom in - coarse adjustment
Image Reset zoom ratio - Resets the zoom ratio to 1:1
Image Reset zoom fit - Resets the zoom factor to allow the entire graph to fit within the current display, this can include fine zoom adjustments. Use this followed by the 'move to center' button to reproduce the conditions seen when a log is first loaded.
Image Zoom out - coarse adjustment

Image Slow playback rate - Decreases the playback rate, looks like a turtle
Image Reset playback rate - Resets the playback rate to the original, set rate
Image/Image Play/Pause - Toggle button used to play or pause the playback of the graph
Image Speed up playback rate - Increases the playback rate, looks like a rabbit

Image Move to beginning
Image Move backward - coarse adjustment
Image Move backward - fine adjustment
Image Move to center
Image Move forward - fine adjustment
Image Move forward - coarse adjustment
Image Move to end

Image Open file - looks like an eject button
Image Open last - This will open the last file you've successfully loaded in the past

Menu Navigation
This does not exist yet but is planned for the near future. The menus will also have keyboard shortcuts listed as expected.


Special Controls:
  • Shift - Hold down to lock the trace data hover display (allows the trace data hover display to stay visible and stationary while you move the mouse pointer, including leaving the application window)


Configuring the Graph Traces:

Set Trace Colors

Set Trace Display Min/Max



Configuring the OLV View Settings:

Full Screen Mode

Full screen mode may provide enhanced video performance on certain systems.
When exiting full screen mode the application should revert back to the same position, size, and maximization state in windowed mode that it had before entering full screen.
  • Enter full screen mode
    • Alt Enter (hold Alt and press Enter)
  • Toggle full screen mode
    • F11
  • Exit full screen mode
    • Esc
Last edited by BenFenner on Thu Nov 15, 2012 8:41 pm, edited 46 times in total.
User avatar
BenFenner
LQFP144 - On Top Of The Game
Posts: 360
Joined: Wed Jul 09, 2008 3:15 pm

Re: OpenLogViewer User Manual

Post by BenFenner »

*reserved*
Last edited by BenFenner on Wed Nov 14, 2012 5:40 pm, edited 5 times in total.
User avatar
BenFenner
LQFP144 - On Top Of The Game
Posts: 360
Joined: Wed Jul 09, 2008 3:15 pm

Re: OpenLogViewer User Manual

Post by BenFenner »

*reserved*
User avatar
BenFenner
LQFP144 - On Top Of The Game
Posts: 360
Joined: Wed Jul 09, 2008 3:15 pm

Re: OpenLogViewer User Manual

Post by BenFenner »

*reserved*
User avatar
BenFenner
LQFP144 - On Top Of The Game
Posts: 360
Joined: Wed Jul 09, 2008 3:15 pm

Re: OpenLogViewer User Manual

Post by BenFenner »

The important navigation info is up and the rest is sort of roughed in. This will get better and more details everywhere as time and desire permit.
Impregacy
QFP80 - Contributor
Posts: 67
Joined: Fri Feb 26, 2010 12:15 am

Re: OpenLogViewer User Manual

Post by Impregacy »

I got stuck trying to look at my first log as a noob, going to drop this little nugget in here:

Drag the light grey variables of interest into the dark grey box. The dark grey box looks like it is labeled "Remove," but that is a remove button in case you want to empty the variable box.
User avatar
BenFenner
LQFP144 - On Top Of The Game
Posts: 360
Joined: Wed Jul 09, 2008 3:15 pm

Re: OpenLogViewer User Manual

Post by BenFenner »

I'm sorry you had trouble with that part of the user interface. That interface was supposed to be replaced a long time ago, which is why it never got put into this manual. I still hold out hope that one day I will be able to resume work on OLV, but it doesn't look like it will happen any time soon due mainly to priority time constraints. =/
Last edited by BenFenner on Fri Mar 28, 2014 9:42 pm, edited 1 time in total.
Impregacy
QFP80 - Contributor
Posts: 67
Joined: Fri Feb 26, 2010 12:15 am

Re: OpenLogViewer User Manual

Post by Impregacy »

Oh no problem, just dropping that here for noobs like myself who look at it for the first time and scratch their heads.

But for how much I paid for this software, I would expect perfect documentation ;) JKJK --it is working great and very useful --thank you.
Post Reply