SPC C-Chart - Perspective

C-Chart in Perspective

A c-chart is an attributes control chart used with data collected in subgroups that are the same size. C-charts show how the process, measured by the number of nonconformities per item or group of items, changes over time.  The c chart is used to monitor the number of defects in a sample while the u chart monitors the average number of defects per sample unit. The c chart is similar to the np chart except that it counts defects as opposed to defectives.

SPC C-Chart includes two UI elements: A table for selection and numeric detail and a primary chart for value plots, control limits and mean.

The scroll lock feature operates in two distinct modes, each with specific UI indicators and behavioral responses to new data.

This feature is available in versions: MES 3.81.11 SP7 and later MES 4.83.0 RC2 and later

Chart Properties

use the name to reference the chart in scripting:

Properties are provided that can be set to affect the operation and look of the component. They can be set through the Property Editor in the Designer or through scripting.

self.getSibling("C-Chart").showTable = False

SPC Perspective Chart Dataset Properties 

These properties are available in the Ignition Properties Palette for SPC Charts.

Property Source	propertySource	Sets the datasource mode. Toggle two options: Use_stored_settings | Use_binding Included in Sepasoft Versions: MES 3.81.7 RC1 and later Use_stored_settings: Sets the chart to receive data from Stored Settings. To use this, enter property values under storedSettings, see below. Use_binding: Sets the chart to receive data from an SPC Controller. To use this, bind to an SPC Controller under spcChartSettings, see below. When clicking the binding icon on the left side of the propertySource, the Configure Property Binding dialog appears.
Stored Settings	storedSettings	Set property values here when propertySource is set to Use_stored_settings
		Property Name Data Type Property Value Description storedSPCName String Required when propertySource = 'Use_stored_settings': Sets name of the Stored SPC Setting. The name must match exactly to the name you enter in Stored SPC Selector. Stored SPC Selector component only offered in VISION. See Stored SPC Selector | Vision location String Optional: Filter on a Location that is defined in Equipment Manager. Enter the Equipment Path to the Location. startDate Date Required: Sets start date to filter SPC data on Bind to form fields on the view to make dates selectable in runtime. Required: Sets end date to filter SPC filter on endDate Date autoRefresh Boolean True/False Required: True, refreshes data when sample or definition information changes. Set to True to use real-time data.
SPC Chart Settings		spcChartSettings Set property values here when propertySource is set to Use_Binding Bind to the SPC Controller
		Property Name Data Type Information storedSPCName String Incoming property value from the SPC Controller > Stored Setting. startDate Date Sets start date to start filtering data on  endDate Date Sets end date to filter data on autoUpdate Boolean Required True/False: True, updates data when a sample is taken. Use for realtime data. autoRefresh Boolean Required True/False: True, refreshes data when sample or definition information changes. Use for realtime data.
		settings additionalFactors:  String - Additional factors to include in the SPC chart. attributeName:  String - Name of the sample attribute attributeUnits:  String - Adds a label for the unit of measure for the sample boxAndWhiskerFilter Chart Specific String - Box and whisker filter items to filter on. controlLimits:  String - Summarizes control limits to add to the chart definitionName:  String - Name of the sample definition. filters:  String -  location: The Location Path defined in the Equipment Manager to filter on. factors: Properties >Additional Factor  Filter on existing additional factors measurement:  String - Measure number to filter on nonconformingFilter Chart Specific String - Nonconforming items to filters on nonconformityFilter Chart Specific  String - Nonconformity items to filters on paretoFilter Chart Specific String -  Items to include in a Pareto chart. rowLimit:   String - The maximum number of samples to return in the results. signals String - Summarizes your signal selections in a string. spcDataFormat:   String -  SPC Data Each chart type has specific settings. Select the correct chart from the dropdown menu. useDefaultChartType:  String - If true, uses the default chart type from the attribute definition. useDefaultChartType:  String - If true, uses the default chart type . enableFutureLimitEditing: String -If true, you can set limits for future (non-existing) samples.
		histogram autoBarCount: Boolean - If true, the number of data bars that are displayed is calculated automatically. dataBarCount int - The number of data bars to display when autoBarCount is False. paddingBarCount int - The number of bars prior to and following the data bars to include in the histogram results.
		dynamic When using an SPC Controller to populate a Perspective SPC Chart, these dynamic filters can be used to filter the data for display in a chart. factor  String - Additional factors that were recorded along with the sample. location String - The location path where the samples were collected. productCode String - Samples returned should have this Product Code if present. referenceNo String - Samples returned should have this Reference Number if present. sampleApprovedBy String - The username of the user that approved the samples. sampleTakenBy String - The username of the user that recorded the samples. shift   String - A schedule shift during which the samples were taken.
		spcResults SPC Results including data, measurement count, messages and calculated value information. definitionUUI calcValueList defaultChart measureFormat unit measurementCount messages errormessage warningMessage spcData: dataset - The SPC data.
