Contents

1 Introduction

1.1 SGE Circus user manual

1.2 SGE CalcGuide user manual

1.3 SGE Circus videos (external)

2 Keyboard shortcuts, mouse gestures

3 Features

4 Map(s)

4.1 Map handling

4.2 Working page / reference page

4.3 Load / replace template maps

Map sources

Modes

Transpose

4.4 Save maps

Save calibration parameter file

Save as MATLAB script

Transfer to ETAS INCA

Transfer to clipboard

4.5 Interpolate active map to new axes

4.6 Invert active map

5 Data points

5.1 Load / append / replace data points

5.2 Interpolation mode

5.3 Delete data

5.4 Data properties

5.5 Check files

5.6 (Data) Info

6 Mode, View

6.1 3D / 2D / table view

6.2 Working / reference page view

6.3 Data display reduction

6.4 Display options

6.5 Background color

6.6 Mark

6.7 Cursor

7 Map creation and optimization

7.1 Map calculation

7.2 Map smoothing

7.3 Axes optimization

8 Calibration

8.1 Standard operations

Invalid map points

8.2 Advanced operations

Interpolate

Polynomial / exponential fit

Extrapolate

Distribute changes

Limit gradient

Graphical axes modification

8.3 Copy / paste

8.4 Set to reference page value

8.5 Conversion rule

9 Save session

10 Present, print, organize

10.1 Copy view to clipboard, print

10.2 Window handling

11 General information



SGE MapArtist – User Manual

www.sge-ing.de – Version 1.62.67 (2022-07-24 22:21)

1 Introduction

The SGE MapArtist is a tool for ECU map creation, visualization and optimization. This manual gives information about the topics regarding the SGE MapArtist only. The SGE MapArtist is part of the SGE Circus. For help topics regarding general features please refer to the corresponding documentation accessible using the links below.

1.1 SGE Circus user manual

The SGE Circus documentation makes available general information regarding data loading procedure, input handling, preferences, history and other topics concerning all tools.

1.2 SGE CalcGuide user manual

The SGE CalcGuide is a tool to implement calculation routines by creating graphical flow chart diagrams - included with all tools.

1.3 SGE Circus videos (external)

Videos and tutorials are available on the internet.


For information regarding the version dependent software changes please refer to the Release notes accessible using the corresponding menu item inside the SGE Circus.

2 Keyboard shortcuts, mouse gestures

Many functions are quickly accessible via keyboard shortcuts. For a list of available keyboard shortcuts, see the list below. In addition, the entries in the menus and context menus as well as the tooltips of the toolbar point to shortcuts.

Map Handling

Ctrl + t

Load maps / axes...

Ctrl + s

Save calibration parameter file / send map to INCA ...

F4

Map Configuration

Shift + 1..6

Select active map

Ctrl + Shift + 1..6

Toggle map visibility

Shift + del

Delete map...

Shift + l

Toggle legend visibility

Ctrl + Shift + Up/Down

Change map order in legend

Data Points Handling

Ctrl + o

Load data points...

Ctrl + d

Delete data points...

Ctrl + Enter

Data color / description ...

View

Ctrl + 1

Activate 1D view.

Toggle modes in 1D: value, value+diff, value+diffrel, diff, diffrel

Ctrl + 2

Activate 2D view.

Swap x/y in 2D view.

Ctrl + 3

Activate 3D view.

Ctrl + 5

Activate 2D+3D view.

Swap x/y 2D+3D view.

Ctrl + Arrow (only 3D)

Mouse button

Ctrl / Shift + mouse wheel

Rotate

Ctrl + + / -

Ctrl + Arrow (only 2D)

Mouse wheel

Zoom

Ctrl + r

Ctrl + F12

Toggle standard views, reset axes (2D/3D). Modify table width (table view).

Shift + Mouse button twice

Center map at marked point (marked points must stay) /

Extend marked map points

Ctrl + Mouse button,

Ctrl +Mouse move

Add to / Remove from marked map points

Shift + r

Shift + F12

Toggle standard views, keep axes

Ctrl + Shift + / -

Increase / decrease data display reduction

Ctrl + Shift + F12

