---
title: "SPC Box and Whisker Chart - Perspective"
id: "spc-box-and-whisker-chart-perspective"
project: "MES User Manual"
url: "https://docs.sepasoft.com/articles/user-manual/spc-box-and-whisker-chart-perspective"
updated: 2026-07-31T14:57:04Z
---

# SPC Box and Whisker Chart \- Perspective

**Sepasoft MES Module Suite**
 A box and whisker plot (sometimes called a boxplot) is a chart that presents information from a five-number summary. This type of chart is used to show the shape of the distribution, its central value, and its variability.

When you need a quick way to see a graphical display of data that shows the median and upper and lower quartiles, along with extreme points and any outliers from my sample measurements. The Box and Whisker chart shows the process location and variation over time.

![](/resources/Storage/user-manual/spc-box-and-whisker-chart-perspective/image2023-6-23_10-3-54.png)

Included in Sepasoft Versions:

| ![Warning](/resources/Storage/user-manual/user-manual/Warning.png) | MES 3.81.7 RC1 and later |
| --- | --- |

![](/resources/Storage/user-manual/spc-box-and-whisker-chart-perspective/image2022-11-8_8-5-47.png)

**Ignition DesignerPerspective Component Palette**
 | ![Warning](/resources/Storage/user-manual/user-manual/Warning.png) | For an example of **Sample Definition Settings**, see [Settings for Box and Whisker Chart Type](/articles/user-manual/Sample-Definition-Settings-for-Box-and-Whisker-Chart-Type). |
| --- | --- |
 ### Component Properties

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.

```python
self.getSibling("Box and Whisker").showLegend = True
```

 ##  SPC Perspective Chart Dataset Properties 

These properties are available in the Ignition Properties Palette for SPC Charts.

![](/resources/Storage/user-manual/perspective-chart-dataset-properties/showAdditionalFactorColors.png)

| **Property Source** | 
```
propertySource
```
 | Sets the datasource mode. Toggle two options: **Use\_stored\_settings** | **Use\_binding**<br> <br>Included in Sepasoft Versions:<br> <br><br>| ![Warning](/resources/Storage/user-manual/user-manual/Warning.png) | MES 3.81.7 RC1 and later |<br>| --- | --- |<br> <br><br> <br>**Use\_stored\_settings:** Sets the chart to receive data from Stored Settings. **To use this, enter property values under storedSettings, see below**.<br> <br><br> <br>**Use\_binding:**Sets the chart to receive data from an SPC Controller. **To use this, bind to an SPC Controller under spcChartSettings, see below.**<br> <br><br><br>When clicking the binding icon on the left side of the propertySource, the Configure Property Binding dialog appears.<br><br>![](/resources/Storage/user-manual/perspective-chart-dataset-properties/perspective-chart-dataset-properties-2024-10-09-1.png) |
