Map Corrector

Lambda Correction Tool

User’s Guide
High Version 0.1
English version
 1 INTRODUCTION ................................................................................3

1.1 What is Map Corrector for ........................................................................ 3

1.2 The highlights of Map Corrector ............................................................. 3

2 SOFTWARE INSTALLATION ............................................................ 4

3 MAP CORRECTOR ...........................................................................8

3.1 Open new Configuration .......................................................................... 9

3.1.A Load Engine Configuration .................................................................................... 9
3.1.B Data files loading to get the Original Lambda Signal .......................................... 11
3.1.C Original Injection Correction map loading ........................................................... 13

3.2 How the correction algorithm works ..................................................... 14

3.2.A Channels mapping .............................................................................................. 15
3.2.B Math libraries ....................................................................................................... 15

4 CORRECT MAPS ............................................................................ 16

4.1 Correction results................................................................................... 16

5 MAP CORRECTOR MAIN MENU .................................................... 17

5.1 File ........................................................................................................... 17

5.2 Tools........................................................................................................ 17
5.2.A Edit Configuration Setting ................................................................................... 18
5.2.B Lambda reference type: Edit map ....................................................................... 19
5.2.C Edit the lambda delay throw the lookup table ..................................................... 20
5.2.D Channels translation ........................................................................................... 21
5.2.E Options ................................................................................................................ 22

6 APPENDIX ....................................................................................... 23

6.1 Text data files format.............................................................................. 23

6.2 Text map files format.............................................................................. 24

6.3 Import and export map files to and from DoPe .................................... 26

6.4 Modifying map values ............................................................................ 27

MapCorrector user’s guide 2/27

 1 INTRODUCTION
The Map Corrector is the application that edits injection maps values to adapt the engine behavior, in
order to reach a desired carburation target. It is given to the program in form of a lambda reference
values map.

1.1 What is Map Corrector for

The Map Corrector software was designed to work together with a tool that is capable to read and
write injection maps from and to an ECU.
When used with a Dell’Orto DoPe ECU, you can use the Dell’Orto DoPe software, since Map
Corrector can read and create injection maps in the format these softwares internally use. Moreover,
Dell’Orto DOP or DTD data files can be read from Map Corrector.
If you are not using a DoPe ECU, you can still use Map Corrector, since it can load text formatted
data files and read and produce text formatted injection map files; refer to Text data files format and
Text map files format for a quick explanation of text formatted map and map files.

1.2 The highlights of Map Corrector

• Data file loading, to use them as the source of correction information: Moto3
DOP or DTD files or text files for Moto3 version.
• Original injection maps loading.
• Corrected values showing.
• Updated maps saving.

MapCorrector user’s guide 3/27

 2 SOFTWARE INSTALLATION
This chapter will guide you through the installation of the Dell’Orto Map Corrector software.
Map Corrector has three prerequisites:
 .Net framework
 HASP Sentinel Runtime and drivers
 Visual C++ 2010
Note: If any of the above software is not installed on your pc, the setup program will ask you to install
it (or them).
Afterwards simply follow the instructions on the screen; the procedure may ask you to restart the pc
during this process.
Once you have installed all the prerequisites, the Map Corrector setup process will start with the
following window:

Figure 2-1

MapCorrector user’s guide 4/27

 Click on “Next” to go to the software License window:

Figure 2-2
Click “Next” to choose the installation directory, as you can see in Figure 2-3:

Figure 2-3

Click on “Browse…” button to specify Map Corrector destination folder.

Click on “Next” to proceed with the setup process:

MapCorrector user’s guide 5/27

 Figure 2-4

Click on “Install” to start Map Corrector installation on your pc. You can see the installation progress
during the process; if a prompt saying “Do you want to allow the following program from an unknown
publisher to make changes to your computer?” will appear, answer Yes.

When it will finish, the following window will be shown to you:

Figure 2-5
Click on ‘Finish’ to exit the installation program. A “Map Corrector” program folder has been created
in your Start menu, under “Racing Applications” parent folder.

MapCorrector user’s guide 6/27

 To run Map Corrector, just click on the ‘Map Corrector’ shortcut or double click the ‘Map Corrector’
icon that was created on your desktop.
 N.B.: If this is the first time you are using Dell’Orto Map Corrector software browse the folder you