Automatic data display reduction

F8

Toggle active page (working / reference) page

Ctrl + F8

Toggle visibility of background reference page

Ctrl + p

Toggle data point visibility

Ctrl + l

Toggle error lines point visibility

Ctrl + m

Toggle map visibility

Ctrl + e

Toggle error map visibility

Shift + enter

Color map...

n

Next color

Ctrl + n

Previous color

Ctrl + a

Mark all map points (2D, 3D). Toggle mark all, map, axes (table view).

Shift + n

Toggle number of lines in 2D view

Shift + l

Toggle legend visibility

Ctrl + x

Set axes ranges or set axes tick to accord with map breakpoints...

Map Calculation

Shift + c

Calculate / optimize map...

Shift + s

Smooth map...

Shift + a

Optimize axes...

Map Editing

+ * / =

Modify by calculation / set value...

-, 0..9

Start direct value input...

space, F2

Set value (only table mode)

(Ctrl +) (Shift +) F7/F6

Ctrl + Shift + mouse wheel

Increment / decrement

Ctrl + c / v

Ctrl + Shift + v

Copy / paste data to / from clipboard.

Paste using operations (+,-,*,/).

Additionally it is possible to paste files or strings containing file names to the present to load maps or data points.

Shift + w

Copy map+axes...

Ctrl + u

Reset value to reference page

Ctrl + Shift + f

Copy working page to reference page

Shift + m

Mark map by condition...

Ctrl + k

Conversion rule settings...

Shift + k

Apply conversion rule

Advanced Editing

Shift + x / y

Interpolate

Ctrl + Shift + x / y

Distribute changes

Ctrl + Shift + e

Extrapolate...

Ctrl + g

Limit gradient...

Shift + Mouse button

Move axis breakpoint in 3D view (mark and unsnap first)

Miscellaneous

F1

Show manual...

Shift+F1

Show keyboard shortcut manual...

Ctrl + z

Undo (views, marks)

Ctrl + y

Redo (views, marks)

Ctrl + Shift + c

Copy window to clipboard..., Print window...

Ctrl + Shift + s

Save session...

Ctrl + Shift + i

Data info...

3 Features

The main features of the SGE MapArtist are listed in this introduction. For details please see the following sections.


Data Import Measurement Points

Data Import Maps, Axes

Map Export

Map Display

Map Creation

Map Editing

Cursor

Session

History

Info

Graphic Export

Data Exchange

4 Map(s)

4.1 Map handling

The main purpose of the MapArtist is to create, visualize and optimize maps. Therefore any number of maps can be loaded or created simultaneously.

Exactly one of the loaded maps will be the active map at a time. Only the active map is fully functional. All other maps are just displayed in standard manner. So e.g. only the active map can be edited, marked and copied. Error maps, error lines and iso-contour plots are only available for the active map.

A legend can be displayed (Ctrl + l) to identify the active and loaded maps as well as the data point sets. In table view a tooltip will be shown to identify the active map when the mouse rests on the table.

The main map handling operations are:

Additionally to using keyboard shortcuts or the menu items most map handling and configuration operations can be performed using the Map Configuration utility (F4).

4.2 Working page / reference page

The active map is available as reference and working page. Either the working or reference page can be activated (F8). Additionally the reference page can be made visible while the working page is active (Ctrl + F8). The reference page map is displayed using a dotted line.

The working page can be edited. The reference page is write protected. The only ways to modify it is to save the working page as reference page (Ctrl + Shift + f) or to load a new template map with different axes size (Ctrl + t). In this case the template is also loaded to the reference page to keep the dimension of reference and working page map identical.

You can also copy the reference page to the working page.

4.3 Load / replace template maps

Templates are maps and their axes. They can be displayed, compared, changed and saved again. Templates must have strictly monotonically increasing axes. The axes are automatically adjusted if they do not meet the condition.

Several sources are available to load template maps from. It is also possible to create a new map without using any external source. See the following section for a description of all template generation options.

When you load a template map (Ctrl + t) for the first time during a MapArtist session it is made the active map and working and reference page are initialized with the template map data.

