ArrayPlot[array]

generates a plot in which the values in an array are shown in a discrete array of squares.

• ArrayPlot[array] by default arranges successive rows of array down the page and successive columns across, just as a table or grid would normally be formatted. »
• If array contains 0s and 1s, the 1s will appear as black squares and the 0s as white squares.
• ArrayPlot by default generates grayscale output, in which zero values are shown white, and the maximum positive or negative value is shown black. »
• With an explicit setting for PlotRange, ArrayPlot by default makes the minimum value white and the maximum black.
• The values in array can be quantities with units associated with them.
• The following special entries can be used: »

• 	None	background color
  	color directive	specified color

• If array is ragged, shorter rows are treated as padded on the right with background. »
• ArrayPlot has the same options as Graphics, with the following additions and changes: [List of all options]

• 	AspectRatio	Automatic	ratio of height to width
  	ClippingStyle	None	how to show cells whose values are clipped
  	ColorFunction	Automatic	how each cell should be colored
  	ColorFunctionScaling	True	whether to scale the argument to ColorFunction
  	ColorRules	Automatic	rules for determining colors from values
  	DataRange	All	the range of and values to assume
  	DataReversed	False	whether to reverse the order of rows
  	Frame	Automatic	whether to draw a frame around the plot
  	FrameLabel	None	labels for rows and columns
  	FrameTicks	None	what ticks to include on the frame
  	MaxPlotPoints	Infinity	the maximum number of points to include
  	Mesh	False	whether to draw a mesh
  	MeshStyle	GrayLevel[GoldenRatio-1]	the style to use for a mesh
  	PlotLegends	None	legends for datasets
  	PlotRange	All	the range of values to plot
  	PlotTheme	$PlotTheme	overall theme for the plot
  	TargetUnits	Automatic	units to display in the plot

• ColorRules can take the following settings:

• 	Automatic	use default colors
  	"Colors"	use colors for different values
  	"Monochrome"	use grayscale colors
  	{valcolor,…}	use color as the style for val

• The rules given by ColorRules are applied to the value of each cell. The rules can involve patterns. »
• If none of the rules in ColorRules apply, then ColorFunction is used to determine the color.
• With the default setting ColorRules->Automatic, an explicit setting ColorFunction->f is used instead of ColorRules.
• With ColorFunctionScaling->False, each value is supplied as the argument to any function given for ColorFunction. »
• With ColorFunctionScaling->True, the values are scaled to lie between 0 and 1. »
• If the color determined for a particular cell is None, the cell is rendered in the background color.
• If no color is determined for a particular cell, the cell is rendered in a default dark red color.
• With DataReversed->True, the order of rows is reversed, so that rows run from bottom to top, with the last row at the top.
• With the setting FrameTicks->Automatic, ticks are placed at round integers, typically multiples of 5 or 10.
• With the setting FrameTicks->All, ticks are also placed at the minimum and maximum and .
• In explicit FrameTicks specifications, the tick coordinates are taken to refer to and .
• With DataReversed->True, tick values decrease from top to bottom.
• PlotRange->a_max specifies that only those between 0 and a_max should be shown. »
• PlotRange->{a_min,a_max} specifies that between a_min and a_max should be shown.
• PlotRange->{{i_min,i_max},{j_min,j_max}} shows only elements with and in the specified ranges. The top‐left element has , . With the default setting DataReversed->False, increases down the page; increases to the right.
• PlotRange->{ispec,jspec,aspec} shows only elements in the specified ranges of , , and value. »
• With the default setting for ColorFunction, PlotRange->{a_min,a_max} specifies that values from a_min to a_max should be shown with gray scales varying from white to black.
• Possible settings for Mesh include:

• 	False	do not draw any mesh lines
  	True	draw mesh lines between all cells
  	Automatic	draw mesh lines around original cells only
  	"Nonzero"	draw mesh lines around nonzero cells
  	{mi,mj}	use mesh specifications for the i and j directions