| --- | --- | --- |
| **Stored Settings** | storedSettings | Set property values here when **propertySource** is set to **Use\_stored\_settings** |
|  |  | | **Property Name** | **Data Type** | **Property Value Description** |<br>| --- | --- | --- |<br>| 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.<br><br><br>| ![Note](/resources/Storage/user-manual/user-manual/Note.png) | Stored SPC Selector component only offered in VISION.<br><br>See [Stored SPC Selector | Vision](/articles/user-manual/stored-spc-selector-vision) |<br>| --- | --- | |<br>| location | String | **Optional:** Filter on a Location that is defined in Equipment Manager. Enter the Equipment Path to the Location. |<br>| startDate | Date | **Required:** Sets start date to filter SPC data on<br><br><br>| ![Note](/resources/Storage/user-manual/user-manual/Note.png) | Bind to form fields on the view to make dates selectable in runtime.![](/resources/Storage/user-manual/perspective-chart-dataset-properties/perspective-chart-dataset-properties-2024-10-09-2.png) |<br>| --- | --- |<br><br><br>**Required:** Sets end date to filter SPC filter on |<br>| endDate | Date |<br>| 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 <br>   ****  Set property values here when **propertySource** is set to **Use\_Binding**<br><br><br>**Bind to the SPC Controller** |
|  |  | | **Property Name** | **Data Type** | **Information** |<br>| --- | --- | --- |<br>| storedSPCName | String | Incoming property value from the SPC Controller &gt; Stored Setting. |<br>| startDate | Date | Sets start date to start filtering data on |<br>| endDate | Date | Sets end date to filter data on |<br>| autoUpdate | Boolean | Required True/False: True, updates data when a sample is taken. Use for realtime data. |<br>| autoRefresh | Boolean | Required True/False: True, refreshes data when sample or definition information changes. Use for realtime data. |<br><br> <br>![](/resources/Storage/user-manual/perspective-chart-dataset-properties/image%20%285%29.png) |
|  |  | **settings** <br> <br><br><br><br><br>| **additionalFactors**: | String - Additional factors to include in the SPC chart. |<br>| --- | --- |<br>| **attributeName:** | String - Name of the sample attribute |<br>| **attributeUnits**: | String - Adds a label for the unit of measure for the sample |<br>| **boxAndWhiskerFilter**<br><br>Chart Specific | String - Box and whisker filter items to filter on. |<br>| **controlLimits:** | String - Summarizes control limits to add to the chart |<br>| **definitionName:** | String - Name of the sample definition. |<br>| **filters:** | String -<br><br>**location:** The Location Path defined in the Equipment Manager to filter on.<br><br>**factors:** Properties &gt;Additional Factor<br><br>Filter on existing additional factors |<br>| **measurement:** | String - Measure number to filter on |<br>| **nonconformingFilter**<br><br>Chart Specific | String - Nonconforming items to filters on |<br>| **nonconformityFilter**<br><br>Chart Specific | String - Nonconformity items to filters on |<br>| **paretoFilter**<br><br>Chart Specific | String - Items to include in a Pareto chart. |<br>| **rowLimit:** | ****String - The maximum number of samples to return in the results. |<br>| **signals** | String - Summarizes your signal selections in a string. |<br>| **spcDataFormat:** | String - SPC Data<br><br><br>| ![Note](/resources/Storage/user-manual/user-manual/Note.png) | Each chart type has specific settings. Select the correct chart from the dropdown menu. |<br>| --- | --- | |<br>| **useDefaultChartTyp** **e:** | String - If true, uses the default chart type from the attribute definition. |<br>| **useDefaultChartTyp** **e:** | String - If true, uses the default chart type . |<br>| **enableFutureLimitEditing:** | String -If true, you can set limits for future (non-existing) samples. | |
|  |  | **histogram** <br> <br><br><br><br><br>| **autoBarCount**: | Boolean - If true, the number of data bars that are displayed is calculated automatically. |<br>| --- | --- |<br>| **dataBarCount** | int - The number of data bars to display when **autoBarCount** is False. |<br>| **paddingBarCount** | int - The number of bars prior to and following the data bars to include in the histogram results. | |
|  |  | **dynamic**<br><br>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.<br><br><br><br><br>| **factor** | String - Additional factors that were recorded along with the sample. |<br>| --- | --- |<br>| **location** | String - The location path where the samples were collected. |<br>| **productCode** | String - Samples returned should have this Product Code if present. |<br>| **referenceNo** | String - Samples returned should have this Reference Number if present. |<br>| **sampleApprovedBy** | String - The username of the user that approved the samples. |<br>| **sampleTakenBy** | String - The username of the user that recorded the samples. |<br>| **shift** | String - A schedule shift during which the samples were taken. | |
|  |  | **spcResults**<br><br>SPC Results including data, measurement count, messages and calculated value information.<br><br><br><br>**definitionUUI**<br><ul><li><strong>calcValueList</strong><ul><li><strong>defaultChart</strong></li><li><strong>measureFormat</strong></li><li><strong>unit</strong></li></ul></li></ul><br>**measurementCount**<br><ul><li><strong><strong>messages</strong></strong><ul><li><strong>errormessage</strong></li><li><strong>warningMessage</strong></li></ul></li></ul>**spcData: dataset - The SPC data.** |  |
| **showTable** | Boolean | Enable to display the data table. The table is updated as new data comes in. |  |

### Component Properties Specific to Box and Whiskers Chart