When you reload a template map (Ctrl + t) different modes are available to add or replace maps or to interpolate maps to new axes. See below for a description of all template load modes.

4.3.1 Map sources



4.3.2 Modes

4.3.3 Transpose

You can choose to transpose the template map to load. In this case the x- and y-axes are swapped also. This option is only valid when loading a template from any source. It is ignored when creating a new template.

No A2L information will be retrieved in this case.

4.4 Save maps

Different targets are available to export the active map to. These are file formats like DCM/CDFX and CSV file (suitable to import into MoTeC software), MATLAB scripts (*.m) as well as direct transfer to ETAS INCA software. Of course data can alsi be transferred using the clipboard.

If, when loading the template maps, they were automatically adjusted to have strictly monotonically rising axes, these modified axes are also used when saving. In case the map to save to DCM/CSV file or ETAS INCA software contains invalid values (NaN) you will be asked for a replacement value. Leave empty to keep the invalid values.

4.4.1 Save calibration parameter file

The working page label can be saved as calibration parameter file (*.dcm, *.cdfx, *.dcmap, *.csv, *.m) (Ctrl + s). The *.m format supports to generate a MATLAB script file to transfer the calibration parameters into the MATLAB/Simulink workspace. The CSV file has a format suitable to import into MoTeC calibration software. Choose whether to include the complete comment from the "Data → Info" as label "Comment" into the file.

You can enter an extra comment here that is additionally saved as label "Comment" to the file. Select the name for the label to create and to save into the file. Default is the name of the loaded template label.

Several A2L options are asked when saving to calibration parameter file and “Apply A2L settings” is checked . This is needed if the file should be conform to the description file of the ECU. The correct group axes are especially important, because otherwise the axes will not be loaded by the calibration software even if they are saved with the map. The values are prefilled if this information is available for the label name. They will be retrieved when loading a template map from ETAS INCA software or from an internal database. Therefore it is especially important to set the correct label name in the options dialog.

Even if you decide not to apply the “Apply A2L settings” any group axes information available (e.g. if label was loaded from calibration parameter file) will be maintained and transferred to the new file to save.

If the information from this dialogue does not match the information already linked to the map you will retrieve a warning to confirm the replacement of the properties. This may for example happen if you load a template map from a calibration parameter file while the previous dialog is filled from the database or if you choose to save to a different label name. If the project of the label in the database does not match the one of the calibration parameter file, some properties may be different. It is important to check the properties to replace because otherwise data errors in the file may happen by applying wrong properties like group axes.

4.4.2 Save as MATLAB script

A map can be saved as a MATLAB script (*.m). When this script is executed in MATLAB, the map and its axes are created in MATLAB workspace and are available for calculations and simulation in MATLAB and Simulink.

The following options are requested in this case:

4.4.3 Transfer to ETAS INCA

The working page map can be sent directly to ETAS INCA software (Ctrl + s). Therefore INCA must be started and an experiment must be opened with the working page active.

Warning

Before sending the map to INCA it has to be verified that no function, which is relevant for secure operation, might be influenced. Do not send data while INCA is connected to ECU hardware or a vehicle / engine.

4.4.4 Transfer to clipboard

The map can be copied to clipboard. Different options are available:

When copying the map+axes (Shift + w) the clipboard format is suitable to paste into different target formats. Some options are additionally available to configure the output to your needs.

4.5 Interpolate active map to new axes

The working page of the active map can be interpolated to the axes of a template map to load. The values of the map to load are irrelevant in this case - only the axes data will re regarded. If the dimension of the new template map differs from the dimension of the active map, also the reference page will be replaced to assure equal dimensions.

The procedure and options to load the new axes are similar to “Load / replace template maps”.

4.6 Invert active map

The working page of the active map can be inverted by tilting the map - one of its two axes is swapped for an axis corresponding to the w-values of the map.

Decide which axis should be used from the "Axis source". The axis must correspond to the X-axis of the active map. For example, if you want to invert a map representing the torque over speed and load, the loaded axis must be a torque axis.

Decide which axis of the active map should be replaced by the axis from the "Axis source". In this way, you determine the direction of the inversion. If the inversion is understood as tilting, you decide here the direction of tilting.

