Mathematica 9 is now available

SEARCH MATHEMATICA 8 DOCUMENTATION

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

Mathematica > Visualization and Graphics > Charting and Information Visualization > Chart Styling & Layout >

Mathematica > Visualization and Graphics > Data Visualization > Charting and Information Visualization > Chart Styling & Layout >

Built-in Mathematica Symbol

See Also »|More About »

ChartElements

ChartElements
is an option to charting functions such as BarChart that specifies the graphics to use as the basis for bars or other chart elements.

MORE INFORMATION

Elements in charts can be based on any Graphics, Graphics3D or Image object.

The final rendered form of each chart element is obtained by replicating or stretching copies of the base object so as to fill the necessary shape or region.

The following settings for ChartElements can be used:

	None	leave chart elements blank
	Automatic	use a preset default graphic
	g	fill chart elements with copies of g
	{g,All}	stretch a single g to fill each chart element
	{g,{w,h}}	use copies of g with width w and height h
	{g₁,g₂,...}	use g_i for the i element in each dataset
	{spec₁,spec₂,...}	use different specifications for different data dimensions

With a chart element specification of the form {g, {w, h}}, the following width and height specifications can be given:

	s	explicit size in ordinary plot coordinates
	Scaled[s]	size given as a fraction of the chart element region
	Automatic	size determined by the original aspect ratio of g
	All	size that fills the chart element region

Settings for ImageSize and AspectRatio in g are ignored when rendering chart elements, except when w or h is Automatic.

When objects g are rendered for chart elements, their base styles are inherited from the styles defined for each chart element.

Settings for BarOrigin and similar options do not affect either the orientation in which objects g are rendered, or the identification of w and h as width and height.

With ChartElements->{g₁, g₂, ...}, the g_i are used cyclically to render the chart elements for successive elements in each dataset.

With ChartElements->{spec₁, spec₂, ...}, the spec_i are used as chart element specifications for successive dimensions in nested lists of datasets.

ChartElements->{g₁, g₂, ...} is effectively taken to give a specification for the innermost dimension of nested lists of datasets.

Basic Examples (2)

Create a pictorial chart based on any Graphics object:

Create 3D pictorial bars:

Create a pictorial chart based on any Graphics object:

Create 3D pictorial bars:

ChartElementFunction ChartStyle ChartLayout BarChart BarChart3D

Charting and Information Visualization

Chart Labeling, Legending & Annotation

Chart Styling & Layout

New in 7.0: Alphabetical Listing

New in 7

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