| Name | Scripting Reference | Description | Description | Description |  |
| --- | --- | --- | --- | --- | --- |
|  | **enableControlLimitEditing** | Boolean | **Toggle show/hide**<br><br>When enabled, an edit button is displayed.<br><br>Once a control-limit type is selected and Calculate is checked, a limit value is calculated and displayed.<br><br>If the value box is populated and date is selected, you can choose to set the limit value.<br><br>A message displays:<br><ul><li>operation (set or calculate) executed successfully.</li><li>Error message detail&#160;</li></ul> |
|  | **vertical** | Boolean | Sets the orientation of the chart. |
|  | **showLegend** | Boolean | Show or hide the chart's legend. |
|  | **showMean** | Boolean | Show or hide the mean data point. |
|  | **showOutside** | Boolean | Show or hide the outside data points. |
|  | **showFarOut** | Boolean | Show or hide the far out data points. |
|  | **valueAxisTitle** | String | Title to show for the value axis. |
|  | **categoryAxisTitle** | String | Title to show for the category axis. |
|  | **axisStyle** |  |
|  |  | **axisTitleColor** | Color picker | Color for both axis titles. |
|  |  | **axisTitleFont** | String | Font family for both axis titles |
|  | **chartStyle** | Chart styles apply to the plot area of the chart not including the data on the plot area |
|  |  | **chartBackground** | String | Color of the background of the chart. |
|  |  | **horzGridLineColor** | Color, picker available | Color of the horizontal grid line. |
|  |  | **showHorizontalGridLines** | Boolean | If true, show horizontal grid lines on charts. |
|  |  | **vertGridLineColor** | Color, picker available | The color of vertical grid lines. |
|  |  | **showVeriticalGridLines** | Boolean | If true, show vertical grid lines on charts. |
|  | **chartDataStyle** |  |
|  |  | **boxMaxWidthPercentage** | Float | The box maximum width percentage |
|  |  | **dataPointCircleDiameterSize** | Int | The circle diameter size of mean, outside and far out data point. |
|  |  | **filledBox** | Boolean | If true, draws a filled box. |
|  |  | **meanAndMedianColor** | Color, picker available | The color of the mean and the median for the chart. |
|  |  | **seriesColors** | String, List | The colors to paint each box in a series. |
|  | **tickStyle** |  |  |  |  |
|  |  | **tickLabelColor** | Color, picker available | The color of the tick labels. |
|  |  | **tickLabelFont** | String | The font of the tick labels. |
|  | **noDataStyle** |  |  |  |
|  |  | **noDataForeground** | Color, picker available |  |
|  |  | **noDataFont** | String |  |

### Meta Properties in the Perspective Property Editor

| Name<br><br>Scripting Reference | Data Type | Description | Description | Description |
| --- | --- | --- | --- | --- |
| **name** | String | Name of the component. Used in scripting and component tree paths by name, such as during Property Binding. |
| **visible** | Boolean | Whether or not this component should display. |
| **tooltip** |  |  |
| **enable** | Boolean | Whether the tooltip on hover |
| **width** | Integer | The height of the table rows. |
| **text** | String | The scroll bar x position. |
| **style** | Boolean | Toggle to show or hide the sample data table. |
| **delay** | Boolean | Image icon to show to edit control limits. |
| **sustain** | Integer | Time, in milliseconds, to display tooltip before removing it. A value of 0 results in the tooltip displaying until the mouse exits the components. |
| **location** | Boolean | The location where the tooltip displays. |
| **tail** | Boolean | Enables a decorative triangle on the tooltip that points to the tooltip owner. Ignored when location uses a value of 'mouse'. |

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
mouseClicked
This event signifies a mouse click on the source component. A mouse click the combination of a mouse press and a mouse release, both of which must have occurred over the source component. Note that this event fires after the pressed and released events have fired.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .button | The code for the button that caused this event to fire. |
| .clickCount | The number of mouse clicks associated with this event. |
| .x | The x-coordinate (with respect to the source component) of this mouse event. |
| .y | The y-coordinate (with respect to the source component) of this mouse event. |
| .popupTrigger | Returns True (1) if this mouse event is a popup trigger. What constitutes a popup trigger is operating system dependent, which is why this abstraction exists. |
| .altDown | True (1) if the Alt key was held down during this event, false (0) otherwise. |
| .controlDown | True (1) if the Ctrl key was held down during this event, false (0) otherwise. |
| .shiftDown | True (1) if the Shift key was held down during this event, false (0) otherwise. |

mouseEntered
This event fires when the mouse enters the space over the source component.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .button | The code for the button that caused this event to fire. |
| .clickCount | The number of mouse clicks associated with this event. |
| .x | The x-coordinate (with respect to the source component) of this mouse event. |
| .y | The y-coordinate (with respect to the source component) of this mouse event. |
| .popupTrigger | Returns True (1) if this mouse event is a popup trigger. What constitutes a popup trigger is operating system dependent, which is why this abstraction exists. |
| .altDown | True (1) if the Alt key was held down during this event, false (0) otherwise. |
| .controlDown | True (1) if the Ctrl key was held down during this event, false (0) otherwise. |
| .shiftDown | True (1) if the Shift key was held down during this event, false (0) otherwise. |