For example, if you want to invert a map representing torque (w) over speed (x) and load (y), you have two options.

  1. If you want the result to be a map showing the load over speed and torque, select "Y-axis" as the target axis.

  2. If you want the result to be a map that shows the speed by load and torque, select "X-axis" as the target axis.

Decide how to handle points outside the axis areas. Default is to set the values to invalid (=NaN). You can also decide to keep the nearest value from the map or to extrapolate.

If the map is not monotonous, the inversion is not unambiguously possible, as there can be several solutions. In this case, you can decide whether you want to use the smaller or larger result.

This option is relevant for all points of the new axis that are above the map to be inverted.

Checked: For values to be inverted above the map the axis value corresponding to the maximum is determined.

Unchecked: The last axis value is determined for values to be inverted above the map.

5 Data points

Measurement data points are loaded to give the course of the map to create or to be displayed together with the map (Ctrl + o). This data may be scattered and must not be arranged to the map breakpoint values.

The data loading procedure is explained in the documentation of the SGE_Circus as it is common to all tools. We recommend that you read that section first as useful features like sample reduction, logical load conditions and calculated channels are explained there.

5.1 Load / append / replace data points

When loading data (Ctrl + o) you will be asked for files and channels to load. Normally you will choose three channels containing the x, y, and w values of the data points. You have to activate the “common axis” feature to ensure the equal number of x, y and w values. Calculated channels and the logical load condition can be used to load exactly the data you need.

The data points are organized in data points sets. Any number of data point sets can be loaded simultaneously. You can edit the color and description of the data points sets and switch their visibility (Ctrl + EnterData properties). Anyway even invisible data points take place for map optimization, smoothing and all other operations.

In addition to using the file load dialog, you can load sessions and data files by using drag and drop or the clipboard. To do this, one or more files can be dragged directly to a MapArtist session or inserted via keyboard shortcut (Ctrl + c / v). It is also possible to copy files directly to the clipboard as well as strings containing the file names line by line.

In case data points are already loaded the options for the data loading process like filename, sample rate and calculated channels will be proposed to easy replacing data. When multiple data point sets are loaded the first active one will define the options to propose. So when you need to get the settings of a specific data point set you can deactivate (Ctrl + Enter) all other to simplify the data loading process.

After loading the data and a template map you will be asked to the data correlation. Choose which channels loaded to use as x, y and w values. If you loaded a template map and do not want to create a new one the template axes ranges are shown to ease the choice.

In case data points are already loaded you will also be asked whether you want to replace them or to append the newly loaded data points. In case of adding data you will be asked to select a color for the new data point set. In case of replacing you have the option to only replace a single data point set instead of all.

If the loaded data contains NaN values these points will be removed automatically.

5.2 Interpolation mode

If you loaded a template map and do not want to create a new one you can alternatively load only two data channels. The third one is then interpolated from the active map. This feature is used to just display the operating area of the data file in the map.

5.3 Delete data

You can delete part of the loaded data points (Ctrl + d) that you don't need or want for map creation for example to remove spikes. You can either double click onto a data point or use the menu.

You can delete data points if they are far away from the map. Define the distance threshold here either as absolute or percentage value. E.g. 2 or 2%. Leave this field empty if you don't want spike deletion.

You can also delete data points where a logical condition is true. You can modify the condition in a graphical manner using the push button. Using the channel object you can access the following data:

The following picture gives an example for “Delete all points between xaxis 100 and 200”.

Leave the calculation empty if you don't want logical deletion.

All conditions are combined with OR. So if at least one of them applies the point will be deleted.

Before deleting the data points a confirmation dialogue will be shown and the points noted for removal will be shown colored red. Rotation and zooming is enabled while the confirmation dialogue is present.

When a big number of data points will be deleted no red markup will be shown to avoid slowdown of the display.

5.4 Data properties

When loading data points you can select to replace the existing data or to add to it. In the second case multiple data point sets will be created. Each set can have an individual color and description. Both can be modified (Ctrl + Enter). It is also possible to make single data point sets invisible. Anyway even invisible data points take place for map optimization, smoothing and all other operations.

