Mathematica 9 is now available

THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.

DOCUMENTATION CENTER SEARCH

New to Mathematica? Find your learning path »

Mathematica > Notebooks and Documents > Layout & Tables > Grids & Tables > GraphicsGrid >

Mathematica > Visualization and Graphics > Data Visualization > Layout & Tables > Grids & Tables > GraphicsGrid >

Mathematica > Data Manipulation > Statistical Data Analysis > Statistical Visualization > Data Visualization > Layout & Tables > Grids & Tables > GraphicsGrid >

GraphicsGrid

generates a graphic in which the

are laid out in a two-dimensional grid.

MORE INFORMATION

If the are graphics with ImageSize->Automatic, GraphicsGrid will if possible resize them to make them fit into the grid as well as possible, while preserving their individual aspect ratios.

The output from GraphicsGrid can interactively be resized, or edited as a graphic.

The in GraphicsGrid do not all need to be the same length; there will be empty space in the grid at the ends of shorter rows.

You can specify that an element e should span multiple positions in a grid using, for example, GraphicsGrid[{{e, SpanFromLeft, SpanFromLeft}, ...}].

The following specify that a particular position should be spanned:

	SpanFromLeft	span from left
	SpanFromAbove	span from above
	SpanFromBoth	span from both left and above

A particular element can span both multiple rows and multiple columns by having a rectangular section of the array with the form {{e, SpanFromLeft, SpanFromLeft, ...}, {SpanFromAbove, SpanFromBoth, SpanFromBoth, ...}, ...}.

The following options can be given:

	Alignment	{Center,Center}	horizontal and vertical alignment of elements
	AspectRatio	Automatic	ratio of height to width for the whole grid
	Background	None	what background colors to use
	BaselinePosition	Automatic	what to align with the surrounding text baseline
	BaseStyle	{}	base style specifications for the grid
	Dividers	None	where to draw divider lines in the grid
	Frame	None	where to draw frames in the grid
	FrameStyle	Automatic	styles to use for frames
	ImageSize	Automatic	overall size of the whole graphics grid
	ItemAspectRatio	Automatic	ratio of height to width for each item
	Spacings	Scaled[0.1]	horizontal and vertical spacings

With AspectRatio->Automatic, the aspect ratio of the whole graphics grid will be chosen so as to best fit the individual objects in the grid.

Settings for the options Alignment, Background, and Framecan be given as follows to apply separately to different items:

	spec	apply spec to all items
	{spec_x}	apply at successive horizontal positions
	{spec_x,spec_y}	apply at successive horizontal and vertical positions
	${spec_(x),spec_(y),rules}$	also allow explicit rules for individual elements

The can have the following forms:

	{s₁,s₂,...,s_n}	use through , then use defaults
	{{c}}	use in all cases
	{{c₁,c₂}}	alternate between and
	{{c₁,c₂,...}}	cycle through all
	{s,{c}}	use , then repeatedly use
	{s₁,{c},s_n}	use , then repeatedly use , but use at the end
	{s₁,s₂,...,{c₁,c₂,...},s_m,...,s_n}	use the first sequence of at the beginning, then cyclically use the , then use the last sequence of at the end
	{s₁,s₂,...,{},s_m,...,s_n}	use the first sequence of at the beginning and the last sequence at the end
	{i₁->v₁,i₂->v₂,...}	specify what to use at positions
	{spec,rules}	use rules to override specifications in spec

With settings of the form , if there are more specified than items across the grid, from the beginning are used for the first items, and ones from the end are used for the last items.

Settings such as Alignment, Background, and Frame can effectively be specified for individual items in the grid using Item.

GraphicsGrid will not change the size of graphics or other objects that have explicit ImageSize settings, unless the GraphicsGrid itself is resized or given an overall ImageSize setting.

Common settings for Frame include:

	None	no frame
	True	frame around the whole grid
	All	frame around every item in the grid
	{All,False}	put a frame at every horizontal position (column lines)
	{False,All}	put a frame at every vertical position (row lines)

Settings for Dividers and Spacings can have the following forms:

	spec	apply spec to all gaps between items
	{spec_x,spec_y}	apply to successive horizontal and vertical gaps

The can have the same forms as for Alignment, Background, and other item-oriented options.

For a grid with items in a particular direction, Dividers and Spacings can specify settings for the gaps between elements, starting before the first element and ending after the last element.

The following settings can be used for BaselinePosition:

	Axis	axis of the middle row in the grid (default)
	Baseline	baseline of the middle row in the grid
	Bottom	bottom of the whole grid
	Center	halfway from top to bottom
	Top	top of the whole grid
	{{i,j},pos}	position pos in element

The settings for BaseStyle are appended to the default style typically given by the style in the current stylesheet.

Basic Examples (2)

Display elements in a graphics grid:

Put a frame around every element:

Display elements in a graphics grid:

Out[1]=

Put a frame around every element:

Out[1]=

Put a frame around the whole grid:

Put a frame around every element:

Draw all the frames in red:

Put a frame around the first row and column:

Draw different frames with different styles:

Put dividers at all horizontal positions:

Put dividers at all vertical positions:

Put dividers at the third horizontal and second vertical positions:

Make element 4 span the column to its right:

Make it span two columns:

Make element 2 span the row below it:

Make it span two rows:

Span throughout a 2×2 block:

Align contents to the left:

Align contents to the right:

Draw the grid with a pink background:

A pink background for the column at the first horizontal position:

Alternating pink and yellow at successive vertical positions:

Alternating pink and yellow at successive horizontal positions:

Embed styling options with a particular grid item:

Set the spacing between items:

Set the horizontal and vertical spacings separately:

The overall aspect ratio is automatically adjusted for irregular shapes:

Grids can be nested:

If possible GraphicsGrid will choose an aspect ratio suitable to its elements:

When no reasonable choice can be made, a default aspect ratio of 1 is used:

Setting the aspect ratio of each item explicitly:

Draw the grid with a pink background:

Pink and red backgrounds for the first and second horizontal positions:

An equivalent syntax:

Pink and red backgrounds for the first and second vertical positions:

Alternating pink and red backgrounds:

Alternating backgrounds with yellow superimposed in the first and last positions:

Blending of colors:

Set the background for specific items:

Set the background for a subregion of the grid:

Align the center of the grid with the baseline of surrounding text:

Align the bottom of the grid with the baseline:

Frame the entire grid:

Frame all elements in the grid:

Frame specific elements:

Frame a region:

FrameStyle supports a variety of graphics directives:

FrameStyle is applied to all sources of grid lines, including Dividers and Item:

Directives given with FrameStyle are combined with those specified elsewhere:

By default, GraphicsGrid will display graphics at their specified sizes:

Giving an ImageSize setting to the GraphicsGrid will scale the graphics appropriately:

Applications (2)

Make a picture of the first 64 elementary cellular automata:

Show a collection of discrete mappings:

Possible Issues (1)

To span across both rows and columns requires appropriate use of SpanFromBoth:

GraphicsRow GraphicsColumn Grid Inset PackingMethod

Grids, Rows, and Columns in Mathematica

Redrawing and Combining Plots

Formatted Output

TUTORIAL COLLECTION

Grids, Rows, and Columns in Mathematica

New in 6

Ask a question about this page | Suggest an improvement | Leave a message for the team

Format: HTML | CDF