showTable	Boolean	Enable to display the data table. The table is updated as new data comes in. Table Chart Scroll Locking The table chart scroll locking feature provides a user-controlled mechanism to either automatically navigate to the most recent data upon its arrival or maintain the current scroll position. The scroll lock feature operates in two distinct modes, each with specific UI indicators and behavioral responses to new data. This feature is available in versions: MES 3.81.11 SP7 and later MES 4.83.0 RC2 and later State Detailed Description Locked UI: The lock icon in the taskbar appears closed and filled. Behavior: The chart view is locked to the right, automatically jumping to the end of the table whenever new data is received. Tooltip: Hovering over the icon displays the text: "Allow Free Scrolling". Free Scrolling UI: The lock icon in the taskbar appears open and unfilled. Behavior: The chart maintains its current scroll position, even when new data is received. Tooltip: Hovering over the icon displays the text: "Lock Scrolling".

Properties Common to SPC Charts with Measurable Values

These properties are available in the Ignition Properties Palette for SPC Charts that have values that are measurable with datatypes such as floats and integers.

Name Scripting Reference	Data Type	Description
columnWidth	Integer - The width of the table columns.
dateFormat	The date formatting pattern used to display the date MM/dd/yyyy dd-M-yyyy hh:mm:ss dd MMMM yyyy
rowHeight	The height of the table rows.
scrollX	The scroll bar x position.
showTable	Boolean - Toggle to show or hide the sample data table. When showTable is set to True: Table Chart Scroll Locking The table chart scroll locking feature provides a user-controlled mechanism to either automatically navigate to the most recent data upon its arrival or maintain the current scroll position. The scroll lock feature operates in two distinct modes, each with specific UI indicators and behavioral responses to new data. This feature is available in versions: MES 3.81.11 SP7 and later MES 4.83.0 RC2 and later State Detailed Description Locked UI: The lock icon in the taskbar appears closed and filled. Behavior: The chart view is locked to the right, automatically jumping to the end of the table whenever new data is received. Tooltip: Hovering over the icon displays the text: "Allow Free Scrolling". Free Scrolling UI: The lock icon in the taskbar appears open and unfilled. Behavior: The chart maintains its current scroll position, even when new data is received. Tooltip: Hovering over the icon displays the text: "Lock Scrolling".
editControlLimitImagePath	Boolean - Image icon to show to edit control limits.
enableControlLimitEditing	Toggle show/hide When enabled, an edit button is displayed.  Once a control-limit type is selected and Calculate is checked, a limit value is calculated and displayed.  If the value box is populated and date is selected, you can choose to set the limit value.  A message displays: operation (set or calculate) executed successfully. Error message detail
enableNoteEditing	Boolean - If true, you can add and edit notes on the chart.
enableNoteDeletion	Boolean -If true, you can delete notes on the chart.
enablePointDeletion	Boolean -If true, you can hide/restore data points on the chart.
enableSampleDeletion	Boolean -If true, you can exclude samples on the chart.
limitDialogOffsetX	Integer - The horizontal offset to display the control limit dialog box. Works in conjunction with enableControlLimitEditing
limitDialogOffsetY	Integer -The vertical offset to display the control limit dialog box. Works in conjunction with enableControlLimitEditing
markerImagePath	String - The relative path of an image to display for markers.
noteImagePath	String -The relative path of an image to display for notes when showNotes is enabled.
primaryChartAxisTitle	String -Title to show for the primary axis. The color attribution is based on the sequence in which the additional factors are added to the SELECT statement in the FilterBy clause.
showAdditionalFactorColors	Boolean - Defaults to True. In 3.81.11 SP1 and later The color attribution of the points on a chart is based on the sequence in which you add additional factors to the FilterBy clause of the Select statement. When a point on a chart is outside a Control Limit the circled is filled-in as a solid circle. When inside the limits, the circle is an outline.
showAttributeNameAsTitle	Boolean - Defaults to False. In 3.81.10 SP8 and later. When true the first attribute on the chart is used as the chart title. If there is more than one attribute displayed on the chart, then the first attribute name is used. If the attribute displayed on the chart is changed, then the title changes to match the attribute. Supersede the Chart Title.
showNotes	Boolean -If true, notes display on the chart.
showPrimaryAverage	Boolean -Set to true to display the average line on the primary chart.
yAxisMax	String and Integer -Plots all the values up to and including the maximum value.
yAxisMin	String and Integer -Plots all the values down to and including the minimum value.
axisStyle
	rightAxisWidth	Integer	Width of the right chart axis
chartStyle
	horzGridLineColor	Boolean	If true, show horizontal grid lines on charts.
	primaryChartBackground	Color, picker available	The background color of the primary chart.
	showHorizontalGridLines	Boolean	f true, show horizontal grid lines on charts.
	vertGridLineColor	Color, picker available	The color of vertical grid lines.
chartDataStyle
	calcBackground	Color	Sets the background color.
	calcFont	Font family	Sets the font family
	calcForeground	Color, picker available	Sets the foreground color
	dataBackground	Color	Sets the background color.
	dataFont	Font family	Sets the font family
	dataForeground	Font family	Sets the foreground color
	dateBackground	Color	Sets the background color.
	dateFont	Font family	Sets the background color.
	dateForeground	Color, picker available	Sets the foreground color
	visibleMeasurements	int	The number of measurements to show in the table.
chartMarkerStyle
	markerLabelFont	Font family	The font family to use for markers.

Meta Properties in the Perspective Property Editor

Event Handlers

Event handlers provide the ability to add custom script when a user interacts with a component such as by clicking a mouse, selecting a menu item or when a component property changes.

mouse

mouseMotion

propertyChange

Extension Functions

getNoteToolTip

getSampleToolTip

beforeSampleDelete