The dialog additionally enables to edit the color of the marker points for each data points set separately and the marker type and size for all sets.

5.5 Check files

The files the data was loaded from is remembered and will be used e.g. to prefill the dialogs when reloading data. They can also be displayed using the data info ((Data) Info).

It may happen that files have been renamed or moved during the work or after reloading a session. Use the “Check files” option in this case to search the missing files and update their names and path automatically. Remember that sometimes it is not possible to find missing files. Especially all files must be located in the same directory. The option “Continue + Remember” allows you to save search results and apply them quickly next time without prompting. To reset these saved replacements, the software must be restarted or the corresponding option must be used when the message after automatic replacement is displayed.

5.6 (Data) Info

You can display some information about the loaded data and maps (Ctrl + Shift + i) like file names, comments, axes details, data loading / map history and calculated channels. This may be helpful to document the work done.

Calculated channels will be shown by opening them in the CalcGuide. This is just for display purpose. Modifications done in the CalcGuide will be discarded. In order to be able to find calculated channels quickly but also to be able to view the sequence of the calculation, they are displayed unsorted and sorted.

The data can be copied to the clipboard.

6 Mode, View

6.1 3D / 2D / table view

The MapArtist window has three main views – 3D, 2D and a table view. The 2D and 3D view can be shown simultaneously in a split mode. Switching between these modes can be done quickly using the keyboard shortcuts (Ctrl + 1, Ctrl + 2, Ctrl + 3, Ctrl + 5).

The view can be adjusted quickly by using mouse and keyboard shortcuts or the mouse – e.g. zoom (Ctrl + + / -, Mouse wheel) and rotate (Ctrl + Arrow, Ctrl / Shift + mouse wheel).

The axes labels and title can be modified. The axes labels are not always visible to maximize the view of the map if “Maximize axis area” is activated. Also the axes ranges can be modified and the axes ticks can be forced to accord with the map breakpoints (Ctrl + x). If “Axis auto” is checked in the menu the ranges will be chosen automatically.

6.2 Working / reference page view

Depending on the selection in the menu either the working or reference page map is shown (F8). Additionally the reference map can be shown as a transparent background map with dotted lines while the working page is active (Ctrl + F8). Choose the grade of transparency and the color in the corresponding menu. By default the color is kept equal to the working page map color.

6.3 Data display reduction

To accelerate the display a sample reduction factor for the data points is used in 3D and 2D mode. 10 e.g. means that only every tenth data point is displayed. The option does not influence the created label. It is only used for displaying the data samples. "Automatic" means to automatically adjust the display reduction according to the performance of the computer.

“Automatic” is on by default. To use a specific data display reduction use the corresponding keyboard shortcuts (Ctrl + Shift + / - ). Once a specific reduction was chosen is remains active until automatic detection is reactivated (Ctrl + Shift + F12). It is also possible to enforce a specific reduction using the “Display options” menu item.

6.4 Display options

Using the “Display options” menu item enables to modify some display setting. It is possible to enforce a specific sample reduction as well as to configure the iso-contour plots.

6.5 Background color

Using the corresponding menu item enables to adjust the background color of the 2D and 3D view.

6.6 Mark

Map values can be marked (selected) and will be highlighted then. This can be done using the mouse (Ctrl + Mouse button,Shift + Mouse button), keyboard and the menu function. Arbitrary map areas in 2D and 3D view can be marked/unmarked wiping the mouse while Ctrl key is pressed. The marker color, type and size can be modified using the corresponding menu items.

When points are marked several functions will ask to operate on the marked or all points when executed.

Using the menu function (Ctrl + m) enables you to use mark algorithms.

The following picture gives an example for “Mark all points with map values between 1 and 2”.

The different mark methods are combined with OR.

6.7 Cursor

When map points are marked a cursor view is activated in the top left corner. The position of the cursor view can be modified by dragging it with the mouse.

It displays the values of the current point or current range if multiple points are selected. Also the difference working to reference page and absolute / relative error referenced to data points is shown.

In case multiple labels are loaded their difference to the active label is shown.

