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:

Map Grid Map Grid

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.

PropertyScript IDDescription
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