chose to put the program in, you will find a sub directory named “MathLibraries” and copy the file
“MC_Moto3_18_0x.matlib” (provided with the program) inside it. For further details see 3.2.B.
Put in the folder also the “M3_MC_Lambda_lag.dat” lookup table in the same folder, for further
details see 5.2.C.

MapCorrector user’s guide 7/27

 3 MAP CORRECTOR
In order to calculate the optimized Injection Correction Map, the Map Corrector software needs a set
of information/files.
 Engine Configuration: Gives the software the information about cylinder numbers,
etc…This file is given from Dell’Orto. You can also edit your own configuration.
 Original Injection Correction Map: This map is the current injection map that the user
wants to correct. Map Corrector asks the user for it.
 Original Lambda Signal: This is the acquisition file (DOP/DTD for Moto3) with the data of
lambda signal already recorded. Map Corrector asks the user for it.
 Lambda Map Reference: this map contains the desired lambda values. This map is inside
the Engine Configuration, but then you may modify it.

Figure 3-1

When opening Map Corrector an empty window will appear. The first action to do is to open these
informations. From now on this group will be called ‘Configuration’.
 Engine Configuration (3.1.A)
 Original Lambda Signal from your Acquisition file (3.1.B)
 Original Injection Correction Map (3.1.C)
 N.B.: since signals in your acquisition files have names associated that can vary from user to
user, a way to convert these names into the ones Map Corrector internally uses is necessary: this is
done with a so called names mapping (see 3.2.A section for details).

MapCorrector user’s guide 8/27

 3.1 Open new Configuration

3.1.A Load Engine Configuration

The first information to open is the engine configuration. To open an engine configuration, click on
the ‘File\Open’ menu item

Figure 3-2
then select the configuration file you want to load (the configuration file has ‘.engcfg extension’).

To create a new configuration, just choose ‘New…’ and the window in Figure 3-3 will be shown. Here
you can build your own configuration.

Then, once you have opened the engine configuration the program will appear like in Figure 3-4.

 N.B.: it is also possible to open more than one configuration contemporaneously in order
to apply a correction at the same moment to the same data with different rules. You can also
perform a correction using the output map of an engine configuration as the input map for
one other configuration, for further details see 5.2.E.

MapCorrector user’s guide 9/27

 Figure 3-3

Figure 3-4

MapCorrector user’s guide 10/27

 3.1.B Data files loading to get the Original Lambda Signal
The next step is to choose one or more data files that will be used as source of information about
the corrections to act.

Click on button for starting the process and the window in Figure 3-5 will be shown.
Clink on the ‘Browse’ button in order to select the files. The data files format available to the user are
Dell’Orto DOP or DTD files and TXT files. After selecting the files that you want to use click on ‘Next’.

Figure 3-5

Once one or more files are loaded click on ‘Laps preview’ in order to have information about the
laps contained in the files (Figure 3-6).

This window lists all the laps of the file(s) selected in increasing order and the lap time. It is also
showed a brief information about each file session.

MapCorrector user’s guide 11/27

 Figure 3-6
To continue with injection map correction, just select one or more laps (is possible to use ‘Ctrl’ or
‘Shift’ keys to select more laps) and press Ok button (or press the ‘Enter’ key). Click on Ok without
selecting any laps to use all the laps contained in the file to perform the correction or use the filtering
option of the window (Skip flags) for example in order to skip the first and last laps.

MapCorrector user’s guide 12/27

 3.1.C Original Injection Correction map loading
After the data selection, the program will automatically prompt you for the original map (Figure 3-7):

Figure 3-7

Choose the original map file (the one that has to be corrected), and click ‘Open’. This map is the one
in your configuration, for further details see 6.3 section. After selecting the original map the program
will automatically ask you for the output corrected map (Figure 3-8). Choose a destination file to save
the output map. This map can finally be opened in DoPe (see 6.3 section).

Figure 3-8

MapCorrector user’s guide 13/27

 3.2 How the correction algorithm works

After explaining how to correct the maps, now it is important to understand how the algorithm works.
The correction algorithm analyzes the acquisition lambda values as a function of the rpm and throttle
to elaborate the Original Lambda map f(throttle, rpm).
Elaborate the Original Lambda map as a function of the throttle and rpm.
The breakpoints of this map (rpm and throttle) are the same of the Reference Lambda map and
Original Injection Correction map; an example of a portion of the map is reported in Figure 3-9.