The cursor can also display an individual text below the data values. Use the corresponding menu item or double click the cursor to edit the individual text. Remember that the cursor and therefore the individual text will only be displayed when map points are marked.

7 Map creation and optimization

The main target of the MapArtist is to create a plausible map that matches the data points. Therefore a set of functionality is available to create and smooth the map and axes distribution.

When points are marked you will be asked whether the operations should be done for all or only the marked map points.

7.1 Map calculation

The map calculation (Shift + c) generates the map values to fit the data points using multiple algorithms. Thus the map calculation can only be performed when data points are loaded.

Workmode

Modify only data areas

You can choose if you want to calculate the whole map or only ares where data points exist. The data area is regarded as a convex hull around the data points.

Termination

This option is only valid for the "Optimize map" modes and must be empty for all other modes.

During smoothing a progress bar is shown to judge the progress. The progress shown corresponds to the remaining deviation from the map to the data points. In practice the deviation will not be reduced to zero because the map will not be able to fit the data points perfectly as the breakpoint number is limited and data points are influenced by measurement tolerances. So the waitbar will stabilize at any value but not reach 100%.

You can limit the time and/or the progress for the optimization in the options dialog. Define as string ending with ''s'' for seconds or/and ''%'' for a relative percentage limit. E.g.: 10s 80% 10s_80%

The map view will be updated regularly during optimization to judge the progress. When the result is satisfying the entire optimization process can be terminated by closing the waitbar window.

Smoothness priority

This option is only valid for the "Optimize map" modes and must be empty for all other modes.

It specifies the priority to consider for the smoothness of the map during optimization. 0 means to fit the map to the data points as good as possible without regarding its smoothness. Higher values increase the smoothness of the map at cost of its accuracy to fit the data points. A value of 1 means approximately the same priority of smoothness and accuracy. In general the value should be as small as possible. Values of about 0.1 may be a suitable starting point.

There is no need to enforce the desired smoothness of the map by using high values for this option because separate map smoothing algorithms are available. See the following section.

7.2 Map smoothing

After calculating a map it is generally a good practice to process some smoothing (Shift + s). Mostly it is possible to get more plausible maps without increasing the deviation to the data points too much. When points are marked you will be asked whether the operations should be done for all or only the marked map points.

Generally spoken the best smoothing settings must be evaluated for every use case.

Around the map a "corridor" will be created with the width of the chosen range. Then the smoothest possible map inside this corridor is created. This methods always tries to straighten the map and may change the course of the map. It is recommended to apply a "Max. allowed error increase" if data points are loaded.

The corridor range entered here can be relative or absolute. If the value ends with % it is regarded as relative in percent of the map value. This may lead to unwanted behavior if the map values are close to 0. Use together with the "Max. allowed error increase" option.

Corridor smoothing only tries to smooth the map in the directions that are activated.

During smoothing a progress bar is shown. Because the smoothing process is split into different phases with different proceeding you will recognize that the progress shown is not linear. The waitbar will speed up and slow down alternately. When it stops for too long you have the possibility to skip to the next phase by closing the waitbar window and choosing the corresponding option in the dialogue shown afterwards.

You can limit the time and/or the progress for the smoothing in the options dialog. Define as string ending with ''s'' for seconds or/and ''%'' for a relative percentage limit. E.g.: 10s 80% 10s_80%

The map view will be updated during smoothing to judge the progress. When the result is satisfying the entire smoothing process can be terminated by closing the waitbar window.

After termination of the smoothing the map points that were restricted to smooth by the corridor width or the error criterion will be marked to be able to judge the smoothing options chosen. These marks will be removed when resetting the view, recalling the function or using the following mixer.

Smoothing mixer

A mixer will be shown after finishing the automatic smoothing to balance the smoothing result between the initial map before smoothing and the map resulting from the automatic smoothing process.

7.3 Axes optimization

The axes optimization is used to modify the axes breakpoints in a way that the map fits the data points in an optimal way (Shift + a). Thus the map calculation can only be performed when data points are loaded.

The axes optimization can be restricted to single directions and breakpoint ranges. You can limit the time for the axis optimization. Define as string ending with ''s''. E.g.: 10s.

