The NetLogo palette extension offers the user more control over their colors. The colors go beyond NetLogo colors, including ColorBrewer color schemes and arbitrary RGB colors. Additionally, users can control specific components of their color such as alpha, hue and red.
To get started with palettes add to the top of your Code tab:
extensions [palette]
you can then call any of the primitives by adding palette: before the primitive:
palette:hue-of
palette:set-saturation
palette:scale-gradient
palette:scale-scheme
The degree to which one can see through a color can also be specified by referring to transparency. Transparency is in the range 0 to 100, with 0 fully opaque and 100 fully transparent. Transparency is not stored as part of a color, but is mathematically converted to and from alpha.
Colors can also be specified (but not stored as color values) by reference to HSB - hue, saturation and brightness.
Palette primitives allow the user to:
The user can also create color gradients and access ColorBrewer color schemes.
You can make a turtle more transparent by decreasing alpha, or increasing transparency. A similar approach can be used to adjust color components such as brightness. Here are two examples:
ask turtles [ palette:set-transparency palette:transparency + 10 ]
ask turtles [ palette:set-alpha .9 * palette:alpha ]
Because an error will result if the value passed to a set command is not in the correct range, a little additional code is sometimes needed.
ask turtles [ palette:set-transparency min list 100 (palette:transparency + 10) ]
ask turtles [ palette:set-alpha max list 0 (palette:alpha - 25.5) ]
ColorBrewer has three kinds of color schemes: Sequential, Divergent and Qualitative. Although choosing a color palette is a design problem that does not have a single solution we offer the following guidelines for choosing colors for a NetLogo model:
You can learn more about the use of these color collections in the original ColorBrewer paper (Harrower, Brewer 2003), which focuses on their application to maps. See (Kornhauser, Wilensky, and Rand 1999) for design guidelines for visualization of Agent Based Models.
The answer depends on the focus of the user experience.
For example, gradients are more aesthetic thus are more memorable than discrete colors. Consequently, a gradient can be a better choice for presentations where the main goal of the image is to be attractive and memorable. However, binning values in a discrete set of colors simplifies tasks such as estimation and counting by removing unnecessary detail and focusing on the big picture. Thus, discrete colors can be a better choice for a written document for which the user will have the time and interest to study the visualization.
In order to see the difference you can turn on and off the gradient in the Heat Diffusion model. You can observe that turning gradient on makes the model more aesthetic, but it becomes harder to estimate the value of a patch at a given position.
There are a few examples of using the palette primitives in the Code Examples section of the models library:
And one Sample Model that uses the extension:
palette:alpha-of
palette:with-alpha
palette:alpha
palette:set-alpha
palette:transparency-of
palette:with-transparency
palette:transparency
palette:set-transparency
palette:hue-of
palette:with-hue
palette:hue
palette:set-hue
palette:saturation-of
palette:with-saturation
palette:saturation
palette:set-saturation
palette:brightness-of
palette:with-brightness
palette:brightness
palette:set-brightness
palette:R-of
palette:with-R
palette:R
palette:set-R
palette:G-of
palette:with-G
palette:G
palette:set-G
palette:B-of
palette:with-B
palette:B
palette:set-B
palette:scale-gradient
palette:scale-gradient-hsb
palette:scheme-colors
palette:scale-scheme
palette:scheme-dialog
Reports a value in the range 0 to 255 representing the alpha of the given NL, RGB or RGBA color. The alpha value of an NL or RGB color is 255.
Example:
show palette:alpha-of red ;; 255
show palette:alpha-of [3 14 159 26] ;; 26
Reports an RGBA color with alpha component equal to number and the RGB content of color. An error message results if alpha is not in the range from 0 to 255.
Example:
show [12 34 55 6] palette:with-alpha 99 ;; [12 34 55 99]
Get the alpha value of the color of the agent. The alpha value of an NL or RGB color is 255.
Example:
show [palette:alpha] of turtles
Set the color of the agent to the RGBA color with alpha value number and the RGB content of the color of the turtle or link (or patch in NetLogo3D). An error message results if number is not in the range 0 to 255.
Example:
ask turtles [palette:set-alpha 100]
Reports a value in the range 0 to 100 representing the percent transparency of the given NL, RGB or RGBA color. The percent transparency of an NL or RGB color is 0.
Example:
show palette:transparency-of [100 100 100 100] ;; 60.7843137254902
show palette:transparency-of red ;; 0
Reports an RGBA color with an alpha value equivalent to the transparency number and the RGB content of color. An error message results if number is not in the range 0 to 100.
Example:
show red palette:with-transparency 100 ;; [215 50 41 0]
Reports the transparency equivalent of the agent’s alpha.
Example:
show [palette:transparency] of turtles
Set the color of the agent to the RGBA color with alpha value equivalent to the transparency number and the RGB content of the color of the turtle or link. An error message results if number is not in the range 0 to 100.
Example:
ask turtles [palette:set-transparency 30]
Reports a value in the range 0 to 360 representing the hue component in HSB color space of the given NL, RGB or RGBA color.
Example:
show palette:hue-of red ;; 3.103
Reports an RGBA color with hue component in HSB color space equal to number and the other HSB components of the input color unchanged. An error message results if number is not in the range 0 to 360.
Example:
show red palette:with-hue 100 ;; [99 215 41]
Reports a number in the range 0 to 360 that represents the hue of an agent’s color or pcolor.
Example:
crt 1 [set color red]
[palette:hue] of turtle 0 ;; 3.103
Changes an agent’s hue value to number, leaving the other HSB components unchanged. An error message results if number is not in the range from 0 to 360.
Example:
ask turtles [palette:set-hue 30]
Reports a value in the range 0 to 100 representing the saturation component in HSB color space of the given NL, RGB or RGBA color.
Example:
show palette:saturation-of red ;; 80.93
Reports an RGBA color with saturation component in HSB color space equal to number and the other HSB components of the input color unchanged. An error message results if number is not in the range 0 to 100.
Example:
show red palette:with-saturation 50 ;; [215 113 108]
Reports a number in the range 0 to 100 that represents the saturation of an agent’s color or pcolor.
Example:
crt 1 [set color red]
[palette:saturation] of turtle 0 ;; 80.93
Changes an agent’s saturation leaving the other HSB components unchanged. An error message results if number is not in the range from 0 to 100.
Example:
ask turtles [palette:set-saturation 30]
Reports a value in the range 0 to 100 representing the brightness component in HSB color space of the given NL, RGB or RGBA color.
Example:
show palette:brightness-of red ;; 84.314
Reports an RGBA color with brightness component in HSB color space equal to number and the other HSB components of the input color unchanged. An error message results if number is not in the range 0 to 100.
Example:
show red palette:with-brightness 50 ;; [128 30 24]
Reports a number in the range 0 to 100 that represents the brightness of an agent’s color or pcolor.
Example:
crt 1 [set color red]
[palette:brightness] of turtle 0 ;; 84.314
Changes an agent’s brightness leaving the other HSB components unchanged. An error message results if number is not in the range from 0 to 100.
Example:
ask turtles [palette:set-brightness 30]
Reports a value in the range 0 to 255 representing the red component in the RGB color space of the given NL, RGB or RGBA color.
Example:
show palette:R-of red ;; 215
Reports an RGBA color with red component in RGB color space equal to number and the other RGB components of the input color unchanged. An error message results if number is not in the range 0 to 255.
Example:
show red palette:with-R 50 ;; [50 50 41]
Reports a number in the range 0 to 255 that represents the red of an agent’s color or pcolor.
Example:
crt 1 [set color red]
[palette:R] of turtle 0 ;; 215
Changes an agent’s red component of its RGB/A color leaving the other RGB components unchanged. An error message results if number is not in the range from 0 to 255.
Example:
ask turtles [palette:set-R 30]
Reports a value in the range 0 to 255 representing the green component in the RGB color space of the given NL, RGB or RGBA color.
Example:
show palette:G-of red ;; 50
Reports an RGBA color with green component in RGB color space equal to number and the other RGB components of the input color unchanged. An error message results if number is not in the range 0 to 255.
Example:
show red palette:with-G 56 ;; [215 56 41]
Reports a number in the range 0 to 255 that represents the green of an agent’s color or pcolor.
Example:
crt 1 [set color red]
[palette:G] of turtle 0 ;; 50
Changes an agent’s green component of its RGB/A color leaving the other RGB components unchanged. An error message results if number is not in the range from 0 to 255.
Example:
ask turtles [palette:set-G 30]
Reports a value in the range 0 to 255 representing the blue component in the RGB color space of the given NL, RGB or RGBA color.
Example:
show palette:B-of red ;; 41
Reports an RGBA color with blue component in RGB color space equal to number and the other RGB components of the input color unchanged. An error message results if number is not in the range 0 to 255.
Example:
show red palette:with-B 56 ;; [215 50 56]
Reports a number in the range 0 to 255 that represents the blue of an agent’s color or pcolor.
Example:
crt 1 [set color red]
[palette:B] of turtle 0 ;; 41
Changes an agent’s blue component of its RGB/A color leaving the other RGB components unchanged. An error message results if number is not in the range from 0 to 255.
Example:
ask turtles [palette:set-B 30]
Reports an RGB color proportional to number using a gradient generated with rgb-color-list. The rgb-color-list is a list containing NL or RGB colors: e.g. [NL1 [r1 g1 b1] [r2 g2 b2] [r3 g3 b3] NL2 …].
When range1 is less than or equal to range2, the color will be directly mapped to gradient colors. When range2 is less than range1, the color gradient is inverted.
Let min-range be the minimum of range1 and range2. If number is less than or equal to min-range, then the result is the same as if number was equal to min-range.
Let max-range be the maximum of range1 and range2. If number is greater than max-range, then the result is the same as if number was equal to max-range.
Example:
ask patches
[
set pcolor palette:scale-gradient [[255 0 0] [0 0 255]] pxcor min-pxcor max-pxcor
]
;; colors each patch with a color proportional to the gradient
Reports an RGB color equivalent to a color in HSB space proportional to number using a gradient generated with hsb-list. The hsb-list is a list containing three-element lists of HSB colors: [[h1 s1 b1] [h2 s2 b2] [h3 s3 b3] …].
When range1 is less than or equal to range2, the HSB color will be directly mapped to gradient HSB colors. When range2 is less than range1, the color gradient is inverted.
Let min-range be the minimum of range1 and range2. If number is less than or equal to min-range, then the result is the same as if number was equal to min-range.
Let max-range be the maximum of range1 and range2. If number is greater than max-range, then the result is the same as if number was equal to max-range.
Example:
ask patches
[
ask patches [set pcolor palette:scale-gradient-hsb [[200 50 50] [100 60 70]] pxcor min-pxcor max-pxcor]
]
;; colors each patch with a color proportional to the gradient
Reports a list of RGB colors using ColorBrewer scheme of type scheme-type with name scheme-color containing number-of-classes colors. Scheme types are “Sequential,” “Divergent” and “Qualitative.” The choice of scheme names depends on the scheme type and includes “Reds”, “Spectral” and “Set1”. The minimum number of colors is 3 and a maximum is between 8 and 12 depending on the color scheme. For more information go to http://www.colorbrewer.org.
Example:
show palette:scheme-colors "Divergent" "Spectral" 3
=> [[252 141 89] [255 255 191] [153 213 148]]
; The scheme-colors primitive can be used with the scale-gradient primitive.
ask patches
[set pcolor palette:scale-gradient palette:scheme-colors "Divergent" "Spectral" 9 pxcor min-pxcor max-pxcor]
Reports an RGB color from the ColorBrewer scheme of type scheme-type with name scheme-color containing number-of-classes colors. The color is chosen using the proportionality of number in the range specified by range1 and range2.
When range1 is less than or equal to range2, the colors are ordered as in the ColorBrewer scheme. When range2 is less than range1, the color order is reversed.
Let min-range be the minimum of range1 and range2. If number is less or equal to than min-range, then the result is the same as if number was equal to min-range. This will be the first color in the color list if range1 is less than range2.
Let max-range be the maximum of range1 and range2. If number is greater than max-range, then the result is the same as if number was equal to max-range. This will be the last color in the color list if range1 is less than range2.
Example:
ask patches
[
set pcolor palette:scale-scheme "Divergent" "Spectral" 8 pxcor min-pxcor max-pxcor
]
;; colors each patch with a color from the Color Brewer Schemes
Launches a dialog for previewing all the ColorBrewer color schemes.
Use the leftmost pulldown menu to select the scheme type: “Sequential,” “Divergent” or “Qualitative.” Use the next pulldown menu to select a named scheme. Finally select the number of colors. The maximum number depends on the color scheme. Use the Copy button to copy the scheme information into the clipboard. This information can be pasted into commands such as palette:scheme-colors. The Close button can be used to close the dialog.
Example:
palette:scheme-dialog
;; In the dialog the user selects scheme type "Divergent," the scheme named "Spectral," and the number 3, and clicks the *Copy* button.
;; In the Command Center the user types "show palette:scheme-colors " and then pastes the clipboard contents, and hits *Enter*.
show palette:scheme-colors "Divergent" "Spectral" 3
=> [[252 141 89] [255 255 191] [153 213 148]]
ColorBrewer www.colorbrewer.org
HARROWER, M. and C. BREWER (2003). ColorBrewer: An online tool for selecting color schemes for maps. The Cartographic Journal 40(1): 27-37. )
HEALEY, C G (2006) Perception in Visualization, (comprehensive review updated regularly).
HEALEY, C G, BOOTH K S, and ENNS, J T (1995). Visualizing Real-Time Multivariate Data Using Preattentive Processing. ACM Transactions on Modeling and Computer Simulation 5, 3, 190-221.
KORNHAUSER, D, WILENSKY, U and RAND, W (1999). Design Guidelines for Agent Based Model Visualization. Journal of Artificial Societies and Social Simulation 12(2)1.
TUFTE, E (1983) The Visual Display of Quantitative Information, Graphics Press.
WARE, C (2004) Information Visualization, 2nd Ed., Morgan Kaufmann.