Figure 3-9

The correction algorithm collects the lambda values (f(throttle, rpm)) and fills in this map.
To avoid problems when the lambda value is function of an rpm value or throttle value that are not
defined breakpoints, a strategy which expands the breakpoint value to a parametrized neighborhood
has been implemented. The parameter which regulates the neighborhood is the ‘Weight coefficient’
(see 5.2.A section for settings details).
In the same cell/area there could be more than one lambda value depending on the conditions of the
engine during the data acquisition. The algorithm will use the average of these values only if the
number of these values is greater or equal than a value named ‘Samples threshold’ (see 5.2.A
section for settings details). Otherwise, all these values will be discarded.
After doing so, the algorithm compares this Original Lambda map with the lambda reference map
cell by cell. The difference between these two values determines the Correction Lambda map
before filtering.
In order to avoid big discontinuity between the corrected cells and the not corrected cells a filter is
applied to this Correction Lambda map. This filter allows to “spreading” each cell value over its
neighborhood; the size of the neighborhood is specified by the ‘Smoothing level’. The result is the
Filtered Percentage Map.

MapCorrector user’s guide 14/27

 3.2.A Channels mapping
Map Corrector algorithm reads from acquisition data files the signals it needs to perform injection
map correction. Since the signals within data files have names associated that can vary from file to
file (depending on what the user decided before start logging them), the program needs a way to
convert these names into the ones it internally uses (like, for example, throttle and rpm).
For example, suppose the program needs the demand signal, and that it’s internally identified as
throttle; suppose, moreover, to have an acquisition file where this demand signal is defined as
‘demand’. You need a way to tell the program that throttle = demand; to do so, you need to create
such a mapping.
In order to perform this proceadure, use the Channel translation tool in the Settings window (see
section 5.2.D for details).

3.2.B Math libraries

A math library is an organized collection of math channels. The Map Corrector software needs a
Dell’Orto math library for working (5.2.A) which can be exported from Dell’Orto DoData software. If
you don’t have DoData you can use the ‘MC_Moto3_18_0x.matlib’ provided with the program.
Notice that with Dell’Orto DoData software you can build your own math library that would enable
you to use all the potentialities of the Map Corrector: for example you can build you own filtering
math channel that would be applied during the correction process.

 N.B.: the math library (.matlib file) must be placed inside the ‘MathLibraries’ folder in the
Map Corrector installation folder for the correct working of the program.

MapCorrector user’s guide 15/27

 4 CORRECT MAPS
After the loading of the ‘Configuration’ (see section 3.1) the correction will be applied to the
selected injection map.

Figure 4-1
The layout of the program is organized in ‘tabs’ (Figure 4-1) which will give to the user information
about the correction procedure:
 Input map tab: shows the original input map.
 Lambda sample count: shows the normalized values of the samples count of the map, each
values represent a “trust” indicator which tell to the user the importance of the value assumed
at the specific breakpoint. If the value is less than the ‘Samples threshold’ it won’t be used
for the correction procedure as explained in section 3.2.
 Lambda average values: shows the average values assumed by the lambda signal.
 Lambda target: shows the lambda target map.
 Correction map: shows the correction applied to the input map.
 Output map: shoes the final corrected map which will be saved in the file selected by the
user.
 Graphs: in this tab are represented the graphs of the shifted lambda channel, the throttle and
the rpm.

4.1 Correction results

In all those maps the cells associated with the breakpoints that are interested in the correction
process would assume different colors in respect of the conditions of the algorithm that is applied to
the original map:
 RED if the correction is saturated to the maximum negative value.
 ORANGE if a negative correction is applied to the value.
 GREEN if a positive correction is applied to the value.
 DARK GREEN if the correction is saturated to the maximum positive value.
 GRAY if the value won’t be considered because the sample count is less than the ‘Samples
threshold’.

MapCorrector user’s guide 16/27

 5 MAP CORRECTOR MAIN MENU

5.1 File

Use the File menu to open an engine configuration.

Figure 5-1
 New: create a new engine configuration.
 Open: open an engine configuration.
 Save as: save the current engine configuration.

5.2 Tools

Use the Tools menu to edit Map Corrector settings.

Figure 5-2
 Edit configuration settings: clears the list of last opened engine configurations.
 Apply user changes: TODO
 Options: opens the Map Corrector option window.