mouseExited
This event fires when the mouse leaves the space over the source component.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .button | The code for the button that caused this event to fire. |
| .clickCount | The number of mouse clicks associated with this event. |
| .x | The x-coordinate (with respect to the source component) of this mouse event. |
| .y | The y-coordinate (with respect to the source component) of this mouse event. |
| .popupTrigger | Returns True (1) if this mouse event is a popup trigger. What constitutes a popup trigger is operating system dependent, which is why this abstraction exists. |
| .altDown | True (1) if the Alt key was held down during this event, false (0) otherwise. |
| .controlDown | True (1) if the Ctrl key was held down during this event, false (0) otherwise. |
| .shiftDown | True (1) if the Shift key was held down during this event, false (0) otherwise. |

mousePressed
This event fires when a mouse button is pressed down on the source component.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .button | The code for the button that caused this event to fire. |
| .clickCount | The number of mouse clicks associated with this event. |
| .x | The x-coordinate (with respect to the source component) of this mouse event. |
| .y | The y-coordinate (with respect to the source component) of this mouse event. |
| .popupTrigger | Returns True (1) if this mouse event is a popup trigger. What constitutes a popup trigger is operating system dependent, which is why this abstraction exists. |
| .altDown | True (1) if the Alt key was held down during this event, false (0) otherwise. |
| .controlDown | True (1) if the Ctrl key was held down during this event, false (0) otherwise. |
| .shiftDown | True (1) if the Shift key was held down during this event, false (0) otherwise. |

mouseReleased
This event fires when a mouse button is released, if that mouse button's press happened over this component.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .button | The code for the button that caused this event to fire. |
| .clickCount | The number of mouse clicks associated with this event. |
| .x | The x-coordinate (with respect to the source component) of this mouse event. |
| .y | The y-coordinate (with respect to the source component) of this mouse event. |
| .popupTrigger | Returns True (1) if this mouse event is a popup trigger. What constitutes a popup trigger is operating system dependent, which is why this abstraction exists. |
| .altDown | True (1) if the Alt key was held down during this event, false (0) otherwise. |
| .controlDown | True (1) if the Ctrl key was held down during this event, false (0) otherwise. |
| .shiftDown | True (1) if the Shift key was held down during this event, false (0) otherwise. |

mouseMotion
mouseDragged
Fires when the mouse moves over a component after a button has been pushed.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .button | The code for the button that caused this event to fire. |
| .clickCount | The number of mouse clicks associated with this event. |
| .x | The x-coordinate (with respect to the source component) of this mouse event. |
| .y | The y-coordinate (with respect to the source component) of this mouse event. |
| .popupTrigger | Returns True (1) if this mouse event is a popup trigger. What constitutes a popup trigger is operating system dependent, which is why this abstraction exists. |
| .altDown | True (1) if the Alt key was held down during this event, false (0) otherwise. |
| .controlDown | True (1) if the Ctrl key was held down during this event, false (0) otherwise. |
| .shiftDown | True (1) if the Shift key was held down during this event, false (0) otherwise. |

mouseMoved
Fires when the mouse moves over a component, but no buttons are pushed.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .button | The code for the button that caused this event to fire. |
| .clickCount | The number of mouse clicks associated with this event. |
| .x | The x-coordinate (with respect to the source component) of this mouse event. |
| .y | The y-coordinate (with respect to the source component) of this mouse event. |
| .popupTrigger | Returns True (1) if this mouse event is a popup trigger. What constitutes a popup trigger is operating system dependent, which is why this abstraction exists. |
| .altDown | True (1) if the Alt key was held down during this event, false (0) otherwise. |
| .controlDown | True (1) if the Ctrl key was held down during this event, false (0) otherwise. |
| .shiftDown | True (1) if the Shift key was held down during this event, false (0) otherwise. |

propertyChange
propertyChange
Fires whenever a bindable property of the source component changes. This works for standard and custom (dynamic) properties.

| Property | Description |
| --- | --- |
| .source | The component that fired this event. |
| .newValue | The new value that this property changed to. |
| .oldValue | The value that this property was before it changed. Note that not all components include an accurate oldValue in their events. |
| .propertyName | The name of the property that changed. NOTE: Remember to always filter out these events for the property that you are looking for! Components often have many properties that change. |
 ### Component Functions

Example of the component on the page root container:

**event.source.parent.getComponent('Box and Whisker Chart').showSetLimitPanel** **(True)**.

showSetLimitPanel
* Description

Causes the calculate and set control limit dialog to be shown.

* Parameters

Boolean - True/False

* Return

Nothing

* Scope

Client
 
**Sepasoft MES Module Suite**