Page widget: Chart#

Grist supports several chart types to help you visualize your data easily. Charts may be used to plot a regular table of data, a linked widget (as described in Linking widgets), or a summary table (as described in Summary tables).

The most common chart types are illustrated here:

widget_chart_examples

Chart types#

Each chart type plots one or several data series. Select the series to plot by clicking the green ‘Add Series’ text in the creator panel. In the area above the “Series” section of the creator panel, you may configure the x-axis for most charts, or the labels for pie and donut charts.

Bar Chart#

Needs an x-axis and at least one series to plot along the y-axis. Additional series create additional bars at each point on the x-axis. To stack series onto the same bar, select the “Stack series” checkbox.

widget_chart_bar

Line Chart#

Needs an x-axis and at least one series to plot along the y-axis. Additional series specify Y values for additional lines.

widget_chart_line

Pie Chart#

Needs pie slice labels and one series for the pie slice sizes.

widget_chart_pie

Area Chart#

Similar to a line chart, needs an x-axis and at least one series to plot along the y-axis. Additional series specify Y values for additional lines.

widget_chart_area

Scatter Plot#

Needs a label and two or more series. The label applies to the points. The series apply the X and Y values for each point, respectively. Additional series specify Y values for additional sets of points.

widget_chart_scatter

Kaplan-Meier Plot#

The Kaplan-Meier Plot is useful for certain studies, and needs one label and one series. The label applies to the lines being plotted. The series gives a survival time or time-to-failure of that point. The plot shows the survival times on the X axis, and the number of points that survive at that time on the Y axis.

widget_chart_km

Chart options#

A number of chart options are available, some of them specific to certain chart types.

Split Series: When checked, an extra series is to be selected under the ‘Split Series’ dropdown. The series should contain a group label for each data point. All points with the same group value are plotted as a separate line.

For example:

widget_chart_grouped

Invert Y-axis: When checked the Y axis is flipped, with smaller values above and larger values below.

Connect gaps [for Line Charts only]: When checked, gaps caused by missing values are connected by connecting neighboring points. The “Show Markers” option described next can be used to keep a visual cue for which points are present.

Show markers [for Line Charts only]: When checked, each point on the line is marked additionally by a small circle. See the example for Split Series above.

Stack series [for Line and Bar Charts]: When checked, split series will be stacked, rather than shown separately, giving a total for your selected series. In this example, we can see the total revenue for each month across all three departments. Note that ‘Split series’ must be checked in order to select multiple series to stack.

widget_chart_stack_series

Error bars [for Line and Bar Charts]: When set to “Symmetric”, each Y series should be followed by a series for the length of the error bars to show. When set to “Above+Below”, each Y series should be followed by two series, one for the top error bars, and one for the bottom.

widget_chart_error_bars

In the example here, “Split Series” is checked. So the series selected from the Split Series dropdown (“Cell Line”), specifies how to group the data into lines. The series selected under the X-Axis dropdown (“Log[Drug], uM”), specifies our values along the x-axis. Our first series in the Series list (“% Viable Cells”), specifies our y-axis values, and the series that follows that (“SD”), specifies the error bars for those Y values.