MapCorrector user’s guide 17/27

 5.2.A Edit Configuration Setting

Figure 5-3

In Figure 5-3 is shown the Edit Configuration Settings window.

 The ‘Name’ textbox enables to change the engine configuration name.
 The ‘RPM’ textbox defines the name of the channel associated with the rpm in telemetry.
Notice that the channel name must be the same as the one in the data file you want to apply
the correction.
 The ‘Edit map’ button enable to edit the lambda target map, for details see 5.2.B.
 The Correction polyline ‘Edit’ button enable to edit the polyline associated with the correction
algorithm. This polyline define the relation between the program proposed correction and the
final correction map. Then it is possible to saturate the correction map in order to limit the
entity of the correction.
 The ‘Samples threshold’ represents the threshold which defines the minimum value that the
cells of the ‘Lambda sample counts’ map (see 4.1) must reach in order to be used in the
correction process.
 The ‘Minimum sample count’ represents the minimum number of sample that are necessary
to the cell breakpoint in order to be considered in the correction process.

MapCorrector user’s guide 18/27

  The ‘Weight coefficient’ regulates the size of the neighborhood of a breakpoint, you can
choose between values: …..TODO
 The textbox ‘Throttle channel’ defines the name of the channel associated with the throttle
position in telemetry. Notice that the channel name must be the same as the one in the data
file you want to apply the correction.
 The ‘Lambda channel’ textbox is associated with the lambda signal used in the algorithm for
the computations. Notice that the channel won’t be the same as the original lambda signal
because of the delay due to the position of the lambda sensor itself and the engine working
conditions in respect of the current time. It is recommended to use the
‘M3_SHIFT_LAMBDA1’ signal. It is possible to regulate the delay of the signal in different
working conditions, for details see 5.2.C.
 The ‘Condition channel’ textbox is associated with the filtering channel that defines the
conditions where the correction must be applied. It is recommended to use the
‘M3_FINAL_zFILTER’ channel.
 N.B.: the ‘M3_SHIFT_LAMBDA1’ and ‘M3_FINAL_zFILTER’ are contained in the Moto3
Math libraries distributed from Dell’Orto which is necessary for the correct working of the
program, for details see section 3.2.B.
 The ‘Channel translation’ listbox enable to associate the names of the channels used by the
user to the name of the channels used by the software for its internal computations. For
details see 5.2.D.

5.2.B Lambda reference type: Edit map

This option allows seeing, editing, saving and loading the Reference Lambda map (Figure 5-4).
You can create a reference lambda map choosing between two different ways:
 Editing the map by yourself or
 From an existing file.

MapCorrector user’s guide 19/27

 Figure 5-4

If you want to edit the map you can clickon each cell and write the desired value at the related
breakpoint. There are also different functionalities that helps the user to fill easily the map, for details
see 6.4.
To load an existing map click on ‘File/Open’ and select the map you want to load. You can import the
lambdaSP map from a DoPe configuration, for details see 6.3.

5.2.C Edit the lambda delay throw the lookup table

Notice that in respect of the position of the lambda sensor and also to the working point of the
engine there is a delay in the value read from the lambda in respect of the time the correction should
be performed on the injection. The default value of the delay of the lambda signal in the Dell’Orto
math library is of 60 ms.
If you want you can edit by yourself the delay at different breakpoint of the injection map through a
lookuptable. The lookup table is a the ‘M3_MC_Lambda_lag.dat’ file given from Dell’Orto and has to
be placed inside the ‘MathLibraries’ folder inside the program folder. The file can be opened with a
text editor and is organized in tab-separated columns:
 Rpm
 [ms]

which represent respectively the delay of the lambda signal at the corresponding value of rpm.
An example is reported in Figure 5-5. You can edit the file adding or removing lines with the
breakpoints values you want.

MapCorrector user’s guide 20/27

 Figure 5-5
 N.B.: if you edit the lookup table file remember to live an empty line at the end.
 N.B.: the lookup table functionality is available from ‘MC_Moto3_18_02.matlib’. If you have
a previous version of the math library please contact Dell’Orto staff.

5.2.D Channels translation

A mapping is necessary to translate source data file custom channel names (for example: DEMAND)
into Map Corrector internally fixed channel names (for example: THROTTLE): see section 3.2.A for
details.
Use the yellow tab to edit an engine configuration channel names mapping (Figure 5-6).

