Histogram Display



Histogram Display

Whenever the histogram window is open, it will update. The histogram window will not be updated in the background if you do not have it open. If you wish to view the histogram of a portion of your log file or a certain instance in your road scanning, open the histogram window at the time you would like it to start updating. Every time the histogram window is opened it starts fresh and blank.

You can also right click the histogram for more options.


Hotkeys:

Keypad 1-0 Cycle through the histograms
PGUP/PGDWN Cycle through the histograms
CNTRL+C Copy histogram cells to clipboard


How to Support an Unsupported Histogram

To support an unsupported histogram you will have to enter the PIDs the histogram requires in the table display. It is a good idea to define as many of your histograms as possible to generic sensors instead of more specific PIDs. Not every vehicle uses the same PID set. For example, vehicle A may use Timing Advance PID 1 where as Vehicle B may use Timing Advance PID 2. If you define a histogram against Timing Advance PID 1 and connect to Vehicle B, your histogram will not work. If you define your histogram against the generic sensor Timing Advance, as long as the vehicle you connect to supports any Timing Advance PID (and you insert that specific PID into the table display), your gauge will be supported. The most noticeable application for using Sensors for definition is when you switch between vehicle platforms.

If your histogram displays but is stuck on the first row or column of the table, it means you do not have the proper PID loaded in the table display to support that axis. The histogram window needs the PIDs required for the axis' to be loaded in the table display as well to determine the row and column of the current frame.


Toolbar

Load a histogram from a file.
Save the current histogram to file.
Print the current histogram.
Load all default histograms
Show histogram 1 through 10. You can also use the Page Up/Page Down keys as well as the 1-0 numbers on the keypad.
Configure the histogram.
Show the highest value in each histogram cell.
Show the lowest value in each histogram cell.
Show the average value of each histogram cell. This is the most commonly used setting.
Show the last value of each histogram cell.
Show the hit count for each histogram cell.
When this button is pressed, the histogram table will take up as much space on the Histogram Display form as possible, overlapping the horizontal and vertical labels. If you have limited desktop space, this may be a useful item.




When making changes to the histogram configuration page, there is no undo action. Changes you make will be put into effect the next time you open up the Histogram Display window, or if you already have it open, if you hit the Save icon.

The Histogram Configuration form gives you a lot of control over how you configure your histograms.


Plot Value

The plot value is the actual value that is going to be displayed in each cell of the histogram. You can plot against a specific PID or a more generic sensor. Try to chose a sensor over a PID whenever possible.


Plot Filtering

With plot filtering you are able to get the most control out of your histogram data. You can filter out data based on TPS, RPM, fuel trim cell and other various parameters. You can also enter in the minimum number of cell hits required to register data on the histogram. Entering in a higher value in the min cell count will help remove erroneous data or cells that do not have enough data for accurate feedback. If you enter in a plot filter string, the filter string must pass as true for the frame to be added to the histogram. First the histogram will check to see if the plot filter string returns true (if one exists). If the filter returns true the data is added to the histogram. If the cell count is under the min cell count it will not be displayed. For more information on how to setup filters please read Custom Functions, Filters and Triggers.

When plot filtering is present on a histogram, the Histogram Display tool bar will indicate it with a small red star in the lower right corner like such:


Plot Coloring

You determine the color swing of the histogram by using the Value Low, Value Mid, Value High and Color Low and Color High. The Color Low will be used as an absolute for all the values that are equal to or below your Value Low setting. The Color High will be used as an absolute for all values that are equal to or above the Value High setting. The Value Mid sets the middle swing point which is the value that will be the 50/50 color between Color Low and Color High. You can set the Value Mid to be perfectly in-between Value Low and Value High to have a perfectly even histogram or move it toward Value Low or Value High to have a more color biased histogram.


X Header (Horizontal Axis)   & Y Header (Vertical Axis)

Configuring the Axis may look confusing at first but once you understand the underlying structure of it, it should become a lot more clear and a lot more powerful.

There are basically 2 types of Axis configurations you can have.


Toolbar

Import settings from file.
Export settings to file. Use this to share your settings with others.
Commit any changes made and refresh the parent Histogram Display window.
Undo any changes made.
Load all default histograms.