where:

To specify the series or expression whose values will determine the background color:

where spec is a series name or expression.

To specify the minimum and maximum values where the coloring begins and ends:

To set the missing value (NA) background color:

where color_arg is described below in “Color definitions”. If omitted, the color defaults to “white”.

There are optional type-specific arguments that correspond to each of the type choices:

To set the single background color:

where color_arg is described below in “Color definitions”. If omitted, the color defaults to “white”.

You may set the color for both the non-negative (posclr) and the negative (negclr) values

where color_arg is described below in “Color definitions”. If omitted, the non-negative color defaults to “white” and the negative color defaults to light-red.

To specify the range, you must specify the range endpoints:

where range_def specifies the range endpoints:

By default, the range will be open on the lower and closed on the upper threshold limits.

You should provide a color specification for the inside range color (inclr) and outside range color (outclr):

where color_arg is described below in “Color definitions”. If omitted, the interior color defaults to light-red, and the exterior defaults to white.

When “type=hilo” you may specify the high, low, and median coloring values:

where color_arg is described below in “Color definitions”. If omitted, the colors default to light-red.

When “type=custom” you may specify custom coloring options.

You may optionally set a base background color, and then add one or more custom threshold or range color specifications. Multiple threshold and range specifications will layer, with the first applied first, followed by the second, and so on.

To set the base color (optional):

as described below in “Color definitions”. If omitted, the color defaults to “white”.

To add a threshold specification:

where threshold_spec is one of

and the below_arg and above_arg are one of

and color_arg are as described below in “Color definitions”. If omitted, the color defaults to “white”.

The optional threshold_name argument may be used to attach a name to the corresponding definition.

To add a range specification:

where range_spec is one of

outside_arg is one of

color_arg1 and color_arg2 are as described below in “Color definitions”.

The optional range_name argument may be used to attach a name to the corresponding definition.

color_arg specifies the color to be employed in the arguments above. The color may be specified using predefined color names, by specifying the individual red-green-blue (RGB) components using the special “@RGB” function, or by specifying the individual red-green-blue (RGB) components in hexadecimal using the special “@HEX” function.

The predefined colors are given by the keywords (with their RGB and HEX equivalents):

To set a gray fill color for the shapes, you may use:

To set a fill color for negative values, you may use

which sets the fill color to white for non-negative values and light red for negative values of SER1.

Similarly,

sets the background sheet fill color to @rgb(10, 20, 30) for non-negative values and purple for negative values of SER1.

Range coloring may be specified using the “type=range” option. The command

sets the background fill to @rgb(128, 0, 128) for values between 10 and 20, light-red to values outside of the range 10 to 20, and green, for missing values.

Custom coloring allows you to construct more complex background filling:

See “Geomaps” for a discussion of geomaps. See “Value-Based Text and Fill Coloring” for discussion of color settings.

See also Geomap::options for options to control the shape border color and legend.