General


Report Design Component Palette Icon:




IULocgo

Bar Chart


Description

A Bar Chart is used to display data in a chart using bars. A Bar Chart typically contains a single string column that gets used as the Domain with as many other columns representing the Range axis values. The order of the dataset matters, and the string values used for the domain should be in the first column of the dataset.


Properties
Configure TabProperty/SymbolDescription

Data KeyUnique identifier or placeholder to the data source that will populate the chart.
Extract Order

The order in which the data should be extracted from the data key. Two options are available:

Row: Data is extracted by row. Use this when columns in the data key define the series of data.

Column: data is extracted by column. Use this when rows in the data key define the series of data; each column is a new value for the same series. This is sometimes referred to as data 'turned on its side'

Options

3D: Columns and bars with 3D appearance using angle and depth.

Pareto: When enabled, turns the chart into a Pareto chart. Contains both lines and a bar graph where values are in descending order.

Render Style

Provides three rendering styles:

Bars: Displays data as individual colored bars.

Stacked: Displays data as a stacked bar in different colors.

Layered: Displays data as a layered bar in different colors.

Segment ColorsA unique color in the RGBA color space for each segment (bar). See Color Selector.

Color Wheel

Tool for creating color combinations for bars. See Color Selector.

Add Segment

Adds a color / row.

Remove Segment

Deletes a color / row.
Scripting EnabledEnables the script for this component to run.

Edit Script 

Allows the chart to be modified before the report is rendered.
Properties TabPropertyDescriptionCategory

Data KeyData key of the dataset that drives this pie chart.Chart Options
Category MarginSpacing between groups of bars on the chart.Chart Options
Extract OrderDetermines whether the series are defined by rows or columns in the underlying dataset.Chart Options
Item MarginSpacing between bars within a group.Chart Options
Render StyleStyle for this bar chart. Options are bars (0), stacked (1), or layered (2).Chart Options
3D BarsIf true, use 3D bars to draw chart.Chart Options
Show LegendIf true, show the chart's legend.Chart Options
Legend FontFont to use for the chart's legend.Chart Options
Vertical ChartIf true, draw bars vertically.Chart Options
ParetoIf enabled, the chart will act as a pareto chart; ordering the bars descending and adding a percentage line.Pareto Options
80% LineIf true, draw a line showing where 80% of the total is.Pareto Options
Pareto ColorColor for the Pareto line and 80% line.Pareto Options
Pareto Series LabelText to use in legend for the Pareto line.Pareto Options
Axis AutorangeIf true, set the axis range automatically, otherwise use the Axis Low and Axis High values.Axis Options
Axis FontFont to use for axis and axis label.Axis Options
AxisFormatA optional number format string to override the automatic formatting on the y-axis.Axis Options
Axis LabelText to place on the axis label. May be blank.Axis Options
Axis LowIf autorange is turned of, the low value to use for the axis.Axis Options
Axis HighIf autorange is turned off, the high value to use for the axis.Axis Options
Label PositionOrientation of category labels.Axis Options
Bar LabelsIf true, add labels to each bar.Label Options
Label ColorColor to use for bar label text.Label Options
Label FontFont to use for bar labels.Label Options
Label OffsetSpace to add between the end of the bar and the label. Negative numbers will put the label onto the bar.Label Options
OpacityHow opaque the fill color is, between 0 and 1.Stroke and Fill
Stroke StyleWhat style of stroke or border to use: Hidden, Shape Outline, Border, or Double. To learn more about stroke styles, refer to Stroke and Fill Properties.Stroke and Fill
StrokeDetails for the chosen stroke. Each Stroke has its own properties depending on the Stroke Style chosen.Stroke and Fill
RollNumber of degrees this shape is rotated clockwise.Basic Properties
Scale XAmount to scale the width of this shape. 1 is scale to 100%.Basic Properties
Scale YAmount to scale the height of this shape. 1 is scale to 100%.Basic Properties
URL

The following feature is new in Ignition version 8.1.19
Click here to check out the other new features
A link to attach to this reporting component. Will be a clickable hyperlink if the report is exported as a PDF. You can use the values below to link to internal pages.

ValueDescription
Page:NextNavigates to the next page.
Page:BackNavigates to the previous page.
Page:NumberReplace "Number" with a numeral. Navigates to the specified page.
Basic Properties
VisibleIf true, the shape will be visible.Basic Properties
WidthWidth of this shape in pixels.Basic Properties
HeightHeight of this shape in pixels.Basic Properties
XHorizontal distance in pixels between the left edge of this shape and the left edge of the page.Basic Properties
YVertical distance in pixels between the top edge of this shape and the top edge of the page.Basic Properties


Example
Bar Chart in Action

Bar Chart Sample CSV Data
Fruit, Quantity, AvgWeight
Apples, 150, 183
Bananas, 56, 151
Mango, 190, 300
Oranges, 33, 77

PropertyValue
3D BarsTrue
Render StyleStacked



  • No labels