Map Grid
The map grid is a 2D representation of a map. It can be use to view and edit sites on the map as well as overlay other objects such as tables and log maps. Its displays the same data as the Map Graph and has much of the same functionality. For how to add objects see the Adding an Object section.
When the map grid has been added you will see something similar to the following:


Selecting and Editing the Map Grid
To select an area on the grid, you can either click and drag using the left mouse button, or use the arrow keys whilst holding down Shift. Once an area is selected holding the Ctrl button down then pressing the arrows keys, will shift the entire selected area in the direction selected.
To select two non-concurrent areas (i.e. at opposite sides of the grid without the positions in between), select an area then whilst holding the Ctrl key, use the left mouse button to select another area.
To edit a point or group of points selected on the grid, either just start typing a number to set the selected points to a specific value, or use the + and - keys to increment up or down. To increment by a larger amount, hold down the Shift key while using + and -.
When online, pressing the Space bar will select the site nearest to the current cursor site.
Displaying the State
By displaying the state of the values on the grid you can see which sites have been edited how they have been edited. To show the state of each site right click on the grid and select properties. From the Properties window set ‘Colour Mode’ to either ‘State’ or ‘State and Gradient’. Setting to ‘State’ will make each site display just its state colour, setting to ‘State and Gradient’ will display a colour for the site value and in the corner of each site display a separate colour for the sites state:
The default colour code for the states are as follows. These can be changed in Configure > Preferences and going to the calibration states in the colours section.
Colour | Dark Mode | State | Description |
---|---|---|---|
White | Button Face | Unchanged | Has not been changed. |
Yellow | Green | Changed | Site has been adjusted by the user. |
Lime | Dark Cyan | Calibrated | This state can be set either manually by the user or when the site has been calibrated using log-mapping (auto mapping). |
Green | Dodger Blue | Calculated | Site has been calculated by GWv4 using a function. |
Grey | Slate Grey | Pasted | Site value as been copied from another map then pasted to the current site. |
Blue | Medium Orchid | Optimised | Site has been set using the Optimise function. |
Orange | Orange | Undone | No longer used since GWv4 4.03.25. You may see this state if the calibration was used with GWv3. |
Red | Red | Bad | GWv4 4.03.25 can not determine the state of this site. It is recommended that you contact GEMS if you see the ‘Bad’ state on a map. |
Locking sites
Locking certain sites in the map can be useful so that accidental changes are not made to known good values. You can do this by right clicking on the grid and selecting ‘Lock Sites with Calibrated State’. When this is set any sites which have been set to calibrated can not be changed. You can also manually set states to being calibrated therefore locked, by right clicking on the grid and selecting State>‘Set State to Calibrated’. To unlock the site select State>‘Set State to unchanged’.
Changing the look of the Map Grid
It is possible to change the way the map grid looks in a multitude of ways. For instance you can remove the change the gradient colour, show sites that have been changed and display the current ECU position.
To change the colour of the map grid, from the Menu select: Configure > Preferences. In the preference window select the colours section. Find the option called ‘Map grid Fill’. From here you can select from many different gradients or create your own.
All other changes are made in the properties of the map grid. By default the properties window is displayed to the left of the workspace, if it is not shown you can right click on the map grid and select properties. The properties for the map grid will then be displayed. An explanation of each option is displayed at the bottom of the properties window, when the property is selected
For more on the properties window, see the Properties Window section.
Soft Selections
The amount of soft selection can be changed by using the selection range property of the map grip. For a full explanation of soft selection see the soft selections section of Map Graph.
Map Grid Functions
See section Map & Table Functions.
View Properties
Properties editable via the properties editor.
Property | Script ID | Description |
---|---|---|
Title | title |
The title of the window. |
Script ID | id |
The scripting ID of the window. Can be used as an alternative to the title for searching for windows from scripts. |
Tool Tip | tooltip |
Window tool tip. |
Display Units | display_units_text |
Show units after the number on the view. |
Display Units (Label) | display_units_label |
Show units after the label on the view. |
Prefix Text | prefix_text |
Text to display before the value. |
Postfix Text | postfix_text |
Text to display after the value. |
Limits | limits |
Set up alarm limits for this gauge. |
Show Value | show_value |
|
Show Label | show_label |
|
Label Font | label_font |
|
Value Font | value_font |
|
Value Height % | value_height_percent |
A value of zero disables auto font size fitting if Value Height Max is set |
Value Height Max [dp] | value_height_max_dp |
Maximum font height of the value text, in device pixels |
Label Height % | label_height_percent |
|
Label Height Max [dp] | label_height_max_dp |
Maximum font height of the label, in device pixels |
Label Text | label_text |
|
Label Align | label_align |
|
Label Vertical Align | label_valign |
|
Value Align | value_align |
|
Value Vertical Align | value_valign |
|
Low Limit Text | low_limit_text |
|
High Limit Text | high_limit_text |
|
Value Override Text | value_text |
|
Max length Text | max_length_text |
Leave blank for auto |
Background | bg_colour |
Background colour |
Text | text_colour |
Text colour |
Alarm Low Background | alarm_low_bg_colour |
Alarm Lower Limit Background colour |
Alarm Low Text | alarm_low_text_colour |
Alarm Lower Limit Text colour |
Alarm High Background | alarm_high_bg_colour |
Alarm Upper Limit Background colour |
Alarm High Text | alarm_high_text_colour |
Alarm Upper Limit Text colour |
Input Value | parameter |
The source of the value that will be displayed by the gauge. |
Update Rate | update_rate |
Rate at which the input value is requested from the ECU. |
Decimal Places | decimal_places |
Set to -1 for auto |