When points are marked the axes optimization will only regards these points. Therefore it is possible to optimize axes with focus on specific map regions.

In general axis optimization is only reasonable if the data values are equally distributed. If the data was measured with discrete values only the axis optimization will fit the axes breakpoints to these data values.

After axes optimization the map calculation should be repeated to again fit the map values to the data points.

8 Calibration

After creating a base map using the map optimization and smoothing features or loading a existing map you probably want to fine tune it manually or tool assisted using your experience and regarding the constraints given by the purpose of the map.

The MapArtist provides a set of features to do this

8.1 Standard operations

To modify the map one or multiple points must be marked. All operations refer to the marked points only.





Enter a numeric value or "n(an)" or a calculation. Values can be specified either directly or as a simple calculation rule. In the calculation rule, the placeholders "X", "Y", and "W" can be used to access the current values of the map or the axes. Additionally "XMAX", "XMIN", "YMAX", "YMIN", "WMAX" and "WMIN" can be used to access the extrema.


Examples:

100 : Numeric value

nan : Invalid value

2*pi/360 : Calculation rule

sin(2*pi) : Calculation rule

tan("W") : Calculation rule including map values

tan("W")*"X"^2 : Calculation rule including map and x-axis values





The standard operation are:

Most of them are accessible via keyboard shortcuts and you can also increment/decrement using the mouse wheel. See the keyboard shortcut section for details.

Especially using the keys for the digits and – allows to directly input a new value for the marked map points.

When the error lines (and therefore the error calculation) are turned on and only one point is marked and modified, the color of the mark indicated the error trend. When it is green, the error was decreasing by the modification. When it is red, the error was increasing.

The axis values are modified you will be asked whether to adjust the map accordingly by interpolation or extrapolation. The decision can be remembered. In this case you will not be asked again until the software is restarted.

Interpolation / extrapolation can only be performed when the axes are strictly monotonously increasing. You will be informed when this condition is not met.

8.1.1 Invalid map points

If you set points to invalid, they are filled with NaN (not a number) and made invisible. This creates holes in the map. Sometimes this is e.g. useful to not show border areas where no data points exist. You can not mark invalid points directly any more. To mark them you must mark areas around to include them or use a logical mark condition.

To use a map in the ECU or to save it to calibration parameter file you must fill all invalid point with numerical values.

8.2 Advanced operations

8.2.1 Interpolate

You can do a linear interpolation of marked sections of the map in x or y direction (Shift + x / y). The border values of the section is kept and the intermediate values are interpolated.

8.2.2 Polynomial / exponential fit

Similar to the extrapolation you can to a interpolation. Similar options are available.

When doing polynomial, exponential fits or extrapolations the fitted curves are displayed as lines as well as the considered and modified points. To remove them you can recall the interpolation functions or reset the view.

8.2.3 Extrapolate

You can do an extrapolation of sections of the map (Ctrl + Shift + e). This is done using a two step procedure. First you mark a reference area and call the extrapolation function. Then you mark the area to extrapolate and call the function again.

The two areas must overlap in only one direction. Some options are asked:

8.2.4 Distribute changes

Sometimes only parts of the map are modified and the changes should do a smooth transition to the neighborhood areas. Imagine you correct the full load breakpoint only but want the change transferred to the part load area with decreasing influence.

Use the “Distribute changes” (Ctrl + Shift + x / y) function to achieve this. You need to mark the transition areas as well as the border of the changed are. The difference between the reference and working page at this border is then linearly distributed.

In the following figure the cyan line is the reference page. The yellow one is the modified map - only one breakpoint is changed. After distributing the change the red line is created.

8.2.5 Limit gradient

If the map should agree with limitations regarding its gradient these restriction could be applied automatically (Ctrl + g). For example it could be necessary that a map is strictly monotonously increasing in x direction.

The following options are asked:

8.2.6 Graphical axes modification

In addition to the automatic axis optimization in 3D view and the manual edit of axis points in table view you can directly drag axis breakpoints in 2D/3D view with the mouse while pressing the shift key (Shift + Mouse button).

Proceeding:

