WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

GraphicsGrid
✖
GraphicsGrid

✖
GraphicsGrid[{{g11,g12,…},…}]

generates a graphic in which the gij are laid out in a two-dimensional grid.

Details and Options

  • If the gij 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 listi in GraphicsGrid[{list1,list2,…}] 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:
  • SpanFromLeftspan from left
    SpanFromAbovespan from above
    SpanFromBothspan 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 Automaticratio of height to width for the whole grid
    Background Nonewhat background colors to use
    BaselinePosition Automaticwhat to align with the surrounding text baseline
    BaseStyle{}base style specifications for the grid
    DividersNonewhere to draw divider lines in the grid
    Frame Nonewhere to draw frames in the grid
    FrameStyle Automaticstyles to use for frames
    ImageSize Automaticoverall size of the whole graphics grid
    ItemAspectRatioAutomaticratio of height to width for each item
    SpacingsScaled[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 Frame can be given as follows to apply separately to different items:
  • specapply spec to all items
    {specx}apply specx at successive horizontal positions
    {specx,specy}apply speck at successive horizontal and vertical positions
    {spec_(x),spec_(y),rules}also allow explicit rules for individual elements
  • The speck can have the following forms:
  • {s1,s2,…,sn}use s_(1) through s_(n), then use defaults
    {{c}}use c in all cases
    {{c1,c2}}alternate between c_(1) and c_(2)
    {{c1,c2,…}}cycle through all ci
    {s,{c}}use s, then repeatedly use c
    {s1,{c},sn}use s_(1), then repeatedly use c, but use s_(n) at the end
    {s1,s2,…,{c1,c2,…},sm,…,sn}use the first sequence of s_i at the beginning, then cyclically use the ci, then use the last sequence of s_i at the end
    {s1,s2,…,{},sm,…,sn}use the first sequence of s_i at the beginning and the last sequence at the end
    {i1->v1,i2->v2,…}specify what to use at positions ik
    {spec,rules}use rules to override specifications in spec
  • With settings of the form {s_(1),s_(2),...,{...},s_(m),...,s_(n)}, if there are more s_i specified than items across the grid, s_i 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:
  • Noneno frame
    Trueframe around the whole grid
    Allframe 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:
  • specapply spec to all gaps between items
    {specx,specy}apply speci to successive horizontal and vertical gaps
  • The speci 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:
  • Axisaxis of the middle row in the grid (default)
    Baselinebaseline of the middle row in the grid
    Bottombottom of the whole grid
    Centerhalfway from top to bottom
    Toptop 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 "GraphicsGrid" style in the current stylesheet.

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Display elements in a graphics grid:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-dq0efw
Out[1]=1

Put a frame around every element:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-d6xett
Out[1]=1

Scope  (17)Survey of the scope of standard use cases

Frames and Grid Lines  (5)

Put a frame around the whole grid:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-bbpa2o
Out[1]=1

Put a frame around every element:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-gsc84x
Out[1]=1

Draw all the frames in red:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-2mnjal
Out[2]=2

Put a frame around the first row and column:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-cbpht5
Out[1]=1

Draw different frames with different styles:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-ud2x0h
Out[2]=2

Put dividers at all horizontal positions:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-mo15iw
Out[1]=1

Put dividers at all vertical positions:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-e7ls8
Out[2]=2

Put dividers at the third horizontal and second vertical positions:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-k67otn
Out[1]=1

Spanning Elements  (3)

Make element 4 span the column to its right:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-4x9p6q
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-f1j5kh
Out[2]=2

Make it span two columns:

In[3]:=3
✖
https://wolfram.com/xid/0tz1qxfu-bigdgf
Out[3]=3

Make element 2 span the row below it:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-qmjl6t
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-bjilaz
Out[2]=2

Make it span two rows:

In[3]:=3
✖
https://wolfram.com/xid/0tz1qxfu-j9ntkl
Out[3]=3

Span throughout a 2×2 block:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-wpb53j
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-n5900p
Out[2]=2

Alignment  (1)

Align contents to the left:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-nif40x
Out[1]=1

Align contents to the right:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-c5srl3
Out[2]=2

Styling  (5)

Draw the grid with a pink background:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-lqbfpn
Out[1]=1

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-bnroag
Out[1]=1

Alternating pink and yellow at successive vertical positions:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-dpn9cb
Out[1]=1

Alternating pink and yellow at successive horizontal positions:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-uzsaa
Out[1]=1

Embed styling options with a particular grid item:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-g0cn6a
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-ku8z1q
Out[2]=2

Spacing  (1)

Set the spacing between items:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-8dm3c
Out[1]=1

Set the horizontal and vertical spacings separately:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-hc29nd
Out[2]=2

Irregular Shapes  (1)

The overall aspect ratio is automatically adjusted for irregular shapes:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-h3v88d
Out[1]=1

Nested Grids  (1)

Grids can be nested:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-gmjqxb
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-by63j9
Out[2]=2

Options  (17)Common values & functionality for each option

AspectRatio  (2)

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-1vxnay
Out[1]=1

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

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-wjqqwq
Out[2]=2

Setting the aspect ratio of each item explicitly:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-yit0a3
Out[1]=1

Background  (7)

Draw the grid with a pink background:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-l5rbwg
Out[1]=1

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-4y5go5
Out[1]=1

An equivalent syntax:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-zqd9oa
Out[2]=2

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-jgne6m
Out[1]=1

Alternating pink and red backgrounds:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-57g14a
Out[1]=1

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

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-hpart3
Out[2]=2

Blending of colors:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-iz40di
Out[1]=1

Set the background for specific items:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-xouktx
Out[1]=1

Set the background for a subregion of the grid:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-hrrawi
Out[1]=1

BaselinePosition  (1)

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-so18k
Out[1]=1

Align the bottom of the grid with the baseline:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-ouy59i
Out[2]=2

Frame  (3)

Frame the entire grid:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-g0bq69
Out[1]=1

Frame all elements in the grid:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-l4571h
Out[1]=1

Frame specific elements:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-slzmw9
Out[1]=1

Frame a region:

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-08v9uz
Out[2]=2

FrameStyle  (3)

FrameStyle supports a variety of graphics directives:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-7jhzp1
Out[1]=1

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-xqqb6j
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-fcx7w4
Out[2]=2

Directives given with FrameStyle are combined with those specified elsewhere:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-ynfrbu
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-679ofv
Out[2]=2

ImageSize  (1)

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-54o599
Out[1]=1

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

In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-do170k
Out[2]=2

Applications  (2)Sample problems that can be solved with this function

Make a picture of the first 64 elementary cellular automata:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-cpt5v
Out[1]=1

Show a collection of discrete mappings:

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-7ln02o
Out[1]=1

Possible Issues  (1)Common pitfalls and unexpected behavior

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

In[1]:=1
✖
https://wolfram.com/xid/0tz1qxfu-ffm7z7
In[2]:=2
✖
https://wolfram.com/xid/0tz1qxfu-7kfcna
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0tz1qxfu-8z5anv
Out[3]=3
Wolfram Research (2007), GraphicsGrid, Wolfram Language function, https://reference.wolfram.com/language/ref/GraphicsGrid.html.
✖
Wolfram Research (2007), GraphicsGrid, Wolfram Language function, https://reference.wolfram.com/language/ref/GraphicsGrid.html.

Text

Wolfram Research (2007), GraphicsGrid, Wolfram Language function, https://reference.wolfram.com/language/ref/GraphicsGrid.html.

✖
Wolfram Research (2007), GraphicsGrid, Wolfram Language function, https://reference.wolfram.com/language/ref/GraphicsGrid.html.

CMS

Wolfram Language. 2007. "GraphicsGrid." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/GraphicsGrid.html.

✖
Wolfram Language. 2007. "GraphicsGrid." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/GraphicsGrid.html.

APA

Wolfram Language. (2007). GraphicsGrid. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GraphicsGrid.html

✖
Wolfram Language. (2007). GraphicsGrid. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GraphicsGrid.html

BibTeX

@misc{reference.wolfram_2025_graphicsgrid, author="Wolfram Research", title="{GraphicsGrid}", year="2007", howpublished="\url{https://reference.wolfram.com/language/ref/GraphicsGrid.html}", note=[Accessed: 25-March-2025 ]}

✖
@misc{reference.wolfram_2025_graphicsgrid, author="Wolfram Research", title="{GraphicsGrid}", year="2007", howpublished="\url{https://reference.wolfram.com/language/ref/GraphicsGrid.html}", note=[Accessed: 25-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_graphicsgrid, organization={Wolfram Research}, title={GraphicsGrid}, year={2007}, url={https://reference.wolfram.com/language/ref/GraphicsGrid.html}, note=[Accessed: 25-March-2025 ]}

✖
@online{reference.wolfram_2025_graphicsgrid, organization={Wolfram Research}, title={GraphicsGrid}, year={2007}, url={https://reference.wolfram.com/language/ref/GraphicsGrid.html}, note=[Accessed: 25-March-2025 ]}