DIYEFI.org Forum

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:

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
Zoom in - coarse adjustment
Reset zoom ratio - Resets the zoom ratio to 1:1
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.
Zoom out - coarse adjustment

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

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

Open file - looks like an eject button
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

*reserved*

*reserved*

*reserved*

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.

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.

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. =/

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.