After releasing the mouse you will be asked to confirm the new value and if you want to interpolate / extrapolate the map to the new axis value.

8.3 Copy / paste

You can copy and paste parts of the map or the whole map using the clipboard (Ctrl + c / v, Shift + w). The format is suitable to paste into a spreadsheet software. Additionally entire maps with axes can be copied to clipboard using different target formats. See “Fehler: Referenz nicht gefunden” for details.

Additionally you can load sessions and template data files by pasting them into a MapArtist session. Before you have to copy them directly to the clipboard or as strings containing the file names line by line.

Using copy and paste in table view will always handle the map/axes values – even if the display mode is set to show e.g. differences.

Using the extended paste mode (Ctrl + Shift + v) enables you to apply operations like addition, subtraction, multiplication, division or max/min selection when pasting the values. This can be used e.g. to add two maps. It is also possible to transpose or flip the data before pasting.

The decimal separator used for copy / paste actions can be set in the SGE Circus preferences – by default the operating system setting is used.

8.4 Set to reference page value

You can set parts of the map or the whole map to the value(s) of the reference map (Ctrl + u).

8.5 Conversion rule

Usually a label is implemented in a ECU using computer data types and then calculated to physical values using a conversion formula. This may lead to a restriction of the value range and force a incrementation. To consider this while editing a label the conversion rules for the label and axes may be specified (Ctrl + k).

Initially the values are set to the A2L values if available, e.g. if the label was retrieved from ETAS INCA software. The values are also remembered in relation to the label name in a database. They will be retrieved from database again if you import a map from calibration parameter file or create a new label. Therefore it is important to enter the exact label name when creating a new label.

You man enter values differing from the ECU conversion to ease manual map editing. But best practice is to keep the ECU conversion and use the manual editing increment gain setting to adjust to a suitable for manual incrementation and decremention.

The conversion rule may be applied by manual invocation (Shift + k). When the corresponding option is enabled it will be applied automatically whenever the map is manipulated, e.g. after automatic map creation, smoothing, pasting and so on. When automatic application of the conversion is disabled the increments are just used for manual incrementation. All other map manipulations do not consider the conversion rule then.

For manual map editing (incrementing, decrementing) in general the increment from the conversion rule is used. To adjust to the practical needs a gain factor can be set. The gain factor does not influence the conversion rule. It is just used for manual map editing.

Besides the settings here the A2L conversion rules may be considered when saving the map to calibration parameter file or ETAS INCA software.

9 Save session

The whole session including data can be stored as file (Ctrl + Shift + s). After re-opening the whole functionality can be used again immediately.

Session files can be opened the same way as data files or using the SGE Viewer. Session files may get very large as they contain the loaded data.

Apart from saving a session it is possible to save maps to files and transfer datasets to ETAS INCA software, see section “Save maps“ for details.

10 Present, print, organize

10.1 Copy view to clipboard, print

To be able to use the maps and data also for presentation purposes, the MapArtist makes it available to export the actual view into the clipboard or file formatted in a way that is suitable to be useful for different targets (Ctrl + Shift + c).

This can be different sizes of clipboard content. "Email" and "Document" are specially sized to fit into a email or document software. Some paper formats are also available and all windows can be printed and saved to various file formats.

The created window is configurable. So you can move elements like legend or cursor boxes. It is also possible to add lines, arrows, text boxes etc. to the window to explain or highlight.

During creation some options will be asked to define the base layout of the window.

After closing the window the content will be copied to clipboard and can be pasted / used in the target software.

10.2 Window handling

Since the SGE Circus offers to open a considerable number of windows an automatic window handling feature is implemented. Using the corresponding menu item enables to arrange all or a subset of the windows of the current session.

11 General information

Duplication, processing, distribution or any form of commercialization of the documents content beyond the scope of the copyright law shall require the prior written consent of the SGE Ingenieur GmbH. All trade and product names given in this document may also be legally protected even without special labeling (e.g. as a trademark).


The SGE Circus includes Third Party Software. For details please refer to the → SGE Circus documentation.


SGE Ingenieur GmbH – www.sge-ing.de

Copyright 2011-2022. All rights reserved.