• With the default setting Frame->Automatic, a frame is drawn only when Mesh->False.
• For purposes of combining with other graphics, the array element is taken to cover a unit square centered at coordinate position , .
• A setting DataRange->{{x_min,x_max},{y_min,y_max}} specifies that the centers of successive cells should be at equally spaced positions between x_min and x_max in the horizontal direction, and y_min and y_max in the vertical direction. With the default setting DataReversed->False, is centered at {x_min,y_max}.
• With the default setting DataRange->All and DataReversed->False, the array element will be taken to cover a unit square centered at coordinate position , .
• ArrayPlot returns Graphics[Raster[data],opts].
• ArrayPlot works with SparseArray objects. »

List of all options

Highlight options with settings specific to ArrayPlot

• 	AlignmentPoint	Center	the default point in the graphic to align with
  	AspectRatio	Automatic	ratio of height to width
  	Axes	False	whether to draw axes
  	AxesLabel	None	axes labels
  	AxesOrigin	Automatic	where axes should cross
  	AxesStyle	{}	style specifications for the axes
  	Background	None	background color for the plot
  	BaselinePosition	Automatic	how to align with a surrounding text baseline
  	BaseStyle	{}	base style specifications for the graphic
  	ClippingStyle	None	how to show cells whose values are clipped
  	ColorFunction	Automatic	how each cell should be colored
  	ColorFunctionScaling	True	whether to scale the argument to ColorFunction
  	ColorRules	Automatic	rules for determining colors from values
  	ContentSelectable	Automatic	whether to allow contents to be selected
  	CoordinatesToolOptions	Automatic	detailed behavior of the coordinates tool
  	DataRange	All	the range of and values to assume
  	DataReversed	False	whether to reverse the order of rows
  	Epilog	{}	primitives rendered after the main plot
  	FormatType	TraditionalForm	the default format type for text
  	Frame	Automatic	whether to draw a frame around the plot
  	FrameLabel	None	labels for rows and columns
  	FrameStyle	{}	style specifications for the frame
  	FrameTicks	None	what ticks to include on the frame
  	FrameTicksStyle	{}	style specifications for frame ticks
  	GridLines	None	grid lines to draw
  	GridLinesStyle	{}	style specifications for grid lines
  	ImageMargins	0.	the margins to leave around the graphic
  	ImagePadding	All	what extra padding to allow for labels etc.
  	ImageSize	Automatic	the absolute size at which to render the graphic
  	LabelStyle	{}	style specifications for labels
  	MaxPlotPoints	Infinity	the maximum number of points to include
  	Mesh	False	whether to draw a mesh
  	MeshStyle	GrayLevel[GoldenRatio-1]	the style to use for a mesh
  	Method	Automatic	details of graphics methods to use
  	PlotLabel	None	an overall label for the plot
  	PlotLegends	None	legends for datasets
  	PlotRange	All	the range of values to plot
  	PlotRangeClipping	False	whether to clip at the plot range
  	PlotRangePadding	Automatic	how much to pad the range of values
  	PlotRegion	Automatic	the final display region to be filled
  	PlotTheme	$PlotTheme	overall theme for the plot
  	PreserveImageOptions	Automatic	whether to preserve image options when displaying new versions of the same graphic
  	Prolog	{}	primitives rendered before the main plot
  	RotateLabel	True	whether to rotate y labels on the frame
  	TargetUnits	Automatic	units to display in the plot
  	Ticks	Automatic	axes ticks
  	TicksStyle	{}	style specifications for axes ticks

Basic Examples  (6)

Scope  (7)

Options  (96)

Applications  (11)

Plot a two-color cellular automaton evolution:

Plot a three-color cellular automaton evolution:

Use colors rather than gray levels:

Plot the imaginary parts of a Vandermonde matrix for a discrete Fourier transform:

Plot the inverse of a matrix, shading according to absolute value:

Show positive entries as gray and others as yellow:

Create a list of array plots:

Plot a table of values of five sine waves in random directions:

Plot image-processed data:

Plot a color map:

Use a special color for non-numeric data:

Digits of powers of 3 in base 2:

Plot a sparse matrix in black and white:

Properties & Relations  (8)

Possible Issues  (2)

Neat Examples  (2)