Crunch v 0.9.3 (c) Aardvark Racing 2010

The Crunch utility can be used to amalgamate several Wide Band
Commander log files into a single matrix to be used as a surface plot.

First, capture your data from the WBC via the USB interface.

Then use the WBC utility to export the data to a series of text files.

If your response to the preceding is "Huh?", then stop reading this,
step away from the laptop, find someone with a clue and make them some
tea.

Ok, at this point you have a bunch of exported text files containing
WBC data. For this example, imagine you've produced data1.txt and
data2.txt.

Now you need to copy "crunch.exe" into a directory somewhere on your
$PATH. Now open a command prompt window.

To start off, you'll want to produce a small, low resolution matrix
that you can suck into Excel to see that everything's working.

For example...

C:\> crunch -a -w -x2 -t10 -r500 -z8 -omydata.csv data1.txt data2.txt

Crunch will then read 'data1.txt' and 'data2.txt' (these produced by
the WBC) and create 'small.csv' using the other parameters as follows.

'-a' tells Crunch to average the data from data1.txt and
data2.txt. I.e., if both files contain a data point for 10% throttle
at 1500 revs, data1.txt being 12 and data2.txt being 14, the value that
will end up in small.csv will be 13. If you *don't* specify '-a', the
values from data2.txt will overwrite the values from data1.txt (by
order of appearance in the command line) and the value in small.csv
will therefore be 14. Note this process takes place *after* the
throttle/rev step averaging... Simples! *meep*.

'-w' tells Crunch not to print any warnings (such as finding a data
point with over 100% throttle).

'-x2' tells Crunch to try to launch the output file after the data is
analysed. For example, if you're running on Windows, and you've named
the output file with an extension of '.csv' and .csv files are
associated with Excel, then Excel should start with the output already
loaded. '-x1' will try to start Excel directly with the output file as
a parameter; excel.exe must be in your search path in this case.

'-t10' tells Crunch to use steps of 10% increments for the throttle
position axis. The higher this number is, the coarser the end result
in small.csv will be. See the following paragraph for a full
explanation!

'-r500' tells Crunch to use steps of 500 revs for the revs axis. Now,
the WBC has a tendency to spit out info a VERY fine increments, so you
have the possibility to capture an enormous amount of info and create
very detailed graphs. However, depending on the graphing package
you're using (I'm guessing you and half the world will be using Excel)
you'll very quickly run into limitations in the graphing package. So,
you can greatly reduce the number of data points to keep Excel or
whatever happy, and play around with the resolution of throttle
position to revs until you get a good picture of the info you want. In
addition, the value that will be dropped into small.csv is the average
of all the valid, populated data points in the given range of throttle
and rev increments.

'-z8' sets the value that will be written when Crunch encounters a
data point that has not been populated by the input data.

'-omydata.csv' tells Crunch to write the final data to the file
'mydata.csv'.

So you've typed all that in, and hit 'enter. Crunch will now read all
the data files you've specified. For each input file it will average
the data for all the points in each throttle/rev step range and store
the averaged value in its internal matrix, the final value being the
average of all the calculated averages from all the input files. Got
that?

Once all the input processing is done, the final data will be written
as comma separated values to the specified output file. If you're
lucky the auto launch will work and Excel will leap into life with
your data already loaded... otherwise start Excel from the desktop and
import your data in the normal way.

Then you can select the data, insert a surface chart and wahey!!
you're looking at a nice coloured surface plot of all your hard won
Wide Band Commander data.

Now, once you've spotted the problem areas on the graph, you can
adjust the mapping in your fuel injection system and... go out and win
some races!!
