Figure 5-6
The Internal name is the name used by the software, while User name is the name stored within
acquisition data files; to find out the meaning of each internal program channel, look at that channel
Description.

MapCorrector user’s guide 21/27

 5.2.E Options
It is possible to open more than one configuration at the same time (Figure 5-7). In order to open
more than one configuration at the same time the name of the configuration must be different, you
can change the configuration name in the Edit Configuration Setting (5.2.A).

Figure 5-7

From the ‘Options’ window (Figure 5-8) you can change setup preferences on the working of
program. The ‘Input’ group enable to choose between three configuration settings:
 Ask the input for every configuration: the program ask the user for the input injection map for
each opened configuration.
 Share the same input for all configurations: the program use the first injection map selected
to perform the correction for each opened configuration.
 Chain input: the program use the output map of the previous opened configuration as the
input map for the following configuration.

Figure 5-8
The ‘Configuration’ group enable to check folder preferences for the input and output files.

MapCorrector user’s guide 22/27

 6 APPENDIX

6.1 Text data files format

The following figure shows an example of text formatted data file Map Corrector can read:

Acquired signals

Figure 6-1
The first row has to contain the acquired signals names; the first signal must be the time, and its
name has to be CLOCK. Starting from the second row, signals data have to be listed, separated by
the tabulation character, following the rules below:
 CLOCK samples have to be the first ones in the rows; they represent the acquisition time (in
seconds)

MapCorrector user’s guide 23/27

  signals sampling rate is automatically determined by the difference between CLOCK
consecutive samples, so the difference between a CLOCK sample and the following one
cannot change
 for each signal sample, the decimal separator character (if necessary) must be the dot (‘.’)

6.2 Text map files format

Figure 6-2 shows an example of a text map file Map Corrector can read (and produce).
The first row contains the map name; following 7 rows are needed by the software and must remain
as shown in the example.
Starting from the 9th row, there are the data regarding the first gear map.
 N.B.: all values (both axes and map ones) are represented in fixed point notation; it means that
if, for example, map values are represented with 2 decimal digits, a value of 2.34 has to be written as
234, and a value of 5.6 has to be written as 560.
The first row represents X axis breakpoints: first value must be 0, while other values are the actual X
axis breakpoints.
The following rows start with an Y axis breakpoint, followed by map values referring to that particular
Y breakpoint.
If more than one map is needed (for example, to have different target maps, one for each gear), just
add more data, following the schema below for each additional map:
<blank line>
Dynamic matrix “gear number – 1”
“gear number – 1”;
<blank line>
map data
(see last highlighted section in Figure 6-2).

MapCorrector user’s guide 24/27

 Map name X axis breakpoints
(excepting the
1st gear map first 0 value)

Map values

Y axis breakpoints
(excepting the
first 0 value)

Other gears
maps
(where
necessary)

Figure 6-2

MapCorrector user’s guide 25/27

 6.3 Import and export map files to and from DoPe

Within Dell’Orto DoPe program, open the engine configuration injection map that have to be
corrected. Once the configuration is opened, expand the node that represents the curve containing
the map you want, i.e. the injection map, then locate InjectionCorrection node and right click on it
(Figure 6-3).

Figure 6-3

Click on ‘Export to file…’ to save the injection map, in order to use it within Map Corrector. Once the
new corrected maps will be created, come back to DoPe and choose ‘Import from file…’: the engine
configuration is now using the newly corrected maps. The same operation can be performed also
with the lambdaSP map selecting the LambdaSP node and performing the same operation
described above for the injection map.

MapCorrector user’s guide 26/27

 6.4 Modifying map values

Select the cell or cells to modify in the table. The selected cells become highlighted blue. By
clicking the right mouse button these options are available.
Copy: copy the selected cells of the table.
Paste: paste the copied cells in the table.
Paste SPECIAL: advanced paste features (sum or
percentage).
Offset: adds the written value to the original one.
Percentage: adds this percentage of the original value.
Replace value: just replaces the original value with the
new one.
Interpolation: interpolate between values (by row, by
column or by area).

The modified cells become highlighted red.

 Copy cells & Paste cells options: Allows also the user to use a spreadsheet (for
example Excel) as a working tool. It is possible to copy cells from any map, modify
them in the spreadsheet program and then paste them in the desired cells of the
original map.

MapCorrector user’s guide 27/27