Python command: Linechart and Barchart

The Linechart and Barchart commands in Python allow you to draw a simple line chart or bar chart in a custom dashboard or in a Python script in PC Collect.

See Python commands for other commands you can use with GainSeeker.

 

Contents  [Hide]

 

Shared Line and Bar Chart Commands

Note: While the root command linechart is used in this table, the barchart chart command also shares these properties and methods.

Syntax

Example

Description/Remarks

linechart.addtopane(index=0, row=0, column=0, height=1, width=1)

linechart.addtopane()

linechart.addtopane(0, row=1, column=2, height=2, width=1)

Adds the chart form created by the disp (Display) command at the specified pane index.

Row, column, height, and width arguments correspond with the properties for other form controls of the same name. See Form Basics.

linechart.addydata(data, label)

linechart.addydata([3, 4, 5], "Production")

Adds a group of y data to the chart, specified by the data argument. The label argument sets the label for the group of data. For a missing data value, specify None.

linechart.chartskin

linechart.chartskin = "Data Head"

Gets or sets the SPC chart skin for the chart. DMS chart skins are not available with this command.

Chart skin names are case sensitive.

linechart.clear()

linechart.clear()

Clears all chart data from the chart command object.

linechart.manualscaleyaxis

linechart.manualscaleyaxis = True

If set to True, the yscalelow and yscalehigh properties are used to scale the y-axis of the chart.

linechart.setxdata(data, isnumeric)

linechart.setxdata(["Jan", "Feb", "March"], False)

Sets the x data for the chart. Labels may also be used if isnumeric is False, in which case the data is displayed sequentially.

linechart.title

linechart.title = "My Chart"

Gets or sets the chart's primary title.

linechart.xaxistitle

linechart.xaxistitle = "Month"

Gets or sets the x-axis title.

linechart.yaxistitle

linechart.yaxistitle = "Count"

Gets or sets the y-axis title.

linechart.yscalehigh

linechart.yscalehigh = 10

Gets or sets the maximum y value displayed if manualscaleyaxis is True.

linechart.yscalelow

linechart.yscalelow = 0

Gets or sets the minimum y value displayed if manualscaleyaxis is True.

Line chart example

This is an excerpt from a sample script that would draw a line chart similar to that shown below:

 

#set linechart properties and data

linechart.title = "Down Time"

linechart.addydata([88, 84, 83, 68], "Line 1")

linechart.addydata([86, 75, 61, 48], "Line 2")

linechart.addydata([92, 86, 81, 77], "Line 3")

linechart.setxdata(["Jan", "Feb", "Mar", "Apr"], False)

linechart.xaxistitle = "Month"

linechart.yaxistitle = "Hours"

 

#add chart to the current disp pane

linechart.addtopane()

 

#display chart

disp.show()